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
Datu kopas konfigurēšanai tiek atbalstīti tālāk norādītie parametri.
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 informācijas panelī, jāiestata tikai veidnē konfigurētie vienumi. Piezīme: Lai konfigurētu vairākus vienumus, izveidojiet atsevišķu informācijas paneļa logrīka lauka objektu katram vienumam, rekvizīta nosaukumā izmantojot palielinātu skaitli. Parametra darbība: - obligāts, ja Datu kopas tips ir iestatīts uz “Vienumu saraksts” un Vienumi (logrīks) nav iestatīti |
|
| Vienumi (logrīks) | 1 | ds.0.itemids.0._reference | Vienuma ID vietā:ABCDE._itemid - iestatiet saderīgu logrīku (kura Atsauces parametrs ir iestatīts uz "ABCDE") kā vienumu datu avotu.Piezīme: Lai konfigurētu vairākus logrīkus, izveidojiet atsevišķu informācijas paneļa logrīka lauka objektu katram logrīkam, rekvizīta nosaukumā izmantojot palielinātu skaitli. Parametra darbība: - obligāts, ja Datu kopas tips ir iestatīts uz “Vienumu saraksts” un Vienumi nav iestatīti |
|
| 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 informācijas 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 informācijas panelī, jāiestata tikai veidnē konfigurēto vienumu šabloni. 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 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 - Pakāpieni; 3 - Josla. |
|
| 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”, “Pakāpieni” vai “Josla” |
|
| Platums | 0 | ds.0.width | Iespējamās vērtības ir no 1 līdz 10. Noklusējums: 1. Parametra darbība: - atbalstīts, ja Zīmēšana ir iestatīta uz “Līnija” vai “Pakāpieni” |
|
| Punkta izmērs | 0 | ds.0.pointsize | Iespējamās vērtības ir 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 no 1 līdz 10. Noklusējums: 5. |
|
| Aizpildījums | 0 | ds.0.fill | Iespējamās vērtības ir no 1 līdz 10. Noklusējums: 3. Parametra darbība: - atbalstīts, ja Zīmēšana ir iestatīta uz “Līnija” vai “Pakāpieni” |
|
| Trūkstošie dati | 0 | ds.0.missingdatafunc | 0 - (noklusējums) Nav; 1 - Savienoti; 2 - Uzskatīt par 0; 3 - Pēdējie zināmie. Parametra darbība: - atbalstīts, ja Zīmēšana ir iestatīta uz “Līnija” vai “Pakāpieni” |
|
| Hosta ignorēšana | 1 | ds.0.override_hostid._reference | ABCDE._hostid - iestatiet saderīgu logrīku (kura “Atsauces” parametrs ir iestatīts uz "ABCDE") kā hostu datu avotu;DASHBOARD._hostid - iestatiet informācijas paneļa hostu atlasītāju kā hostu datu avotu.Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes informācijas panelī. |
|
| Y ass | 0 | ds.0.axisy | 0 - (noklusējums) Kreisā; 1 - Labā. |
|
| Laika nobīde | 1 | ds.0.timeshift | Derīga laika virkne (piemēram, 3600, 1h u. c.).Varat izmantot laika sufiksus. Ir atļautas arī negatīvas vērtības. Noklusējums: "" (tukšs). |
|
| Apkopošanas funkcija | 0 | ds.0.aggregate_function | 0 - (noklusējums) netiek izmantota; 1 - minimums; 2 - maksimums; 3 - vidējais; 4 - skaits; 5 - summa; 6 - pirmais; 7 - pēdējais. |
|
| Apkopošanas intervāls | 1 | ds.0.aggregate_interval | Derīga laika virkne (piemēram, 3600, 1h u. c.).Varat izmantot laika sufiksus. Noklusējums: 1h. |
|
| Apkopot | 0 | ds.0.aggregate_grouping | 0 - (noklusējums) Katrs vienums; 1 - Datu kopa. Parametra darbība: - atbalstīts, ja Apkopošanas funkcija ir iestatīta uz “minimums”, “maksimums”, “vidējais”, “skaits”, “summa”, “pirmais” vai “pēdējais” |
|
| Aproksimācija | 0 | ds.0.approximation | 1 - minimums; 2 - (noklusējums) vidējais; 4 - maksimums; 7 - visi. |
|
| Datu kopas etiķete | 1 | ds.0.data_set_label | Jebkura virknes vērtība. Noklusējums: "" (tukšs). |
|
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) Automātiski; 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. |
|
| Procentiles 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 “Kreisā” |
|
| Vērtība | 0 | percentile_left_value | Iespējamās vērtības ir no 1 līdz 100. Parametra darbība: - atbalstīts, ja Y ass (konfigurācijā Datu kopa) ir iestatīta uz “Kreisā” |
|
| Procentiles 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 “Labā” |
|
| Vērtība | 0 | percentile_right_value | Iespējamās vērtības ir no 1 līdz 100. Parametra darbība: - atbalstīts, ja Y ass (konfigurācijā Datu kopa) ir iestatīta uz “Labā” |
|
Laika periods
Tālāk norādītie parametri tiek atbalstīti, konfigurējot Laika periodu.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Laika periods | 1 | time_period._reference | DASHBOARD._timeperiod - iestata Laika perioda atlasītāju kā datu avotu;ABCDE._timeperiod - iestata saderīgu logrīku (ar parametru Reference, kas iestatīts uz "ABCDE") kā datu avotu.Noklusējums: DASHBOARD._timeperiodAlternatīvi, laika periodu var iestatīt tikai parametros From un To. |
|
| From | 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 u. c.).Parametra darbība: - atbalstīts, ja Laika periods nav iestatīts - obligāts, ja ir iestatīts time_period.to |
|
| To | 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 u. c.).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
Leģendas konfigurēšanai tiek atbalstīti šādi parametri.
| Parametrs | tips | nosaukums | vērtība |
|---|---|---|---|
| Rādīt leģendu | 0 | legend | 0 - Atspējots; 1 - (noklusējums) Iespējots. Parametra darbība: - atbalstīts, ja Rādīt leģendu ir iestatīts uz “Iespējots” |
| Rādīt min./vid./maks. | 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 apkopošanas 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 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 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./vid./maks. 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 |
|
Pārrakstīšanas noteikumi
Pārrakstīšanas noteikumu konfigurēšanai tiek atbalstīti tālāk norādītie parametri.
Pirmais skaitlis rekvizīta 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 raksti | 1 | or.0.hosts.0 | Hosta nosaukums vai raksts (piemēram, Zabbix*).Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes informācijas panelī. Parametra darbība: - obligāts, ja tiek konfigurēti pārrakstīšanas noteikumi |
| Vienumu raksti | 1 | or.0.items.0 | Vienuma nosaukums vai raksts (piemēram, *: Number of processed *values per second).Konfigurējot logrīku veidnes informācijas panelī, jāiestata tikai to vienumu raksti, kuri konfigurēti veidnē. Parametra darbība: - obligāts, ja tiek konfigurēti pārrakstīšanas noteikumi |
| 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 no 1 līdz 10. |
| Zīmēšana | 0 | or.0.type | 0 - Līnija; 1 - Punkti; 2 - Pakāpieni; 3 - Josla. |
| Caurspīdīgums | 0 | or.0.transparency | Iespējamās vērtības ir no 1 līdz 10. |
| Aizpildījums | 0 | or.0.fill | Iespējamās vērtības ir no 1 līdz 10. |
| Punkta izmērs | 0 | or.0.pointsize | Iespējamās vērtības ir 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ā. |
| Laika nobīde | 1 | or.0.timeshift | Derīga laika virkne (piemēram, 3600, 1h u. c.).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.
{
"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
}