2 Transmisión a sistemas externos

Descripción general

Es posible transmitir valores de métricas y eventos desde Zabbix a sistemas externos a través de HTTP (consulte detalles del protocolo).

El filtro de etiquetas se puede utilizar para transmitir subconjuntos de valores de métricas o eventos.

Dos procesos del servidor Zabbix son responsables de la transmisión de datos: "administrador de conectores" y "trabajador de conectores". Una métrica interna de Zabbix zabbix[connector_queue] permite monitorear el recuento de valores en cola en la cola del conector.

Configuración

Se requieren los siguientes pasos para configurar la transmisión de datos a un sistema externo:

1. Tener un sistema remoto configurado para recibir datos de Zabbix.

Consulte la documentación de un receptor simple. Actualmente, el receptor registra la información recibida en los archivos events.ndjson y history.ndjson.

2. Establezca el número de trabajadores del conector requeridos en Zabbix ajustando el parámetro StartConnectors en zabbix_server.conf. El número de trabajadores del conector debe coincidir (o exceder si las sesiones simultáneas son más del 1) recuento de conectores configurado en la interfaz de Zabbix. Luego, reinicie el servidor Zabbix.

3. Configure un nuevo conector en la interfaz de Zabbix (Administración -> General -> Conectores) y vuelva a cargar la caché del servidor con el comando "zabbix_server -R config_cache_reload".

Los campos obligatorios están marcados con un asterisco.

Protocolo

La comunicación entre el servidor y el receptor se realiza a través de HTTP utilizando REST API, NDJSON, "Content-Type: application/x-ndjson".

Para obtener más detalles, consulte el protocolo de exportación JSON delimitado por salto de línea.

Solicitud del servidor

Ejemplo de envío de valores de métricas:

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}

Ejemplo de envío de eventos:

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}

Respuesta del receptor

La respuesta consta del código de estado de respuesta HTTP y la carga útil JSON. El código de estado de respuesta HTTP debe ser "200" para las solicitudes que se manejaron correctamente y otro para las solicitudes fallidas.

Ejemplo de éxito:

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

Ejemplo con errores:

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