VMmanager
Документация
/
VMmanager
/
Мониторинг
/
Zabbix
/
Zabbix
Добавить в избранное
Режим фокусировки
Документация
/
VMmanager
/
Мониторинг
/
Zabbix
/
Zabbix

Zabbix

Это документация VMmanager 6 для редакций Hosting и Infrastructure. Документация VMmanager для редакции ФСТЭК находится в разделе VMmanager 6 ФСТЭК.

Zabbix — это система мониторинга с открытым исходным кодом. С помощью Zabbix вы можете настроить мониторинг виртуальных машин (ВМ) и других сущностей платформы.

Основные компоненты Zabbix:

  • сервер — компонент, который управляет сетевыми сервисами, хранит данные мониторинга, оповещает администраторов о проблемах с оборудованием. Вы можете использовать собственный сервер Zabbix или создать ВМ для выполнения этих функций;
  • прокси — промежуточный сервис, который собирает данные с ВМ и передаёт на сервер. Необязательный компонент системы. Используйте прокси, чтобы сократить нагрузку на сервер или если ВМ не имеют прямого доступа к серверу. Вы можете создать одну или несколько ВМ, выполняющих роль прокси;
  • агент — программное обеспечение, которое устанавливается на ВМ или узел кластера. Агент собирает данные мониторинга и передаёт на сервер или прокси.

Подробнее о Zabbix см. в официальной документации.

Установка компонентов Zabbix

Вы можете установить Zabbix на ВМ с помощью скриптов из репозитория ISPsystem. Скрипты могут быть запущены как при создании ВМ, так и после создания. Подробнее см. в статье Запуск скриптов на ВМ.

Доступные версии для установки: 

  • Zabbix 6.0;
  • Zabbix 7.0.

Для установки агента Zabbix на узел кластера потребуется создать Ansible-сценарий установки. Подробнее см. в статье Создание скрипта для узла.

Сервер

Системные требования к серверу Zabbix зависят от количества устройств, для которых нужно проводить мониторинг. Подробную информацию о системных требованиях см. в официальной документации Zabbix.

Рекомендуемые гостевые ОС:

  • Zabbix 6.0 — AlmaLinux 8, Ubuntu 22.04, Debian 12;
  • Zabbix 7.0 — AlmaLinux 10, Ubuntu 26.04, Debian 13.

Полный список поддерживаемых ОС см. на странице загрузок Zabbix.

Чтобы установить на ВМ сервер Zabbix, запустите на ней скрипт Zabbix server. В параметрах скрипта выберите нужную версию.

Веб-интерфейс сервера будет доступен по URL http://<IP_созданной_ВМ>:8080. Например, http://192.168.100.100:8080. Для первой авторизации используйте имя пользователя Admin и пароль zabbix. В дальнейшем рекомендуем изменить пароль.

Прокси

Рекомендуемые гостевые ОС:

  • Zabbix 6.0 — AlmaLinux 8, Ubuntu 22.04, Debian 12;
  • Zabbix 7.0 — AlmaLinux 10, Ubuntu 26.04, Debian 13.

Полный список поддерживаемых ОС см. на странице загрузок Zabbix.

Чтобы установить на ВМ прокси Zabbix, запустите на ней скрипт Zabbix proxy. В параметрах скрипта выберите нужную версию и укажите IP-адрес сервера Zabbix.

Агент

Чтобы установить на ВМ агенты Zabbix:

  1. Запустите на ВМ:
    • с ОС семейства Linux — скрипт Zabbix agent2 linux;
    • с ОС Windows — скрипт Zabbix agent2 windows.
  2. Выберите нужную версию.
  3. Укажите IP-адрес сервера Zabbix или, если вы используете прокси, IP-адрес прокси Zabbix.

Чтобы установить агенты Zabbix на узлах кластера:

  1. Перейдите в Скрипты → Для узлов → Создать скрипт.

  2. Создайте Ansible-сценарий и укажите в нём IP-адрес сервера Zabbix вместо фрагмента <zabbix_server> в секциях Change Server IP и Change Active Server IP:

    Содержимое скрипта
  3. Запустите скрипт на узлах кластера.

Настройка сервера Zabbix 6.0

