[comment]: # ({9fa25d4f-cb9df6d6})
# 7 Protocolo de exportación JSON delimitado por saltos de línea
Esta sección presenta detalles del protocolo de exportación en un
formato JSON delimitado por saltos de línea, utilizado en:
- [exportación de datos a archivos](/manual/config/export/files)
- [streaming a sistemas externos](/manual/config/export/streaming)
Se puede exportar lo siguiente:
- [eventos de trigger](#trigger-events)
- [valores de item](#item-values)
- [tendencias](#trends) (solo exportación a archivos)
Todos los archivos tienen una extensión .ndjson. Cada línea del archivo de exportación es un
objeto JSON.
[comment]: # ({/9fa25d4f-cb9df6d6})
[comment]: # ({c21bdb3b-bc637674})
#### Eventos de disparo
Se exporta la siguiente información para un evento de problema:
|Campo|<|<|Tipo|Descripción|
|-|-|----------|----------|------------------------------|
|*clock*|<|<|number|Número de segundos desde Epoch hasta el momento en que se detectó el problema (parte entera).|
|*ns*|<|<|number|Número de nanosegundos a añadir a `clock` para obtener una hora precisa de detección del problema.|
|*value*|<|<|number|1 (siempre).|
|*eventid*|<|<|number|ID del evento de problema.|
|*name*|<|<|string|Nombre del evento de problema.|
|*severity*|<|<|number|Gravedad del evento de problema (0 - No clasificado, 1 - Información, 2 - Advertencia, 3 - Media, 4 - Alta, 5 - Desastre).|
|*hosts*|<|<|array|Lista de equipos involucrados en la expresión del disparador; debe haber al menos un elemento en el array.|
| |\-|<|object|<|
|^| |*host*|string|Nombre del equipo.|
|^|^|*name*|string|Nombre visible del equipo.|
|*groups*|<|<|array|Lista de grupos de equipos de todos los equipos involucrados en la expresión del disparador; debe haber al menos un elemento en el array.|
| |\-|<|string|Nombre del grupo de equipos.|
|*tags*|<|<|array|Lista de etiquetas de problema (puede estar vacía).|
| |\-|<|object|<|
|^| |*tag*|string|Nombre de la etiqueta.|
|^|^|*value*|string|Valor de la etiqueta (puede estar vacío).|
Se exporta la siguiente información para un evento de recuperación:
|Campo|Tipo|Descripción|
|--|--|------|
|*clock*|number|Número de segundos desde Epoch hasta el momento en que se resolvió el problema (parte entera).|
|*ns*|number|Número de nanosegundos a añadir a `clock` para obtener una hora precisa de resolución del problema.|
|*value*|number|0 (siempre).|
|*eventid*|number|ID del evento de recuperación.|
|*p\_eventid*|number|ID del evento de problema.|
[comment]: # ({/c21bdb3b-bc637674})
[comment]: # ({9eccc413-9eccc413})
##### Ejemplos
Problema:
{"clock":1519304285,"ns":123456789,"value":1,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}
Recuperación:
{"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42}
Problema (generación de múltiples eventos de problema):
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix agent is unreachable on Host B or pollers are too busy on Zabbix Server","severity":3,"hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix Server","name":"Zabbix Server visible"}],"groups":["Group X","Group Y","Group Z","Zabbix servers"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Riga"}]}
Recuperación:
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}
[comment]: # ({/9eccc413-9eccc413})
[comment]: # ({3974e212-9faee484})
#### Valores de item
La siguiente información se exporta para un valor de item recopilado:
|Field|<|<|Type|Description|
|-|-|---------|---------|---------------------------|
|*host*|<|<|object|Nombre del host del host del item.|
| |host|<|string|Nombre del host.|
|^|name|<|string|Nombre visible del host.|
|*groups*|<|<|array|Lista de grupos de host del host del item; debe haber al menos un elemento en el array.|
| |\-|<|string|Nombre del grupo de host.|
|*item_tags*|<|<|array|Lista de etiquetas del item (puede estar vacía).|
| |\-|<|object|<|
|^| |*tag*|string|Nombre de la etiqueta.|
|^|^|*value*|string|Valor de la etiqueta (puede estar vacío).|
|*itemid*|<|<|number|ID del item.|
|*name*|<|<|string|Nombre visible del item.|
|*clock*|<|<|number|Número de segundos desde la época Unix hasta el momento en que se recopiló el valor (parte entera).|
|*ns*|<|<|number|Número de nanosegundos que se agregarán a `clock` para obtener un tiempo de recopilación del valor preciso.|
|*timestamp*
(*Log* only)|<|<|number|0 si no está disponible.|
|*source*
(*Log* only)|<|<|string|Cadena vacía si no está disponible.|
|*severity*
(*Log* only)|<|<|number|0 si no está disponible.|
|*eventid*
(*Log* only)|<|<|number|0 si no está disponible.|
|*value*|<|<|number (for numeric items) or
string (for text items)|Valor del item recopilado.|
|*type*|<|<|number|Tipo de valor recopilado:
0 - flotante numérico, 1 - carácter, 2 - log, 3 - entero sin signo, 4 - texto, 5 - binario|
[comment]: # ({/3974e212-9faee484})
[comment]: # ({6353c75c-683a131b})
##### Ejemplos
Valor numérico (sin signo):
{"host":{"host":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Disponibilidad del agente","clock":1519304285,"ns":123456789,"value":1,"type":3}
Valor numérico (coma flotante):
{"host":{"host":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"Carga de CPU","clock":1519304285,"ns":123456789,"value":0.1,"type":0}
Valor carácter, texto:
{"host":{"host":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":2,"name":"Versión del agente","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}
Valor de registro:
{"host":{"host":"Equipo A","name":"Equipo A visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":1,"name":"Mensajes en el archivo de registro","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"mensaje del archivo de registro","type":2}
[comment]: # ({/6353c75c-683a131b})
[comment]: # ({0fd6cef6-f534dda9})
#### Tendencias
Se exporta la siguiente información para un valor de tendencia calculado:
|Campo|<|<|Tipo|Descripción|
|-|-|---------|---------|---------------------------|
|*host*|<|<|objeto|Nombre del equipo de la métrica.|
| |host|<|cadena|Nombre del equipo.|
|^|name|<|cadena|Nombre visible del equipo.|
|*groups*|<|<|array|Lista de grupos de equipos del equipo de la métrica; debe haber al menos un elemento en el array.|
| |\-|<|cadena|Nombre del grupo de equipos.|
|*item_tags*|<|<|array|Lista de etiquetas de la métrica (puede estar vacía).|
| |\-|<|objeto|<|
|^| |*tag*|cadena|Nombre de la etiqueta.|
|^|^|*value*|cadena|Valor de la etiqueta (puede estar vacío).|
|*itemid*|<|<|número|ID de la métrica.|
|*name*|<|<|cadena|Nombre visible de la métrica.|
|*clock*|<|<|número|Número de segundos desde Epoch hasta el momento en que se recogió el valor (parte entera).|
|*count*|<|<|número|Número de valores recogidos para una hora determinada.|
|*min*|<|<|número|Valor mínimo de la métrica para una hora determinada.|
|*avg*|<|<|número|Valor medio de la métrica para una hora determinada.|
|*max*|<|<|número|Valor máximo de la métrica para una hora determinada.|
|*type*|<|<|número|Tipo de valor:
0 - numérico flotante, 3 - numérico sin signo|
[comment]: # ({/0fd6cef6-f534dda9})
[comment]: # ({dd3701c0-8606813d})
##### Ejemplos
Valor numérico (sin signo):
{"host":{"host":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Disponibilidad del agente","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}
Valor numérico (coma flotante):
{"host":{"host":"Equipo B","name":"Equipo B visible"},"groups":["Grupo X","Grupo Y","Grupo Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"Carga de CPU","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}
[comment]: # ({/dd3701c0-8606813d})