8 Graph

Apraksts

Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu rekvizītu vērtības ļauj konfigurēt Graph logrīku dashboard.create un dashboard.update metodēs.

Logrīka fields rekvizīti netiek validēti paneļa izveides vai atjaunināšanas laikā. Tas ļauj lietotājiem modificēt iebūvētos logrīkus un izveidot pielāgotus logrīkus, taču vienlaikus rada arī risku logrīkus izveidot vai atjaunināt nepareizi. Lai nodrošinātu veiksmīgu Graph logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību.

Parametri

Tālāk norādītie parametri tiek atbalstīti Graph logrīkam.

Parametrs type name value
Atsvaidzināšanas intervāls 0 rf_rate 0 - Bez atsvaidzināšanas;
10 - 10 sekundes;
30 - 30 sekundes;
60 - (noklusējums) 1 minūte;
120 - 2 minūtes;
600 - 10 minūtes;
900 - 15 minūtes.
Atsauce 1 reference Jebkura virknes vērtība, kas sastāv no 5 rakstzīmēm (piemēram, ABCDE vai JBPNL). Šai vērtībai jābūt unikālai informācijas panelī, kuram pieder logrīks.

Parametra darbība:
- obligāts

Datu kopa

Tālāk norādītie parametri tiek atbalstīti Datu kopas konfigurēšanai.

Pirmais skaitlis rekvizīta nosaukumā (piemēram, ds.0.hosts.0, ds.0.items.0) apzīmē konkrēto datu kopu, savukārt otrais skaitlis, ja tāds ir, apzīmē konfigurēto hostu vai vienumu.

Parametrs type name value
Datu kopas tips 0 ds.0.dataset_type 0 - Vienumu saraksts;
1 - (noklusējums) Vienumu šabloni.
Vienumi 4 ds.0.itemids.0 Vienuma ID.

Konfigurējot logrīku veidnes panelī, jānorāda tikai tie vienumi, kas konfigurēti veidnē.

Piezīme: Lai konfigurētu vairākus vienumus, katram vienumam izveidojiet dashboard widget field objektu ar palielinātu skaitli rekvizīta nosaukumā.

Parametra darbība:
- obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts" un Vienumi (logrīks) nav iestatīts
Vienumi (logrīks) 1 ds.0.itemids.0._reference Vienuma ID vietā:
ABCDE._itemid - iestatiet saderīgu logrīku (ar tā parametru Reference, kas iestatīts uz "ABCDE") kā vienumu datu avotu.

Piezīme: Lai konfigurētu vairākus logrīkus, katram logrīkam izveidojiet dashboard widget field objektu ar palielinātu skaitli rekvizīta nosaukumā.

Parametra darbība:
- obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts" un Vienumi nav iestatīts
Krāsa 1 ds.0.color.0 Heksadecimāls krāsas kods (piemēram, FF0000).

Parametra darbība:
- obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts"
Hostu šabloni 1 ds.0.hosts.0 Hosta nosaukums vai šablons (piemēram, "Zabbix*").

Parametra darbība:
- obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu šabloni"

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Vienumu šabloni 1 ds.0.items.0 Vienuma nosaukums vai šablons (piemēram, "*: Apstrādāto *vērtību skaits sekundē").

Konfigurējot logrīku veidnes panelī, jānorāda tikai to vienumu šabloni, kas konfigurēti veidnē.

Parametra darbība:
- obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu šabloni"
Krāsa 1 ds.0.color Heksadecimāls krāsas kods (piemēram, FF0000).

Parametra darbība:
- atbalstīts, ja Datu kopas tips ir iestatīts uz "Vienumu šabloni" un Krāsu palete nav iestatīta
Krāsu palete 0 ds.0.color_palette Krāsu paletes indekss.

Iespējamās vērtības ir diapazonā no 0 līdz 11.

Noklusējums: 0.

Parametra darbība:
- atbalstīts, ja Datu kopas tips ir iestatīts uz "Vienumu šabloni" un Krāsa nav iestatīta
Zīmēšana 0 ds.0.type 0 - (noklusējums) Līnija;
1 - Punkti;
2 - Kāpņveida;
3 - Stabiņi.
Sakrauts 0 ds.0.stacked 0 - (noklusējums) Atspējots;
1 - Iespējots.

