1 Eksportēšana uz failiem

Pārskats

Ir iespējams konfigurēt trigeru notikumu, vienumu vērtību un tendenču reāllaika eksportēšanu newline-delimited JSON formātā.

Eksportēšana tiek veikta failos, kur katra eksporta faila rinda ir JSON objekts. Vērtību kartējumi netiek piemēroti.

Kļūdu gadījumā (datus nevar ierakstīt eksporta failā, eksporta failu nevar pārdēvēt vai pēc pārdēvēšanas nevar izveidot jaunu failu), datu vienums tiek atmests un nekad netiek ierakstīts eksporta failā. Tas tiek ierakstīts tikai Zabbix datubāzē. Datu rakstīšana eksporta failā tiek atsākta, kad rakstīšanas problēma ir novērsta.

Eksporta fails tiek izveidots ar lasīšanas un rakstīšanas atļaujām tikai faila īpašniekam. Papildus fails ir lasāms īpašnieka grupai. Visas pārējās atļaujas ir liegtas.

Ņemiet vērā, ka host/item var nebūt metadatu (hostu grupas, hosta nosaukuma, vienuma nosaukuma), ja hosts/vienums tika noņemts pēc datu saņemšanas, bet pirms serveris eksportēja datus.

Konfigurācija

Reāllaika trigeru notikumu, vienumu vērtību un tendenču eksportēšana tiek konfigurēta, norādot direktoriju eksporta failiem - skatiet ExportDir parametru servera konfigurācijā.

Ir pieejami vēl divi parametri:

  • ExportFileSize var izmantot, lai iestatītu viena eksporta faila maksimāli atļauto izmēru. Kad procesam ir jāieraksta failā, tas vispirms pārbauda faila izmēru. Ja tas pārsniedz konfigurēto izmēra ierobežojumu, faila nosaukumam tiek pievienots .old, un tiek izveidots jauns fails ar sākotnējo nosaukumu.

Katram procesam, kas rakstīs datus, tiks izveidots atsevišķs fails (t. i., aptuveni 4-30 faili). Tā kā noklusējuma izmērs vienam eksporta failam ir 1G, lielu eksporta failu glabāšana var ātri iztukšot diska vietu.

  • ExportType ļauj norādīt, kuri entītiju tipi (notikumi, vēsture, tendences) tiks eksportēti.

Jaunas rindas atdalīts JSON eksporta protokols

Šajā sadaļā ir sniegta informācija par eksporta protokolu newline-delimited JSON formātā, ko izmanto:

Visiem failiem ir .ndjson paplašinājums. Katra eksporta faila rinda ir JSON objekts.

Trigeru notikuma eksports

Tālāk norādītā informācija tiek eksportēta problēmas notikumam:

Field Type Description
clock number Sekunžu skaits kopš Epoch līdz brīdim, kad problēma tika konstatēta (veselā daļa).
ns number Nanosekunžu skaits, kas jāpieskaita clock, lai iegūtu precīzu problēmas konstatēšanas laiku.
value number 1 (vienmēr).
eventid number Problēmas notikuma ID.
name string Problēmas notikuma nosaukums.
severity number Problēmas notikuma nopietnība (0 - Nav klasificēts, 1 - Informācija, 2 - Brīdinājums, 3 - Vidējs, 4 - Augsts, 5 - Katastrofāls).
hosts array To hosts saraksts, kas iesaistīti trigeris izteiksmē; masīvā jābūt vismaz vienam elementam.
- object
host string Hosta nosaukums.
name string Redzamais hosta nosaukums.
groups array Visu to hosts grupu saraksts, kas iesaistīti trigeris izteiksmē; masīvā jābūt vismaz vienam elementam.
- string Hostu grupas nosaukums.
tags array Problēmas tagu saraksts (var būt tukšs).
- object
tag string Taga nosaukums.
value string Taga vērtība (var būt tukša).

Tālāk norādītā informācija tiek eksportēta atjaunošanās notikumam:

Field Type Description
clock number Sekunžu skaits kopš Epoch līdz brīdim, kad problēma tika atrisināta (veselā daļa).
ns number Nanosekunžu skaits, kas jāpieskaita clock, lai iegūtu precīzu problēmas atrisināšanas laiku.
value number 0 (vienmēr).
eventid number Atjaunošanās notikuma ID.
p_eventid number Problēmas notikuma ID.
Trigeru notikumu eksportēšanas piemēri

