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 los detalles del protocolo).

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

Dos procesos del servidor Zabbix son responsables de la transmisión de datos: connector manager y connector worker. Una métrica interna de Zabbix zabbix[connector_queue] permite monitorizar el número de valores encolados 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. Para este propósito, están disponibles las siguientes herramientas:

• Un ejemplo de un receptor simple que registra la información recibida en los archivos events.ndjson y history.ndjson.
• Conector Kafka para Zabbix server: un servidor ligero escrito en Go, diseñado para reenviar valores de métricas y eventos desde un Zabbix server a un broker Kafka.

2. Establezca el número requerido de procesos de conector en Zabbix ajustando el parámetro StartConnectors en zabbix_server.conf. El número de procesos de conector debe coincidir (o superar si las sesiones concurrentes son más de 1) con el número de conectores configurados en el frontend de Zabbix. Luego, reinicie el Zabbix server.

3. Configure un nuevo conector en el frontend de Zabbix (Administración → General → Conectores) y recargue 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 la API REST, NDJSON, "Content-Type: application/x-ndjson".

Para más detalles, consulte Protocolo de exportación de JSON delimitado por nueva línea.

Solicitud del servidor

Ejemplo de transmisión 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 transmisión 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 consiste en el código de estado de la respuesta HTTP y la carga útil JSON. El código de estado de la respuesta HTTP debe ser "200", "201", "202", "203" o "204" para las solicitudes que se manejaron correctamente, y otro valor 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"}