Parametra darbība:
- atbalstīts, ja Zīmēšana ir iestatīta uz "Līnija", "Kāpņveida" vai "Stabiņi"
Platums 0 ds.0.width Iespējamās vērtības ir diapazonā no 1 līdz 10.

Noklusējums: 1.

Parametra darbība:
- atbalstīts, ja Zīmēšana ir iestatīta uz "Līnija" vai "Kāpņveida"
Punkta izmērs 0 ds.0.pointsize Iespējamās vērtības ir diapazonā no 1 līdz 10.

Noklusējums: 3.

Parametra darbība:
- atbalstīts, ja Zīmēšana ir iestatīta uz "Punkti"
Caurspīdīgums 0 ds.0.transparency Iespējamās vērtības ir diapazonā no 1 līdz 10.

Noklusējums: 5.
Aizpildījums 0 ds.0.fill Iespējamās vērtības ir diapazonā no 1 līdz 10.

Noklusējums: 3.

Parametra darbība:
- atbalstīts, ja Zīmēšana ir iestatīta uz "Līnija" vai "Kāpņveida"
Trūkstošie dati 0 ds.0.missingdatafunc 0 - (noklusējums) Nav;
1 - Savienoti;
2 - Uzskatīt par 0;
3 - Pēdējā zināmā vērtība.

Parametra darbība:
- atbalstīts, ja Zīmēšana ir iestatīta uz "Līnija" vai "Kāpņveida"
Pārrakstīt hostu 1 ds.0.override_hostid._reference ABCDE._hostid- iestatiet saderīgu logrīku (ar tā parametru "Reference", kas iestatīts uz "ABCDE") kā hostu datu avotu;
DASHBOARD._hostid - iestatiet paneļa hostu atlasītāju kā hostu datu avotu.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Y ass 0 ds.0.axisy 0 - (noklusējums) Kreisā;
1 - Labā.
Invertēt vērtības 0 ds.0.invert_values 0 - (noklusējums) Atspējots;
1 - Iespējots.
Laika nobīde 1 ds.0.timeshift Derīga laika virkne (piemēram, 3600, 1h utt.).
Varat izmantot laika sufiksus. Ir atļautas arī negatīvas vērtības.

Noklusējums: "" (tukšs).
Agregācijas funkcija 0 ds.0.aggregate_function 0 - (noklusējums) netiek izmantota;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.
Agregācijas intervāls 1 ds.0.aggregate_interval Derīga laika virkne (piemēram, 3600, 1h utt.).
Varat izmantot laika sufiksus.

Noklusējums: 1h.
Agregēt 0 ds.0.aggregate_grouping 0 - (noklusējums) Katrs vienums;
1 - Datu kopa.

Parametra darbība:
- atbalstīts, ja Agregācijas funkcija ir iestatīta uz "min", "max", "avg", "count", "sum", "first" vai "last"
Aproksimācija 0 ds.0.approximation 1 - min;
2 - (noklusējums) avg;
4 - max;
7 - all.
Datu kopas etiķete 1 ds.0.data_set_label Jebkura virknes vērtība.

Noklusējums: "" (tukšs).
Vienumu birkas
Novērtēšanas tips 0 ds.0.item_tags_evaltype 0 - (noklusējums) Un/Vai;
2 - Vai.
Birkas nosaukums 1 ds.0.item_tags.0.tag Jebkura virknes vērtība.

Piezīme: Skaitlis rekvizīta nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Vienumu birkas
Operators 0 ds.0.item_tags.0.operator 0 - Satur;
1 - Vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Eksistē;
5 - Neeksistē.

Piezīme: Skaitlis rekvizīta nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Vienumu birkas
Birkas vērtība 1 ds.0.item_tags.0.value Jebkura virknes vērtība.

Piezīme: Skaitlis rekvizīta nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Vienumu birkas

Attēlošanas opcijas

Tālāk norādītie parametri tiek atbalstīti, lai konfigurētu Attēlošanas opcijas.