Добавление конфигурации прокси

  1. Перейдите в Administration → Proxies → Create proxy.
  2. Укажите настройки прокси:
    1. Proxy name — произвольное имя прокси.
    2. Proxy mode — режим работы прокси. Выберите Passive.
    3. IP address — IP-адрес прокси.
    4. DNS name — имя DNS-сервера. Оставьте значение по умолчанию — localhost.
    5. Connect to — тип подключения. Выберите IP.
    6. Port — порт подключения. Оставьте значение по умолчанию — 10051.
    7. Description — произвольный комментарий к прокси.
  3. Нажмите Add.

Добавление мониторинга платформы

Создание токена авторизации

  1. Создайте токен для авторизации в платформе:

    curl -k -X POST -H "accept: application/json" -H "Content-Type: application/json" 'https://example.com/api/auth/v4/public/token' -d '{"email": "admin_email", "password": "admin_pass"}'

    Пояснения к команде:

    • example.com — доменное имя или IP-адрес сервера с платформой;
    • admin_email — email администратора платформы;
    • admin_pass — пароль администратора платформы.

    В ответ придёт сообщение вида:

    Пример ответа в JSON
    {
  "confirmed": true,
  "expires_at": null,
  "id": "6",
  "token": "4-e9726dd9-61d9-2940-add3-914851d2cb8a"
}

    Сохраните полученное значение параметра token — токен авторизации.

  2. Создайте токен с увеличенным сроком действия:

    curl -k -X POST -d '{"description": "Integration with Zabbix", "expires_at": "<expire_date_and_time>"}' -H  "accept: application/json" -H "Content-Type: application/json" -H "x-xsrf-token: <token>" "https://example.com/auth/v4/token"
    Пояснения к команде:
    • <expire_date_and_time> — время окончания действия в формате YYYY-MM-DD HH:MM:SS. Например, 2025-01-01 00:00:00;
    • <token> — токен авторизации;
    • example.com — доменное имя или IP-адрес сервера с платформой

  3. В ответ придёт сообщение вида: 

    Пример ответа в JSON
    {
  "confirmed": true,
  "expires_at":"2025-01-01 00:00:00",
  "id": "7346",
  "token": "14626-897fd91a-5787-4874-8b26"
}

    Сохраните полученное значение параметра token — токен авторизации с увеличенным сроком действия.

Настройка мониторинга в Zabbix

  1. Скачайте шаблоны из репозитория Zabbix:

    1. template_vmmanager_6_master.yaml — для мониторинга платформы.
    2. template_vmmanager_6_kvm_hypervisor.yaml — для мониторинга узлов кластера.
  2. Импортируйте загруженные шаблоны в Zabbix: Configuration → Templates → Import → выберите файл шаблона → Import → Import. Сначала импортируйте шаблон для мониторинга узлов кластера, а затем — для мониторинга платформы.
  3. Включите мониторинг сервера с VMmanager в Zabbix:
    1. Перейдите в Configuration → Hosts → Create host.
    2. Укажите параметры сервера:
      1. Host name — произвольное имя для обозначения сервера в базе данных Zabbix.
      2. Visible name — произвольное имя для отображения сервера в интерфейсе Zabbix.
      3. Groups — группа объектов. Выберите VMmanager 6.
      4. Interfaces — сетевые интерфейсы. Нажмите Add → Agent.
      5. IP address — IP-адрес сервера c платформой.
      6. DNS name — имя DNS-сервера. Оставьте пустое значение по умолчанию.
      7. Connect to — тип подключения. Выберите IP.
      8. Port — порт подключения. Оставьте значение по умолчанию — 10050.
      9. Description — произвольный комментарий.
      10. Monitored by proxy — используемый прокси. Выберите имя прокси, если вы его используете.
      11. Enabled — включите опцию, чтобы активировать мониторинг платформы.
    3. Перейдите на вкладку Templates и введите в поле Link new templates: Template VMmanager 6 Master.
    4. Перейдите на вкладку Macros и добавьте макросы:
      1. {$VM6_TOKEN} — токен авторизации с увеличенным сроком действия.
      2. {$VM6_URL} — URL сервера с платформой в формате https://vm6.example.com/vm/v3, где vm6.example.com — доменное имя или IP-адрес сервера с платформой.

    5. Нажмите Add.
  4. Включите мониторинг узлов кластера в Zabbix:
    1. Перейдите в Configuration → Hosts → выберите сервер с платформой → Discovery.

    2. В разделе Discovery Rules в строке Template VMmanager 6 Master: Host discovery нажмите Host prototypes.

    3. В разделе Host Prototypes включите для сервера опции Create enabled и Discover.
    4. Перейдите в Monitoring → Hosts → выберите сервер с платформой → Inventory.

    5. В разделе Host Inventory нажмите Discovery.

    6. Выделите строку VMmanager 6 Master: Host discovery → Execute now.

