2 Стримовање на екстерне системе

Преглед

Могуће је стримовати вредности ставки и догађаје са Zabbix-а на спољне системе преко HTTP-а (погледајте детаљи протокола).

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

Два процеса Zabbix сервера су одговорна за стримовање података: менаџер конектора и конекторски радник. Zabbix интерна ставка zabbix[connector_queue] омогућава праћење броја вредности у реду у реду конектора.

Конфигурација

Следећи кораци су потребни за конфигурисање стримовања података на екстерни систем:

1. Подешавање удаљеног система за пријем података из Zabbix-а. У ту сврху, доступни су следећи алати:

• Пример једноставног пријемника који евидентира примљене информације у датотекама events.ndjson и history.ndjson.
• Kafka конектор за Zabbix сервер - лагани сервер написан у Go-у, дизајниран за прослеђивање вредности ставки и догађаја са Zabbix сервера на Kafka брокер.

2. Подесите потребан број конекторских радника у Zabbix-у подешавањем параметра StartConnectors у zabbix_server.conf. Број конекторских радника треба да се подудара (или да буде већи ако је број истовремених сесија већи од 1) са конфигурисаним бројем конектора у Zabbix корисничком интерфејсу. Затим, поново покрените Zabbix сервер.

3. Конфигуришите нови конектор у Zabbix корисничком интерфејсу (Администрација → Опште → Конектори) и поново учитајте кеш сервера помоћу команде zabbix_server -R config_cache_reload.

Обавезна поља су означена звездицом.

Протокол

Комуникација између сервера и пријемника се обавља преко HTTP-а помоћу REST API-ја, NDJSON, "Content-Type: application/x-ndjson".

За више детаља погледајте Протокол за извоз JSON раздвојених новим редовима.

Захтев за сервер

Пример вредности ставки за стримовање:

POST /v1/history HTTP/1.1
       Host: localhost:8080
       Accept: */*
       Accept-Encoding: deflate, gzip, br, zstd
       Content-Length: 628
       Content-Type: application/x-ndjson
       
       {"host":{"host":"Zabbix server","name":"Zabbix server"},"groups":["Zabbix servers"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":44457,"name":"foo","clock":1673454303,"ns":800155804,"value":0,"type":3}
       {"host":{"host":"Zabbix server","name":"Zabbix server"},"groups":["Zabbix servers"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":44457,"name":"foo","clock":1673454303,"ns":832290669,"value":1,"type":3}
       {"host":{"host":"Zabbix server","name":"Zabbix server"},"groups":["Zabbix servers"],"item_tags":[{"tag":"bar","value":"test"}],"itemid":44458,"name":"bar","clock":1673454303,"ns":867770366,"value":123,"type":3}

Пример стримованих догађаја:

POST /v1/events HTTP/1.1
       Host: localhost:8080
       Accept: */*
       Accept-Encoding: deflate, gzip, br, zstd
       Content-Length: 333
       Content-Type: application/x-ndjson
       
       {"clock":1673454303,"ns":800155804,"value":1,"eventid":5,"name":"trigger for foo being 0","severity":0,"hosts":[{"host":"Zabbix server","name":"Zabbix server"}],"groups":["Zabbix servers"],"tags":[{"tag":"foo_trig","value":"test"},{"tag":"foo","value":"test"}]}{"clock":1673454303,"ns":832290669,"value":0,"eventid":6,"p_eventid":5}

Одговор примаоца

Одговор се састоји од HTTP кода статуса одговора и JSON корисног оптерећења. Код статуса HTTP одговора мора бити "200", "201", "202", "203", или "204" за захтеве који су успешно обрађени, други за неуспеле захтеве.

Пример успеха:

localhost:8080/v1/history": HTTP/1.1 200 OK
       Date: Wed, 11 Jan 2023 16:40:30 GMT
       Content-Length: 0

Пример са грешкама:

localhost:8080/v1/history": HTTP/1.1 422 Unprocessable Entity
       Content-Type: application/json
       Date: Wed, 11 Jan 2023 17:07:36 GMT
       Content-Length: 55
       
       {"error":"invalid character '{' after top-level value"}