Parametrs type name value
Vēsturisko datu atlase 0 source 0 - (noklusējums) Auto;
1 - Vēsture;
2 - Tendences.
Vienkāršie trigeri 0 simple_triggers 0 - (noklusējums) Atspējots;
1 - Iespējots.
Darba laiks 0 working_time 0 - (noklusējums) Atspējots;
1 - Iespējots.
Hostu nosaukumi etiķetēs 0 show_hostnames 0 - (noklusējums) Auto;
1 - Rādīt;
2 - Slēpt.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Percentiles līnija (kreisā)
Statuss 0 percentile_left 0 - (noklusējums) Atspējots;
1 - Iespējots.

Parametra darbība:
- atbalstīts, ja Y ass (konfigurācijā Datu kopa) ir iestatīta uz "Left"
Vērtība 0 percentile_left_value Iespējamās vērtības ir diapazonā no 1 līdz 100.

Parametra darbība:
- atbalstīts, ja Y ass (konfigurācijā Datu kopa) ir iestatīta uz "Left"
Percentiles līnija (labā)
Statuss 0 percentile_right 0 - (noklusējums) Atspējots;
1 - Iespējots.

Parametra darbība:
- atbalstīts, ja Y ass (konfigurācijā Datu kopa) ir iestatīta uz "Right"
Vērtība 0 percentile_right_value Iespējamās vērtības ir diapazonā no 1 līdz 100.

Parametra darbība:
- atbalstīts, ja Y ass (konfigurācijā Datu kopa) ir iestatīta uz "Right"

Laika periods

Tālāk norādītie parametri tiek atbalstīti Laika perioda konfigurēšanai.

Parametrs type name value
Laika periods 1 time_period._reference DASHBOARD._timeperiod - iestatīt paneļa laika perioda atlasītāju kā datu avotu;
ABCDE._timeperiod - iestatīt saderīgu logrīku (ar tā parametru Atsauce, kas iestatīts uz "ABCDE") kā datu avotu.

Noklusējums: DASHBOARD._timeperiod

Alternatīvi, laika periodu var iestatīt tikai parametros No un Līdz.
No 1 time_period.from Derīga laika virkne absolūtā (YYYY-MM-DD hh:mm:ss) vai relatīvā laika sintaksē (now, now/d, now/w-1w utt.).

Parametra darbība:
- atbalstīts, ja Laika periods nav iestatīts
- obligāts, ja ir iestatīts time_period.to
Līdz 1 time_period.to Derīga laika virkne absolūtā (YYYY-MM-DD hh:mm:ss) vai relatīvā laika sintaksē (now, now/d, now/w-1w utt.).

Parametra darbība:
- atbalstīts, ja Laika periods nav iestatīts
- obligāts, ja ir iestatīts time_period.from

Asis

Tālāk norādītie parametri tiek atbalstīti Asis konfigurēšanai.

Parametrs type name value
Kreisā Y 0 lefty 0 - Atspējots;
1 - (noklusējums) Iespējots.

Parametra darbība:
- atbalstīts, ja Y ass (konfigurācijā Datu kopa) ir iestatīta uz "Left"
Labā Y 0 righty 0 - (noklusējums) Atspējots;
1 - Iespējots.

Parametra darbība:
- atbalstīts, ja Y ass (konfigurācijā Datu kopa) ir iestatīta uz "Right"
Mērogs 0 lefty_scale 0 - (noklusējums) Lineārs;
1 - Logaritmisks.
righty_scale
Minimums 1 lefty_min Jebkura skaitliska vērtība.

Noklusējums: "" (tukšs).
righty_min
Maksimums 1 lefty_max Jebkura skaitliska vērtība.

Noklusējums: "" (tukšs).
righty_max
Vienības (tips) 0 lefty_units 0 - (noklusējums) Automātiski;
1 - Statiski.
righty_units
Vienības (vērtība) 1 lefty_static_units Jebkura virknes vērtība.

Noklusējums: "" (tukšs).
righty_static_units
X ass 0 xaxis 0 - Atspējots;
1 - (noklusējums) Iespējots.

Leģenda

Tālāk norādītie parametri tiek atbalstīti Leģendas konfigurēšanai.

