Transmisión a sistemas externos

Resumen

Es posible transmitir valores de item 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 item o eventos.

Dos tipos de procesos de Zabbix server son responsables de la transmisión de datos: connector manager y connector worker. Un item interno de Zabbix, zabbix[connector_queue], permite supervisar la cantidad de valores encolados en la cola del conector.

Configuración

Los siguientes pasos son necesarios para configurar la transmisión de datos a un sistema externo:

1. Configure un sistema remoto para recibir datos de Zabbix. Para ello, 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.
• Kafka connector for Zabbix server: un server ligero escrito en Go, diseñado para reenviar valores de item y eventos desde un server de Zabbix a un broker de Kafka.

2. Establezca el número necesario de workers de connector en Zabbix ajustando el parámetro StartConnectors en zabbix_server.conf. El número de workers de connector debe coincidir con el número de connectors configurado en el frontend de Zabbix (o ser superior si hay más de 1 sesión simultánea). A continuación, reinicie el server de Zabbix.

3. Configure un nuevo connector en el frontend de Zabbix (Administración > General > Connectors) y vuelva a cargar la caché del server con el comando zabbix_server -R config_cache_reload.

Los campos obligatorios están marcados con un asterisco.

Cuando el Kafka connector se configura con una lista de direcciones de brokers de arranque separadas por comas (por ejemplo, Kafka.URL=kafka1.example.com:9093,kafka2.example.com:9093), el cliente de Kafka se conecta al broker o brokers que responden primero y utiliza sus metadatos del clúster. Si la lista contiene direcciones de distintos clústeres de Kafka, solo se utilizará el clúster que responda más rápido y las demás direcciones se registrarán como no disponibles; como resultado, pueden aparecer advertencias de inicio como la siguiente aunque el connector esté conectado:

kafka cluster connected, but broker(s) "kafka1.example.com:9093, kafka2.example.com:9093" unavailable; will retry on message send if active brokers fail 

En algunos entornos (redes privadas, redes de contenedores o configuraciones de DNS/hosts no estándar), los nombres de host o las IP pueden resolverse en direcciones de loopback (por ejemplo, 127.0.0.1/localhost) o ser normalizados por el cliente, lo que puede hacer que estas advertencias resulten engañosas. Para reducir la confusión, asegúrese de que todas las direcciones de Kafka.URL pertenezcan al mismo clúster de Kafka, verifique la resolución DNS desde el host del connector y los advertised.listeners de los brokers, y prefiera las direcciones que se resuelvan en la dirección anunciada del broker.

Protocolo

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

Para obtener más detalles, consulte Protocolo de exportación JSON delimitado por saltos de 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 consta del código de estado de la respuesta HTTP y de 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 hayan procesado correctamente; cualquier otro indica solicitudes fallidas.

Ejemplo de éxito:

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
Date: Tue, 21 Apr 2026 10:13:04 GMT
Content-Length: 23

{"response":"success"}

Ejemplo con errores:

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff
Date: Tue, 21 Apr 2026 12:15:01 GMT
Content-Length: 55

{"error":"invalid character '{' after top-level value"}