Водич кроз подешавање

Кад год је Checkmk интеграција укључена, Zammad ослушкује захтеве на свом API-ју и путем имејла. Све док те поруке прате очекивани формат, Zammad ће отварати нове тикете (или пронаћи и освежити постојеће) на основу садржаја поруке.

То значи да је „подешавање Checkmk интеграције“ једноставно питање додавања конфигурације вашој Checkmk инстанци: да јој кажете када да пошаље ове поруке и шта у њима да каже. Да бисте то урадили, мораћете да дефинишете нови notification rule (погледајте Checkmk званичну документацију за додатну помоћ).

Као део овог новог правила, мораћете да изаберете notification method (тј. скрипту која ће се извршити кад год се правило покрене). Ову скрипту ћете доставити ви (примери су испод) и она ће садржати логику за слање API/имејл порука Zammad-у:

Checkmk дијалог за „New Rule“

Пронађите своје прилагођене скрипте у Checkmk WATO под Notifications > New Rule > Notification Method.

Када завршите са подешавањем новог правила, све је спремно! Нови тикети би требало да почну да стижу и аутоматски се освежавају сваки пут када се ваше правило окине.

(Ако вам је потребна помоћ у решавању проблема, обавезно проверите Недавни уноси евиденције.)

API упозорења

Да бисте додали ове скрипте у Checkmk WATO, копирајте их у свој Checkmk инсталациони директоријум и учините их извршним. (Обавезно замените zammad.example.com URL адресу повратног позива оном која се налази у вашем администраторском панелу.)

Сервисна упозорења

За свежавање статуса софтвера који ради на вашем серверу (нпр. postgres).

#!/bin/bash
# /opt/omd/sites/<SITE>/local/share/check_mk/notifications/zammad-service

curl -X POST \
  -F "event_id=$NOTIFY_SERVICEPROBLEMID" \
  -F "host=$NOTIFY_HOSTNAME" \
  -F "service=$NOTIFY_SERVICEDESC" \
  -F "state=$NOTIFY_SERVICESTATE" \
  -F "text=$NOTIFY_SERVICEOUTPUT" \
  https://zammad.example.com/api/v1/... # see Admin Panel > System > Integrations > Checkmk > Usage
Упозорења о серверу

За освежавање статуса самог сервера.

#!/bin/bash
# /opt/omd/sites/<SITE>/local/share/check_mk/notifications/zammad-host

curl -X POST \
  -F "event_id=$NOTIFY_HOSTPROBLEMID" \
  -F "host=$NOTIFY_HOSTNAME" \
  -F "state=$NOTIFY_HOSTSTATE" \
  -F "text=$NOTIFY_HOSTOUTPUT" \
  https://zammad.example.com/api/v1/... # see Admin Panel > System > Integrations > Checkmk > Usage

Белешка

🤔 Чему служе све ове променљиве окружења?

Кад год Checkmk покрене ове скрипте, мора да пружи неке информације о догађају који је окинуо упозорење. Ове информације се прослеђују у облику ових $NOTIFY_* променљивих из окружења.

Можете да наведете додатне параметре које ћете проследити скрипти када прилагођавате своје правило упозорења, али они које видите овде су подразумевано обезбеђени.

Имејл упозорења

Упозорење

🐞 Постоје познате грешке у Zammad-овој обради Checkmk имејл порука. Овај одељак ће бити комплетиран када буду решене. (Сазнајте више у GitHub извештају #2180.)

У међувремену, препоручујемо вам да уместо тога подесите API упозорења.