Parametrs type name value
Rādīt leģendu 0 legend 0 - Atspējots;
1 - (noklusējums) Iespējots.
Rādīt min/avg/max 0 legend_statistic 0 - (noklusējums) Atspējots;
1 - Iespējots.

Parametra darbība:
- atbalstīts, ja Rādīt leģendu ir iestatīts uz "Iespējots"
Rādīt agregācijas funkciju 0 legend_aggregation 0 - (noklusējums) Atspējots;
1 - Iespējots.

Parametra darbība:
- atbalstīts, ja Rādīt leģendu ir iestatīts uz "Iespējots"
Rindas 0 legend_lines_mode 0 - (noklusējums) Fiksēts;
1 - Mainīgs.

Parametra darbība:
- atbalstīts, ja Rādīt leģendu ir iestatīts uz "Iespējots"
Rindu skaits/
Maksimālais rindu skaits
0 legend_lines Iespējamās vērtības ir diapazonā no 1 līdz 10.

Noklusējums: 1.

Parametra darbība:
- atbalstīts, ja Rādīt leģendu ir iestatīts uz "Iespējots"
Kolonnu skaits 0 legend_columns Iespējamās vērtības ir diapazonā no 1 līdz 4.

Noklusējums: 4.

Parametra darbība:
- atbalstīts, ja Rādīt leģendu ir iestatīts uz "Iespējots" un Rādīt min/avg/max ir iestatīts uz "Atspējots"

Problēmas

Tālāk norādītie parametri tiek atbalstīti Problēmu konfigurēšanai.

Parametrs type name value
Rādīt problēmas 0 show_problems 0 - (noklusējums) Atspējots;
1 - Iespējots.
Tikai atlasītie vienumi 0 graph_item_problems 0 - Atspējots;
1 - (noklusējums) Iespējots.
Problēmu hosti 1 problemhosts.0 Hosta nosaukums.

Piezīme: Skaitlis īpašības nosaukumā norāda uz konfigurēto hostu.
Lai konfigurētu vairākus hostus, izveidojiet dashboard logrīka lauka objektu katram hostam ar palielinātu skaitli īpašības nosaukumā.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.
Svarīgums 0 severities.0 0 - Neklasificēts;
1 - Informācija;
2 - Brīdinājums;
3 - Vidējs;
4 - Augsts;
5 - Katastrofa.

Noklusējums: tukšs (visi iespējoti).

Piezīme: Lai konfigurētu vairākas vērtības, izveidojiet dashboard logrīka lauka objektu katrai vērtībai ar palielinātu skaitli īpašības nosaukumā.
Problēma 1 problem_name Problēmas notikuma nosaukums (reģistrjutība netiek ņemta vērā, pilns nosaukums vai tā daļa).
Problēmu birkas
Novērtēšanas veids 0 evaltype 0 - (noklusējums) Un/Vai;
2 - Vai.
Birkas nosaukums 1 tags.0.tag Jebkura virknes vērtība.

Piezīme: Skaitlis īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Problēmu birkas
Operators 0 tags.0.operator 0 - Satur;
1 - Vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Eksistē;
5 - Neeksistē.

Piezīme: Skaitlis īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Problēmu birkas
Birkas vērtība 1 tags.0.value Jebkura virknes vērtība.

Piezīme: Skaitlis īpašības nosaukumā norāda birkas secību birku novērtēšanas sarakstā.

Parametra darbība:
- obligāts, ja tiek konfigurētas Problēmu birkas

Aizstāšanas

Tālāk norādītie parametri tiek atbalstīti Aizstāšanu konfigurēšanai.

Pirmais skaitlis īpašības nosaukumā (piemēram, or.0.hosts.0, or.0.items.0) apzīmē konkrēto datu kopu, savukārt otrais skaitlis, ja tāds ir, apzīmē konfigurēto hostu vai vienumu.

Parametrs type name value
Hostu šabloni 1 or.0.hosts.0 Hosta nosaukums vai šablons (piemēram, Zabbix*).

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī.

Parametra darbība:
- obligāts, ja tiek konfigurētas Aizstāšanas
Vienumu šabloni 1 or.0.items.0 Vienuma nosaukums vai šablons (piemēram, *: Number of processed *values per second).
Ja logrīks tiek konfigurēts veidnes panelī, jānorāda tikai to vienumu šabloni, kas konfigurēti veidnē.

