7 Протокол за извоз JSON-а раздвојеног новим редом
Овај одељак представља детаље протокола за извоз у JSON формату раздвојеном новим редом, који се користи у:
Следеће се може извести:
- тригер догађаји
- вредности ставки
- трендови (само извоз у датотеке)
Све датотеке имају екстензију .ndjson. Сваки ред извозне датотеке је JSON објекат.
Окидачи догађаја
Следеће информације се извозе за проблемски догађај:
| Field | Type | Description | ||
|---|---|---|---|---|
| clock | број | Број секунди од епохе до тренутка када је проблем откривен (цео број). | ||
| ns | број | Број наносекунди које треба додати на clock да би се добило прецизно време откривања проблема. |
||
| value | број | 1 (увек). | ||
| eventid | број | ИД проблемског догађаја. | ||
| name | string | Назив проблемског догађаја. | ||
| озбиљност | број | Озбиљност проблемског догађаја (0 - Није класификовано, 1 - Информација, 2 - Упозорење, 3 - Просечно, 4 - Високо, 5 - Катастрофа). | ||
| hosts | array | Листа хостова укључених у израз окидача; треба да постоји барем један елемент у низу. | ||
| - | object | |||
| host | string | Име домаћина. | ||
| name | string | Видљиво име домаћина. | ||
| групе | array | Листа група домаћина свих домаћина укључених у израз окидача; треба да постоји барем један елемент у низу. | ||
| - | string | Име групе домаћина. | ||
| tags | низ | Листа ознака проблема (може бити празна). | ||
| - | object | |||
| tag | string | Име ознаке. | ||
| value | string | Вредност ознаке (може бити празно). | ||
Следеће информације се извозе за догађај опоравка:
| Field | Type | Description |
|---|---|---|
| clock | number | Број секунди од епохе до тренутка када је проблем решен (целобројни део). |
| ns | number | Број наносекунди које треба додати на clock да би се добило прецизно време решавања проблема. |
| вредност | number | 0 (увек). |
| eventid | number | ID догађаја опоравка. |
| p_eventid | number | ID догађаја проблема. |
Примери
Проблем:
{"clock":1519304285,"ns":123456789,"value":1,"name":"Или је Zabbix агент недоступан на домаћину Б или су анкетари презаузети на Zabbix серверу","severity":3,"eventid":42, "hosts":[{"host":"Host B", "name":"Host B visible"},{"host":"Zabbix сервер","name":"Zabbix сервер visible"}],"groups":["Група X","Група Y","Група Z","Zabbix сервери"],"tags":[{"tag":"availability","value":""},{"tag":"data center","value":"Рига"}]}
Опоравак:
{"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42}
Проблем (генерисање вишеструких проблемских догађаја):
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Или је Zabbix агент недоступан на домаћину Б или су анкетари презаузети на Zabbix серверу","severity":3,"hosts":[{"host":"Домаћин B", "name":"Домаћин B видљив"},{"host":"Zabbix сервер","name":"Zabbix сервер видљив"}],"groups":["Група X","Група Y","Група Z","Zabbix сервери"],"tags":[{"tag":"доступност","value":""},{"tag":"центар података","value":"Рига"}]}
{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Или је Zabbix агент недоступан на домаћину B или су анкетари презаузети на Zabbix серверу","severity":3,"hosts":[{"host":"Домаћин B", "name":"Домаћин B видљив"},{"host":"Zabbix сервер","name":"Zabbix сервер видљив"}],"groups":["Група X","Група Y","Група Z","Zabbix сервери"],"tags":[{"tag":"доступност","value":""},{"tag":"подаци центар","вредност":"Рига"}]}
Опоравак:
{"clock":1519304346,"ns":987654321,"вредност":0,"eventid":44,"p_eventid":43}
{"clock":1519304346,"ns":987654321,"вредност":0,"eventid":44,"p_eventid":42}
Вредности ставки
Следеће информације се извозе за прикупљену вредност ставке:
| Field | Type | Description | ||
|---|---|---|---|---|
| host | object | Име домаћина домаћина ставке. | ||
| host | string | Име домаћина. | ||
| name | string | Видљиво име домаћина. | ||
| groups | array | Листа група домаћина домаћина ставке; треба да постоји барем један елемент у низу. | ||
| - | string | Име групе домаћина. | ||
| item_tags | array | Листа ознака ставки (може бити празна). | ||
| - | object | |||
| tag | string | Име ознаке. | ||
| value | string | Вредност ознаке (може бити празно). | ||
| itemid | број | ID ставке. | ||
| name | string | Назив видљиве ставке. | ||
| clock | number | Број секунди од епохе до тренутка када је вредност прикупљена (цео број). | ||
| ns | number | Број наносекунди које треба додати на clock да би се добило прецизно време прикупљања вредности. |
||
| временска ознака (само Log) |
број | 0 ако није доступно. | ||
| source (само Log) |
string | Празан стринг ако није доступно. | ||
| severity (само Log) |
number | 0 ако није доступно. | ||
| eventid (само Log) |
number | 0 ако није доступно. | ||
| value | број (за нумеричке ставке) или стринг (за текстуалне ставке) |
Прикупљена вредност ставке. | ||
| type | number | Тип прикупљене вредности: 0 - нумерички покретни број, 1 - карактер, 2 - логаритам, 3 - нумерички без знака, 4 - текст, 5 - бинарни |
||
Примери
Нумеричка (непотписана) вредност:
{"host":{"host":"Домаћин B","name":"Домаћин B видљив"},"groups":["Група X","Група Y","Група Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Доступност агента","clock":1519304285,"ns":123456789,"value":1,"type":3}
Нумеричка (float) вредност:
{"host":{"host":"Домаћин B","name":"Домаћин B видљив"},"groups":["Група X","Група Y","Група Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Учитај", "clock":1519304285, "ns":123456789, "value":0.1, "type":0}
Знак, текст вредност:
{"host":{"host":"Домаћин B", "name":"Домаћин B видљив"}, "groups":["Група X", "Група Y", "Група Z"], "item_tags":[{"tag":"foo", "value":"test"}], "itemid":2, "name":"Верзија агента", "clock":1519304285, "ns":123456789, "value":"3.4.4", "type":4}
Вредност евиденције:
{"host":{"host":"Домаћин B", "name":"Домаћин А видљив"}, "groups":["Група X", "Група Y", "Група З"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":1,"name":"Поруке у датотеци дневника","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"порука у датотеци дневника","type":2}
Трендови
Следеће информације се извозе за израчунату вредност тренда:
| Field | Type | Description | ||
|---|---|---|---|---|
| host | object | Име домаћина домаћина ставке. | ||
| host | string | Име домаћина. | ||
| name | string | Видљиво име домаћина. | ||
| groups | array | Листа група домаћина домаћина ставке; треба да постоји барем један елемент у низу. | ||
| - | string | Име групе домаћина. | ||
| item_tags | array | Листа ознака ставки (може бити празна). | ||
| - | object | |||
| tag | string | Име ознаке. | ||
| value | стринг | Вредност ознаке (може бити празно). | ||
| itemid | број | ID ставке. | ||
| name | стринг | Назив видљиве ставке. | ||
| clock | број | Број секунди од епохе до тренутка када је вредност прикупљена (целобројни део). | ||
| count | број | Број вредности прикупљених за дати сат. | ||
| min | број | Минимална вредност ставке за дати сат. | ||
| avg | број | Просечна вредност ставке за дати сат. | ||
| max | број | Максимална вредност ставке за дати сат. | ||
| type | број | Тип вредности: 0 - нумерички покретни број, 3 - нумерички неозначен |
||
Примери
Нумеричка вредност (неозначено):
{"host":{"host":"Домаћин B","name":"Домаћин B је видљив"},"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}
Нумеричка вредност (float):
{"host":{"host":"Домаћин B","name":"Домаћин B је видљив"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}