21 Sektoru diagramma
Apraksts
Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu īpašību vērtības ļauj konfigurēt Sektoru diagrammas logrīku dashboard.create un dashboard.update metodēs.
Logrīka fields īpašības netiek validētas 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 izveidot vai atjaunināt logrīkus nepareizi.
Lai nodrošinātu veiksmīgu Sektoru diagrammas 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 logrīkam Sektoru diagramma.
| 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. |
Datu kopa
Tālāk norādītie parametri tiek atbalstīti Datu kopas konfigurēšanai.
Pirmais skaitlis īpašības nosaukumā (piem., 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 | Item 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 paneļa logrīka lauka objektu ar palielinātu numuru īpašības 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 | Item ID vietā:ABCDE._itemid - iestatiet saderīgu logrīku (ar tā parametru Atsauce, kas iestatīts uz "ABCDE") kā vienumu datu avotu.Piezīme: Lai konfigurētu vairākus logrīkus, katram logrīkam izveidojiet paneļa logrīka lauka objektu ar palielinātu numuru īpašības 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., FF0000).Parametra darbība: - obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts" |
|
| Vienuma tips | 0 | ds.0.type.0 | 0 - (noklusējums) Normāls; 1 - Kopā. Vērtību "Kopā" var iestatīt tikai vienam vienumam visā diagrammā. Parametra darbība: - atbalstīts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts" |
|
| Hostu šabloni | 1 | ds.0.hosts.0 | Host nosaukums vai šablons (piem., "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 | Item nosaukums vai šablons (piem., "*: Number of processed *values per second"). 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., 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 |
|
| Agregācijas funkcija | 0 | ds.0.aggregate_function | 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - (noklusējums) last. |
|
| Datu kopas agregācija | 0 | ds.0.dataset_aggregation | 0 - (noklusējums) nav; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum. Parametra darbība: - atbalstīts, ja Vienuma tips ir iestatīts uz "Kopā" |
|
| 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) And/Or; 2 - Or. |
|
| Birkas nosaukums | 1 | ds.0.item_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 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 īpašības 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 īpašības 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 Attēlošanas opciju konfigurēšanai.
| Parametrs | type | name | value | |
|---|---|---|---|---|
| Vēsturisko datu atlase | 0 | source | 0 - (noklusējums) Auto; 1 - Vēsture; 2 - Tendences. |
|
| Zīmējums | 0 | draw_type | 0 - (noklusējums) Sektoru diagramma; 1 - Gredzenveida diagramma. |
|
| Platums | 0 | width | 20 - 20% no rādiusa; 30 - 30% no rādiusa; 40 - 40% no rādiusa; 50 - (noklusējums) 50% no rādiusa. Parametra darbība: - atbalstīts, ja Zīmējums ir iestatīts uz "Gredzenveida diagramma" |
|
| Kontūras platums | 0 | stroke | Iespējamās vērtības ir diapazonā no 0 līdz 10. Noklusējums: 0. Parametra darbība: - atbalstīts, ja Zīmējums ir iestatīts uz "Gredzenveida diagramma" |
|
| Rādīt kopējo vērtību | 0 | total_show | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parametra darbība: - atbalstīts, ja Zīmējums ir iestatīts uz "Gredzenveida diagramma" |
|
| Izmērs | 0 | value_size_type | 0 - (noklusējums) Auto; 1 - Pielāgots. Parametra darbība: - atbalstīts, ja Rādīt kopējo vērtību ir iestatīts uz "Iespējots" |
|
| Izmērs (pielāgotā izmēra vērtība) | 0 | value_size | Iespējamās vērtības ir diapazonā no 1 līdz 100. Noklusējums: 20. Parametra darbība: - atbalstīts, ja Rādīt kopējo vērtību ir iestatīts uz "Iespējots" |
|
| Decimāldaļu skaits | 0 | decimal_places | Iespējamās vērtības ir diapazonā no 0 līdz 6. Noklusējums: 2. Parametra darbība: - atbalstīts, ja Rādīt kopējo vērtību ir iestatīts uz "Iespējots" |
|
| Mērvienības (izvēles rūtiņa) | 0 | units_show | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parametra darbība: - atbalstīts, ja Rādīt kopējo vērtību ir iestatīts uz "Iespējots" |
|
| Mērvienības (vērtība) | 1 | units | Jebkura virknes vērtība. Parametra darbība: - atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz "Iespējots" |
|
| Treknraksts | 0 | value_bold | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parametra darbība: - atbalstīts, ja Rādīt kopējo vērtību ir iestatīts uz "Iespējots" |
|
| Krāsa | 1 | value_color | Heksadecimāls krāsas kods (piemēram, FF0000).Parametra darbība: - atbalstīts, ja Rādīt kopējo vērtību ir iestatīts uz "Iespējots" |
|
| Atstarpe starp sektoriem | 0 | space | Iespējamās vērtības ir diapazonā no 0 līdz 10. Noklusējums: 1. |
|
| Apvienot sektorus, kas ir mazāki par N% (izvēles rūtiņa) | 0 | merge | 0 - (noklusējums) Atspējots; 1 - Iespējots. |
|
| Apvienot sektorus, kas ir mazāki par N% (vērtība) | 0 | merge_percent | Iespējamās vērtības ir diapazonā no 1 līdz 10. Noklusējums: 1. Parametra darbība: - atbalstīts, ja Apvienot sektorus, kas ir mazāki par N% (izvēles rūtiņa) ir iestatīta uz "Iespējots" |
|
| Apvienot sektorus, kas ir mazāki par N% (krāsa) | 1 | merge_color | Heksadecimāls krāsas kods (piemēram, FF0000).Parametra darbība: - atbalstīts, ja Apvienot sektorus, kas ir mazāki par N% (izvēles rūtiņa) ir iestatīta uz "Iespējots" |
|
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 - iestata paneļa laika perioda atlasītāju kā datu avotu;ABCDE._timeperiod - iestata saderīgu logrīku (ar tā parametru Atsauce, kas iestatīts uz "ABCDE") kā datu avotu.Noklusējums: DASHBOARD._timeperiodAlternatī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 |
|
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 vērtību | 0 | legend_value | 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 vērtību ir iestatīts uz "Atspējots" |
Piemēri
Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju Pie chart logrīkam.
Plašāku informāciju par paneļa konfigurēšanu skatiet dashboard.create.
Sektoru diagrammas logrīka konfigurēšana
Konfigurējiet Sektoru diagrammas logrīku šādi:
- 2 datu kopas ar kopumā 9 vienumiem 1 hostā.
- Pirmā datu kopa ir tipa "Vienumu saraksts" un sastāv no 3 vienumiem, kuri visi ir ar tipu "Parasts" un attēloti dažādās krāsās.
- Otrā datu kopa ir tipa "Vienumu šabloni", sastāv no 6 vienumiem, tai ir konfigurēta agregācija katram vienumam, un tā ir attēlota ar pielāgotu krāsu.
- Otrajai datu kopai ir arī pielāgota datu kopas etiķete.
- Dati sektoru diagrammā tiek attēloti kā gredzenveida diagramma ar pielāgotu platumu un kopējo vērtību ar mērvienībām centrā.
- Dati sektoru diagrammā tiek attēloti un agregēti pielāgotam pēdējo 3 stundu laika periodam.
- Sektoru diagrammas leģenda attēlo konfigurētos vienumus 4 rindās.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "piechart",
"name": "Pie chart",
"x": 0,
"y": 0,
"width": 24,
"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": 0,
"name": "ds.0.type.0",
"value": 0
},
{
"type": 4,
"name": "ds.0.itemids.1",
"value": 23269
},
{
"type": 1,
"name": "ds.0.color.1",
"value": "BF00FF"
},
{
"type": 0,
"name": "ds.0.type.1",
"value": 0
},
{
"type": 4,
"name": "ds.0.itemids.2",
"value": 23257
},
{
"type": 1,
"name": "ds.0.color.2",
"value": "0040FF"
},
{
"type": 0,
"name": "ds.0.type.2",
"value": 0
},
{
"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.aggregate_function",
"value": 3
},
{
"type": 1,
"name": "ds.1.data_set_label",
"value": "Number of processed values per second"
},
{
"type": 0,
"name": "draw_type",
"value": 1
},
{
"type": 0,
"name": "width",
"value": 30
},
{
"type": 0,
"name": "total_show",
"value": 1
},
{
"type": 0,
"name": "units_show",
"value": 1
},
{
"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_lines",
"value": 4
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Atbilde:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}