2 Streaming a sistemes externs

Vista general

És possible transmetre valors i esdeveniments d'elements des de Zabbix a sistemes externs mitjançant HTTP (veieu detalls del protocol).

:::avís de nota Aquesta funció actualment té un estat experimental. :::

El filtre d'etiquetes es pot emprar per transmetre subconjunts de valors d'elements o esdeveniments.

Dos processos del servidor Zabbix són els responsables de la transmissió de dades: 'administrador de connectors' i 'treballador de connectors'. Un element intern de Zabbix zabbix[connector_queue] permet monitorar el recompte de valors posats en cua a la cua de connectors.

Configuració

Cal seguir les passes següents per configurar la transmissió de dades a un sistema extern:

1. Teniu un sistema remot configurat per rebre dades de Zabbix.

Consulteu la documentació d'un receptor senzill. Actualment, el receptor registra la informació rebuda als fitxers events.ndjson i history.ndjson.

2. Establiu el nombre necessari de treballadors del connector a Zabbix ajustant el paràmetre StartConnectors a zabbix_server.conf. El nombre de treballadors dels connectors ha de coincidir (o sobrepassar, si el nombre de sessions concurrents és superior a 1) el recompte de connectors configurats a la interfície de Zabbix. Després, reinicieu el servidor Zabbix.

3. Configureu un connector nou a la interfície de Zabbix (Administració → General → Connectors) i torneu a carregar la memòria cau del servidor amb la comanda zabbix_server -R config_cache_reload.

Els camps obligatoris són marcats amb asterisc.

Protocol

La comunicació entre el servidor i el receptor es fa via HTTP amb l'API REST, NDJSON, "Tipus de contingut: aplicació/x-ndjson".

Per obtindre més informació, consulteu protocol d'exportació JSON delimitat per una línia nova.

Peticions del servidor

Exemple d'enviament de valors d'elements:

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}

Exemple d'enviament d'esdeveniments:

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}

Resposta del receptor

La resposta consisteix en el codi d'estat de resposta HTTP i la càrrega útil JSON. El codi d'estat de la resposta HTTP ha de ser "200" per a les peticions que s'han gestionat correctament, una altra per a les peticions fallides.

Exemple d'èxit:

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

Exemple amb errors:

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"}