diff --git a/README.md b/README.md index 1c941a2..3d76208 100644 --- a/README.md +++ b/README.md @@ -101,48 +101,56 @@ Zabbix агент по запросу сервера запускает скри ### 1. Требования - **Python 3.9+** +- **Git** — для клонирования репозитория - **Zabbix Agent** с утилитой `zabbix_sender` - Доступ к SES API (`http://:6190`) - Доступ к Zabbix Server по порту 10051 +- SSH-ключ, добавленный в Git-репозиторий (`git.totmin.ru`) ### 2. Установка пакета ```bash -# Копируем проект на сервер -rsync -avz --exclude='.git' --exclude='__pycache__' ./ root@:/opt/ses-monitor/ +# Клонируем репозиторий на сервер +git clone git@git.totmin.ru:en2zmax/ses-monitor.git /opt/ses-monitor -# На сервере: +# Переходим в каталог проекта cd /opt/ses-monitor -# Создаём виртуальное окружение и устанавливаем зависимости +# Создаём виртуальное окружение и устанавливаем пакет python3 -m venv .venv source .venv/bin/activate pip install -e . -# Устанавливаем zabbix_sender (если ещё не установлен) -apt update && apt install -y zabbix-sender - # Создаём каталог для логов mkdir -p /var/log/ses-monitor ``` ### 3. Настройка конфигурации -Отредактируйте `config/config.yaml`: +Скопируйте шаблон и отредактируйте: + +```bash +cp config/config.yaml.example config/config.yaml +nano config/config.yaml +``` + +Основные поля: ```yaml ses: base_url: "http://10.101.60.31:6190" # URL вашего SES API - robot_id: "" # ID робота из GET /ses/robot/list + robot_id: "" # ID робота из GET /ses/robot/listall channel: "monitoring" # Имя канала в архиве request_timeout: 30 zabbix: enabled: true - server: "127.0.0.1" # IP вашего Zabbix сервера + mode: "userparameter" # или "sender" host: "my-server-name" # Имя хоста в Zabbix + server: "127.0.0.1" # IP Zabbix сервера (только sender) port: 10051 sender_path: "/usr/bin/zabbix_sender" + metrics_file: "/var/tmp/ses_monitor/metrics.json" # (только userparameter) ``` ### 4. Создание сценария @@ -153,8 +161,6 @@ zabbix: cp config/scenarios/example_liveness.yaml config/scenarios/my_project.yaml ``` -Формат сценария описан ниже. - ### 5. Запуск ```bash @@ -174,7 +180,7 @@ journalctl -u ses-monitor -f ### 6. Импорт шаблона Zabbix 1. Zabbix Frontend → **Configuration → Templates → Import** -2. Выбрать файл `zabbix/zbx_ses_template.xml` +2. Выбрать файл `zabbix/zbx_ses_template_5.0.xml` (для sender) или `zabbix/zbx_ses_template_5.0_up.xml` (для UserParameter) 3. Нажать Import 4. Привязать шаблон "SES Monitor" к нужному хосту