Zabbix подключится к VMmanager и получит список узлов кластера для мониторинга. Чтобы новые узлы кластера автоматически добавлялись в настройки Zabbix, установите на узлы агент Zabbix.

Добавление отдельных ВМ для мониторинга

  1. Перейдите в Configuration → Hosts → Create host.
  2. Добавьте настройки ВМ:
    1. Host name — произвольное имя для обозначения ВМ в базе данных Zabbix.
    2. Visible name — произвольное имя для отображения ВМ в интерфейсе Zabbix.
    3. Groups — группа объектов. Выберите Virtual machines.
    4. Interfaces — сетевые интерфейсы. Нажмите Add → Agent.
    5. IP address — IP-адрес ВМ.
    6. DNS name — имя DNS-сервера. Оставьте пустое значение по умолчанию.
    7. Connect to — тип подключения. Выберите IP.
    8. Port — порт подключения. Оставьте значение по умолчанию — 10050.
    9. Description — произвольный комментарий к ВМ.
    10. Monitored by proxy — используемый прокси. Выберите имя прокси, если вы его используете.
    11. Enabled — включите опцию, чтобы активировать мониторинг этой ВМ.
  3. Перейдите на вкладку Templates и выберите в поле Link new templates шаблон для мониторинга ВМ:
    • с ОС семейства Linux — Template OS Linux by Zabbix agent;
    • с ОС Windows — Template OS Windows by Zabbix agent.
  4. Нажмите Add.

Настройка сервера Zabbix 7.0

Добавление конфигурации прокси

  1. Перейдите в Administration → Proxies → Create proxy.
  2. Укажите настройки прокси:
    1. Proxy name — произвольное имя прокси.
    2. Proxy group — группа прокси. Необязательный параметр.
    3. Proxy mode — режим работы прокси. Выберите Passive.
    4. IP address — IP-адрес прокси.
    5. Port — порт подключения. Оставьте значение по умолчанию — 10051.
    6. Description — произвольный комментарий к прокси.
  3. Нажмите Add.

При успешном добавлении появится сообщение Proxy added и прокси будет отображаться в общем списке раздела.

Добавление мониторинга платформы

Создание токена авторизации

  1. Создайте токен для авторизации в платформе:

    curl -k -X POST -H "accept: application/json" -H "Content-Type: application/json" 'https://example.com/api/auth/v4/public/token' -d '{"email": "admin_email", "password": "admin_pass"}'

    Пояснения к команде:

    • example.com — доменное имя или IP-адрес сервера с платформой;
    • admin_email — email администратора платформы;
    • admin_pass — пароль администратора платформы.

    В ответ придёт сообщение вида:

    Пример ответа в JSON
    {
  "confirmed": true,
  "expires_at": null,
  "id": "6",
  "token": "4-e9726dd9-61d9-2940-add3-914851d2cb8a"
}

    Сохраните полученное значение параметра token — токен авторизации.

  2. Создайте токен с увеличенным сроком действия:

    curl -k -X POST -d '{"description": "Integration with Zabbix", "expires_at": "<expire_date_and_time>"}' -H  "accept: application/json" -H "Content-Type: application/json" -H "x-xsrf-token: <token>" "https://example.com/auth/v4/token"
    Пояснения к команде:
    • <expire_date_and_time> — время окончания действия в формате YYYY-MM-DD HH:MM:SS. Например, 2025-01-01 00:00:00;
    • <token> — токен авторизации;
    • example.com — доменное имя или IP-адрес сервера с платформой

  3. В ответ придёт сообщение вида: 

    Пример ответа в JSON
    {
  "confirmed": true,
  "expires_at":"2025-01-01 00:00:00",
  "id": "7346",
  "token": "14626-897fd91a-5787-4874-8b26"
}

    Сохраните полученное значение параметра token — токен авторизации с увеличенным сроком действия.