Problēma:

{"clock":1519304285,"ns":123456789,"value":1,"name":"Either Zabbix aģents is unreachable on Host B or pollers are too busy on Zabbix serveris","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"}]}

Atjaunošana:

{"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42}

Problēma (vairāku problēmu notikumu ģenerēšana):

{"clock":1519304286,"ns":123456789,"value":1,"eventid":43,"name":"Either Zabbix aģents is unreachable on Host B or pollers are too busy on Zabbix serveris","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 aģents is unreachable on Host B or pollers are too busy on Zabbix serveris","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"}]}

Atjaunošana:

{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43}

{"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42}

Vienuma vērtības eksports

Tālāk norādītā informācija tiek eksportēta savāktai vienuma vērtībai:

Field Type Description
host object Vienuma hosta nosaukums.
host string Hosta nosaukums.
name string Redzamais hosta nosaukums.
groups array Vienuma hosta hostu grupu saraksts; masīvā jābūt vismaz vienam elementam.
- string Hostu grupas nosaukums.
item_tags array Vienuma tagu saraksts (var būt tukšs).
- object
tag string Taga nosaukums.
value string Taga vērtība (var būt tukša).
itemid number Vienuma ID.
name string Redzamais vienuma nosaukums.
clock number Sekunžu skaits kopš Epoch brīža līdz brīdim, kad vērtība tika savākta (veselā daļa).
ns number Nanosekunžu skaits, kas jāpieskaita clock, lai iegūtu precīzu vērtības savākšanas laiku.
timestamp
(Log only)		 number 0, ja nav pieejams.
source
(Log only)		 string Tukša virkne, ja nav pieejams.
severity
(Log only)		 number 0, ja nav pieejams.
eventid
(Log only)		 number 0, ja nav pieejams.
value number (for numeric items) or
string (for text items)		 Savāktā vienuma vērtība.
type number Savāktās vērtības tips:
0 - skaitliskais peldošais punkts, 1 - rakstzīme, 2 - žurnāls, 3 - skaitliskais bez zīmes, 4 - teksts, 5 - binārs, 6 - JSON
Vienuma vērtības eksportēšanas piemērs

Skaitliska (bez zīmes) vērtība:

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Aģenta pieejamība","clock":1519304285,"ns":123456789,"value":1,"type":3}

Skaitliska (peldošā komata) vērtība:

{"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 noslodze","clock":1519304285,"ns":123456789,"value":0.1,"type":0}

Rakstzīmju, teksta vērtība:

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":2,"name":"Aģenta versija","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4}

Žurnāla vērtība:

{"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":1,"name":"Ziņojumi žurnāla failā","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"žurnāla faila ziņojums","type":2}

Trendu eksports

Tālāk norādītā informācija tiek eksportēta aprēķinātai trendu vērtībai:

Field Type Description
host object Vienuma hosta nosaukums.
host string Hosta nosaukums.
name string Redzamais hosta nosaukums.
groups array Vienuma hosta hostu grupu saraksts; masīvā jābūt vismaz vienam elementam.
- string Hostu grupas nosaukums.
item_tags array Vienuma tagu saraksts (var būt tukšs).
- object
tag string Taga nosaukums.
value string Taga vērtība (var būt tukša).
itemid number Vienuma ID.
name string Redzamais vienuma nosaukums.
clock number Sekunžu skaits kopš Unix laikmeta brīža, kad vērtība tika savākta (veselā daļa).
count number Savākto vērtību skaits noteiktā stundā.
min number Minimālā vienuma vērtība noteiktā stundā.
avg number Vidējā vienuma vērtība noteiktā stundā.
max number Maksimālā vienuma vērtība noteiktā stundā.
type number Vērtības tips:
0 - skaitlis ar peldošo komatu, 3 - bez zīmes skaitlis
Trendu eksporta piemēri

Skaitliska (bez zīmes) vērtība:

{"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"item_tags":[{"tag":"foo","value":"test"}],"itemid":3,"name":"Aģenta pieejamība","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3}

Skaitliska (peldošā komata) vērtība:

{"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 noslodze","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0}