Перейти к содержимому

Документация

Zabbix

Zabbix — система мониторинга инфраструктуры с поддержкой webhook-уведомлений через механизм медиатипов.

Предварительные требования

  • Zabbix версии 5.0 или выше.
  • API-токен команды из раздела Токены.

Эндпоинт

POST https://sereno.systems/api/v1/alerts/create?source=zabbix

Настройка медиатипа

  1. Откройте Администрирование → Медиатипы и нажмите Создать медиатип.
  2. Выберите тип Webhook.
  3. Задайте произвольное название, например Sereno OnCall.
  4. В поле URL укажите: https://sereno.systems/api/v1/alerts/create?source=zabbix
  5. Задайте метод POST и тип тела JSON.
  6. В разделе Параметры добавьте заголовок:
    ИмяЗначение
    AuthorizationBearer {TOKEN}
  7. В поле Тело запроса укажите JSON с данными алерта:
{
  "event_id": "{EVENT.ID}",
  "event_name": "{EVENT.NAME}",
  "event_status": "{EVENT.STATUS}",
  "event_time": "{EVENT.TIME.ISO8601}",
  "severity": "{EVENT.SEVERITY}",
  "message": "{ALERT.MESSAGE}",
  "host": {
    "name": "{HOST.NAME}",
    "ip": "{HOST.IP}"
  },
  "trigger": {
    "id": "{TRIGGER.ID}",
    "name": "{TRIGGER.NAME}",
    "expression": "{TRIGGER.EXPRESSION}",
    "host": "{HOST.NAME}"
  },
  "item": {
    "name": "{ITEM.NAME}",
    "value": "{ITEM.LASTVALUE}"
  },
  "tags": {"{TRIGGER.TAGS}": ""}
}
  1. Нажмите Добавить для сохранения медиатипа.

Настройка пользователя и действия

  1. Перейдите в Администрирование → Пользователи и откройте пользователя, от имени которого будут отправляться уведомления.
  2. На вкладке Медиа добавьте новую запись: выберите медиатип Sereno OnCall, в поле Отправить на укажите любое значение (используется как метка).
  3. Перейдите в Настройки → Действия → Действия триггеров и создайте или обновите действие.
  4. В разделе Операции добавьте операцию: тип Отправить сообщение, получатель — пользователь из шага 1, медиатип — Sereno OnCall.

Убедитесь, что пользователь имеет права на просмотр хостов, по которым должны отправляться алерты.

Документация Zabbix