Documentation

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

Преглед

Могуће је стримовати вредности ставки и догађаје са 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 корисничком интерфејсу. Затим поново покрените Заббик сервер.

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: 628Content-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"}