Настройка мониторинга в Zabbix

  1. Скачайте шаблоны из репозитория Zabbix:

    1. template_vmmanager_6_kvm_hypervisor.yaml — для мониторинга узлов кластера.
    2. template_vmmanager_6_master.yaml — для мониторинга платформы.
  2. Импортируйте загруженные шаблоны в Zabbix: Data collection → Templates → Import → выберите файл шаблона → Import → Import. Сначала импортируйте шаблон для мониторинга узлов кластера, а затем — для мониторинга платформы. Если шаблоны добавлены успешно, появится сообщение Imported successfully и шаблоны отобразятся в общем списке раздела. 
  3. Включите мониторинг сервера с VMmanager в Zabbix:
    1. Перейдите в Data collection → Hosts → Create host.

    2. Укажите параметры сервера:
      1. Host name — произвольное имя для обозначения сервера в базе данных Zabbix.
      2. Visible name — произвольное имя для отображения сервера в интерфейсе Zabbix. Необязательный параметр.
      3. Templates — шаблон для мониторинга. Выберите Template VMmanager 6 Master.
      4. Host groups — группа объектов. Введите VMmanager 6.
      5. Interfaces — сетевые интерфейсы. Нажмите Add → Agent.
      6. IP address — IP-адрес сервера c платформой.
      7. DNS name — имя DNS-сервера. Оставьте пустое значение по умолчанию.
      8. Connect to — тип подключения. Выберите IP.
      9. Port — порт подключения. Оставьте значение по умолчанию — 10050.
      10. Description — произвольный комментарий.
      11. Monitored by — если вы используете прокси, выберите вариант Proxy и нужный сервер из списка.
      12. Enabled — включите опцию, чтобы активировать мониторинг платформы.
    3. Перейдите на вкладку Macros и добавьте макросы:
      1. {$VM6_TOKEN} — токен авторизации с увеличенным сроком действия.
      2. {$VM6_URL} — URL сервера с платформой в формате https://vm6.example.com/vm/v3, где vm6.example.com — доменное имя или IP-адрес сервера с платформой.
    4. Нажмите Add. Если сервер добавлен успешно, появится сообщение Host added и сервер отобразится в общем списке раздела.
  4. Включите мониторинг узлов кластера в Zabbix:
    1. Перейдите в Data collection → Hosts → в строке с сервером платформы нажмите Discovery.

    2. В разделе Discovery Rules в строке Template VMmanager 6 Master: Host discovery нажмите Host prototypes.

    3. В разделе Host Prototypes нажмите на No в столбцах Create enabled и Discover. Если опции подключились успешно, их значение будет изменено на Yes и появится сообщение Host prototype updated.
    4. Перейдите в Monitoring → Hosts → выберите сервер с платформой → Inventory.

    5. В разделе Host Inventory нажмите Discovery.

    6. Выделите строку VMmanager 6 Master: Host discovery → Execute now.

Zabbix подключится к VMmanager и получит список узлов кластера для мониторинга. Чтобы новые узлы кластера автоматически добавлялись в настройки Zabbix, установите на узлы агент Zabbix.

Добавление отдельных ВМ для мониторинга

  1. Перейдите в Data collection → Hosts → Create host.
  2. Добавьте настройки ВМ:
    1. Host name — произвольное имя для обозначения ВМ в базе данных Zabbix.
    2. Visible name — произвольное имя для отображения ВМ в интерфейсе Zabbix. Необязательный параметр.
    3. Templates — шаблон для мониторинга:
      1. Нажмите Select.
      2. В поле Template group выберите Templates/Operating systems:
      3. Выберите шаблон: 
        • для ОС семейства Linux — Linux by Zabbix agent;
        • для ОС Windows — Windows by Zabbix agent.
    4. Host groups — группа объектов. Выберите Virtual machines.
    5. Interfaces — сетевые интерфейсы. Нажмите Add → Agent.
    6. IP address — IP-адрес ВМ.
    7. DNS name — имя DNS-сервера. Оставьте пустое значение по умолчанию.
    8. Connect to — тип подключения. Выберите IP.
    9. Port — порт подключения. Оставьте значение по умолчанию — 10050.
    10. Description — произвольный комментарий к ВМ.
    11. Monitored by — если вы используете прокси, выберите вариант Proxy и нужный сервер из списка.
    12. Enabled — включите опцию, чтобы активировать мониторинг этой ВМ.
  3. Нажмите Add. Если ВМ добавлена успешно, появится сообщение Host added и ВМ отобразится в общем списке раздела.