Parametra darbība:
- obligāts, ja tiek konfigurētas Aizstāšanas
Pamatkrāsa 1 or.0.color Heksadecimāls krāsas kods (piemēram, FF0000).
Platums 0 or.0.width Iespējamās vērtības ir diapazonā no 1 līdz 10.
Zīmēšana 0 or.0.type 0 - Līnija;
1 - Punkti;
2 - Kāpņveida;
3 - Josla.
Caurspīdīgums 0 or.0.transparency Iespējamās vērtības ir diapazonā no 1 līdz 10.
Aizpildījums 0 or.0.fill Iespējamās vērtības ir diapazonā no 1 līdz 10.
Punkta izmērs 0 or.0.pointsize Iespējamās vērtības ir diapazonā no 1 līdz 10.
Trūkstošie dati 0 or.0.missingdatafunc 0 - Nav;
1 - Savienots;
2 - Uzskatīt par 0;
3 - Pēdējā zināmā vērtība.
Y ass 0 or.0.axisy 0 - Kreisā;
1 - Labā.
Invertēt vērtības 0 or.0.invert_values 0 - (noklusējums) Atspējots;
1 - Iespējots.
Laika nobīde 1 or.0.timeshift Derīga laika virkne (piemēram, 3600, 1h utt.).
Varat izmantot laika sufiksus. Ir atļautas negatīvas vērtības.

Piemēri

Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju Graph logrīkam. Plašāku informāciju par paneļa konfigurēšanu skatiet dashboard.create.

Graph logrīka konfigurēšana

Konfigurējiet Graph logrīku šādi:

  • 2 datu kopas ar kopumā 9 vienumiem 1 hostā.
  • Pirmā datu kopa ir tipa "Item list" un sastāv no 3 vienumiem, kas ir attēloti kā līnijas ar atšķirīgu krāsu, bet vienādu platumu, caurspīdīgumu un aizpildījumu.
  • Otrā datu kopa ir tipa "Item patterns", sastāv no 6 vienumiem, tai ir konfigurēta agregācija, un tā ir attēlota kā līnija ar pielāgotu krāsu, platumu, caurspīdīgumu un aizpildījumu.
  • Otrajai datu kopai ir arī pielāgota datu kopas etiķete.
  • Dati grafikā tiek attēloti par pēdējo 3 stundu periodu.
  • Problēmas grafikā tiek attēlotas tikai konfigurētajiem vienumiem.
  • Grafikam ir divas Y asis, no kurām labā Y ass attēlo vērtības tikai otrajai datu kopai.
  • Grafika leģenda attēlo konfigurētos vienumus 4 rindās, kā arī datu kopu minimālās, maksimālās un vidējās vērtības.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "svggraph",
                        "name": "Graph",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "ds.0.dataset_type",
                                "value": 0
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.0",
                                "value": 23264
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.0",
                                "value": "FF0000"
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.1",
                                "value": 23269
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.1",
                                "value": "BF00FF"
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.2",
                                "value": 23257
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.2",
                                "value": "0040FF"
                            },
                            {
                                "type": 0,
                                "name": "ds.0.width",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.0.transparency",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.0.fill",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.1.hosts.0",
                                "value": "Zabbix server"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.items.0",
                                "value": "*: Number of processed *values per second"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.color",
                                "value": "000000"
                            },
                            {
                                "type": 0,
                                "name": "ds.1.transparency",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.1.fill",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.1.axisy",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "ds.1.aggregate_function",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "ds.1.aggregate_interval",
                                "value": "1m"
                            },
                            {
                                "type": 0,
                                "name": "ds.1.aggregate_grouping",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.1.data_set_label",
                                "value": "Number of processed values per second"
                            },
                            {
                                "type": 0,
                                "name": "graph_time",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_period.from",
                                "value": "now-3h"
                            },
                            {
                                "type": 1,
                                "name": "time_period.to",
                                "value": "now"
                            },
                            {
                                "type": 0,
                                "name": "legend_statistic",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "legend_lines",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "show_problems",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "YZABC"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}

Skatiet arī