Table of Contents
7 Novo protocolo de exportação JSON delimitado por nova linha
Esta seção apresenta detalhes do protocolo de exportação no formato JSON delimitado por nova linha, utilizado em:
Podem ser exportados:
- eventos de trigger
- valores de item
- tendências (apenas exportação para arquivos)
Todos os arquivos possuem a extensão .ndjson. Cada linha do arquivo de exportação é um objeto JSON.
Eventos de trigger
As seguintes informações são exportadas para um evento de problema:
| Campo | Tipo | Descrição | ||
|---|---|---|---|---|
| clock | number | Número de segundos desde a Época até o momento em que o problema foi detectado (parte inteira). | ||
| ns | number | Número de nanossegundos a serem adicionados ao clock para obter o tempo preciso de detecção do problema. |
||
| value | number | 1 (sempre). | ||
| eventid | number | ID do evento de problema. | ||
| name | string | Nome do evento de problema. | ||
| severity | number | Severidade do evento de problema (0 - Não classificado, 1 - Informação, 2 - Aviso, 3 - Médio, 4 - Alto, 5 - Desastre). | ||
| hosts | array | Lista de hosts envolvidos na expressão do trigger; deve haver pelo menos um elemento no array. | ||
| - | object | |||
| host | string | Nome do host. | ||
| name | string | Nome visível do host. | ||
| groups | array | Lista de grupos de hosts de todos os hosts envolvidos na expressão do trigger; deve haver pelo menos um elemento no array. | ||
| - | string | Nome do grupo de hosts. | ||
| tags | array | Lista de tags de problema (pode estar vazia). | ||
| - | object | |||
| tag | string | Nome da tag. | ||
| value | string | Valor da tag (pode estar vazio). | ||
As seguintes informações são exportadas para um evento de recuperação:
| Campo | Tipo | Descrição |
|---|---|---|
| clock | number | Número de segundos desde a Época até o momento em que o problema foi resolvido (parte inteira). |
| ns | number | Número de nanossegundos a serem adicionados ao clock para obter o tempo preciso de resolução do problema. |
| value | number | 0 (sempre). |
| eventid | number | ID do evento de recuperação. |
| p_eventid | number | ID do evento de problema. |
Exemplos
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"}]}Recuperação:
Problema (geração de múltiplos 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"}]}Recuperação:
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}
{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}Valores de item
As seguintes informações são exportadas para um valor de item coletado:
| Campo | Tipo | Descrição | ||
|---|---|---|---|---|
| host | object | Nome do host do item. | ||
| host | string | Nome do host. | ||
| name | string | Nome visível do host. | ||
| groups | array | Lista de grupos de hosts do host do item; deve haver pelo menos um elemento no array. | ||
| - | string | Nome do grupo de hosts. | ||
| item_tags | array | Lista de tags do item (pode estar vazia). | ||
| - | object | |||
| tag | string | Nome da tag. | ||
| value | string | Valor da tag (pode estar vazio). | ||
| itemid | number | ID do item. | ||
| name | string | Nome visível do item. | ||
| clock | number | Número de segundos desde a Época até o momento em que o valor foi coletado (parte inteira). | ||
| ns | number | Número de nanossegundos a ser adicionado a clock para obter o tempo preciso de coleta do valor. |
||
| timestamp (Log apenas) |
number | 0 se não disponível. | ||
| source (Log apenas) |
string | String vazia se não disponível. | ||
| severity (Log apenas) |
number | 0 se não disponível. | ||
| eventid (Log apenas) |
number | 0 se não disponível. | ||
| value | number (para itens numéricos) ou string (para itens de texto) |
Valor do item coletado. | ||
| type | number | Tipo de valor coletado: 0 - numérico float, 1 - caractere, 2 - log, 3 - numérico sem sinal, 4 - texto, 5 - binário |
||
Exemplos
Valor numérico (sem sinal):
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3}Valor numérico (float):
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0}Valor de caractere, texto:
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}Valor de log:
{"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2}Tendências
As seguintes informações são exportadas para um valor de tendência calculado:
| Campo | Tipo | Descrição | ||
|---|---|---|---|---|
| host | objeto | Nome do host do item. | ||
| host | string | Nome do host. | ||
| name | string | Nome visível do host. | ||
| groups | array | Lista de grupos de hosts do host do item; deve haver pelo menos um elemento no array. | ||
| - | string | Nome do grupo de hosts. | ||
| item_tags | array | Lista de tags do item (pode estar vazia). | ||
| - | objeto | |||
| tag | string | Nome da tag. | ||
| value | string | Valor da tag (pode estar vazio). | ||
| itemid | número | ID do item. | ||
| name | string | Nome visível do item. | ||
| clock | número | Número de segundos desde a Época até o momento em que o valor foi coletado (parte inteira). | ||
| count | número | Número de valores coletados para uma determinada hora. | ||
| min | número | Valor mínimo do item para uma determinada hora. | ||
| avg | número | Valor médio do item para uma determinada hora. | ||
| max | número | Valor máximo do item para uma determinada hora. | ||
| type | número | Tipo de valor: 0 - numérico float, 3 - numérico sem sinal |
||
Exemplos
Valor numérico (sem sinal):
{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}Valor numérico (float):