25 Izkliedes diagramma
Apraksts
Šie parametri un iespējamās attiecīgo paneļa logrīka lauku objektu rekvizītu vērtības ļauj konfigurēt Scatter plot logrīku dashboard.create un dashboard.update metodēs.
Logrīka fields rekvizīti paneļa izveides vai atjaunināšanas laikā netiek validēti.
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 Scatter plot logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk tabulās aprakstīto parametru darbību.
Parametri
Tālāk norādītie parametri tiek atbalstīti Izkliedes diagrammas 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. |
|
| Datu kopa: Vienumu saraksts | < | < | < | ||
| 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" |
|
| X ass | < | 4 | ds.0.x_axis_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 paneļa logrīka lauka objektu ar palielinātu skaitli rekvizīta nosaukumā. Parametra darbība: - obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts" un X ass (logrīks) nav iestatīta |
|
| X ass (logrīks) | < | 1 | ds.0.x_axis_itemids.0._reference | Vienuma 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 skaitli rekvizīta nosaukumā. Parametra darbība: - obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts" un X ass nav iestatīta |
|
| Y ass | < | 4 | ds.0.y_axis_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 paneļa logrīka lauka objektu ar palielinātu skaitli rekvizīta nosaukumā. Parametra darbība: - obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts" un Y ass (logrīks) nav iestatīta |
|
| Y ass (logrīks) | < | 1 | ds.0.y_axis_itemids.0._reference | Vienuma 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 skaitli rekvizīta nosaukumā. Parametra darbība: - obligāts, ja Datu kopas tips ir iestatīts uz "Vienumu saraksts" un Y ass nav iestatīta |
|
| Aizstāt hostu | < | 1 | ds.0.override_hostid._reference | ABCDE._hostid- iestatiet saderīgu logrīku (ar tā parametru "Atsauce", 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ī. |
|
| Datu kopa: 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ējamo vērtību diapazons: 0-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 |
|
| 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ī. |
|
| X ass vienumu šabloni | < | 1 | ds.0.x_axis_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" |
|
| Y ass vienumu šabloni | < | 1 | ds.0.y_axis_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" |
|
| Hostu grupas | < | 2 | groupids.0 | Hostu grupas ID. Piezīme: Lai konfigurētu vairākas hostu grupas, katrai hostu grupai izveidojiet paneļa logrīka lauka objektu ar palielinātu skaitli rekvizīta nosaukumā. Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
|
| Hostu grupas (logrīks) | < | 1 | groupids._reference | Hostu grupas ID vietā:ABCDE._hostgroupids - iestatiet saderīgu logrīku (ar tā parametru Atsauce, kas iestatīts uz "ABCDE") kā hostu grupu datu avotu.Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
|
| Aizstāt hostu | < | 1 | ds.0.override_hostid._reference | ABCDE._hostid- iestatiet saderīgu logrīku (ar tā parametru "Atsauce", 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ī. |
|
| Hostu birkas | < | < | < | < | |
| < | Novērtēšanas tips | 0 | evaltype_host | 0 - (noklusējums) Un/Vai; 2 - Vai. Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
|
| ^ | Birkas nosaukums | 1 | host_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 Hostu birkas Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
|
| ^ | Operators | 0 | host_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 Hostu birkas Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
|
| ^ | Birkas vērtība | 1 | host_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 Hostu birkas Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
|
| Marķieris | < | 0 | ds.0.marker | 0 - (noklusējums) Elipse; 1 - Kvadrāts; 2 - Trijstūris; 3 - Rombs; 4 - Zvaigzne; 5 - Krusts. |
|
| Marķiera izmērs | < | 0 | ds.0.marker_size | 0 - (noklusējums) Mazs (6px); 1 - Vidējs (9px); 2 - Liels (15px). |
|
| 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 intervāls | < | 1 | ds.0.aggregate_interval | Derīga laika virkne (piemēram, 3600, 1h utt.).Varat izmantot laika sufiksus. Noklusējums: 15m. |
|
| Agregācijas funkcija | < | 0 | ds.0.aggregate_function | 0 - netiek izmantota; 1 - min; 2 - max; 3 - (noklusējums) avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
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. |
| Hostu nosaukumi etiķetēs | 0 | show_hostnames | 0 - (noklusējums) Automātiski; 1 - Rādīt; 2 - Slēpt. Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
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._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 u.c.).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 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 asu konfigurēšanai.
| Parametrs | type | name | value |
|---|---|---|---|
| X ass | 0 | x_axis | 0 - Atspējota; 1 - (noklusējums) Iespējota. |
| Y ass | 0 | y_axis | 0 - (noklusējums) Atspējota; 1 - Iespējota. |
| Min | 1 | x_axis_min | Jebkura skaitliska vērtība. Noklusējums: "" (tukšs). |
| y_axis_min | |||
| Max | 1 | x_axis_max | Jebkura skaitliska vērtība. Noklusējums: "" (tukšs). |
| y_axis_max | |||
| Vienības (tips) | 0 | x_axis_units | 0 - (noklusējums) Automātiski; 1 - Statiski. |
| y_axis_units | |||
| Vienības (vērtība) | 1 | x_axis_static_units | Jebkura virknes vērtība. Noklusējums: "" (tukšs). |
| y_axis_static_units |
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 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ējamais vērtību diapazons: 1-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ējamais vērtību diapazons: 1-4. Noklusējums: 4. Parametra darbība: - atbalstīts, ja Rādīt leģendu ir iestatīts uz "Iespējots" |
Sliekšņi
Tālāk norādītie parametri tiek atbalstīti Sliekšņu konfigurēšanai.
Skaitlis Sliekšņu īpašības nosaukumā (piemēram, thresholds.0.color) norāda sliekšņa vietu sarakstā, kas sakārtots augošā secībā.
Tomēr, ja sliekšņi ir konfigurēti citā secībā, pēc logrīka konfigurācijas atjaunināšanas Zabbix lietotāja saskarnē vērtības tiks sakārtotas augošā secībā
(piemēram, "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parametrs | type | name | value |
|---|---|---|---|
| Krāsu interpolācija | 0 | interpolation | 0 - (noklusējums) Atspējota; 1 - Iespējota. |
| Krāsa | 1 | thresholds.0.color | Heksadecimāls krāsas kods (piemēram, FF0000). |
| X ass | 1 | thresholds.0.x_axis_threshold | Jebkura skaitliska vērtība. Tiek atbalstīti sufiksi (piemēram, "1d", "2w", "4K", "8G"). |
| Y ass | 1 | thresholds.0.y_axis_threshold | Jebkura skaitliska vērtība. Tiek atbalstīti sufiksi (piemēram, "1d", "2w", "4K", "8G"). |
Piemēri
Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju logrīkam Izkliedes diagramma.
Plašāku informāciju par paneļa konfigurēšanu skatiet dashboard.create.
Scatter plot logrīka konfigurēšana
Konfigurējiet Scatter plot logrīku šādi:
- 5 datu kopas ar tipu "Vienumu šabloni", katra ar noklusējuma agregāciju (avg, 15m) un atšķirīgiem marķieriem.
- Leģenda attēlo konfigurētos vienumus vienā rindā un divās kolonnās.
- Sliekšņi ir konfigurēti tā, lai marķieris tiktu iekrāsots sarkans, kad tā vērtība sasniedz 80 uz jebkuras ass.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "scatterplot",
"name": "Scatter plot",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "ds.0.color",
"value": "0C5A87"
},
{
"type": 1,
"name": "ds.0.hosts.0",
"value": "de-frankfurt*"
},
{
"type": 1,
"name": "ds.0.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.0.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.0.marker",
"value": 0
},
{
"type": 0,
"name": "ds.0.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.1.color",
"value": "66B0D9"
},
{
"type": 1,
"name": "ds.1.hosts.0",
"value": "fr-paris*"
},
{
"type": 1,
"name": "ds.1.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.1.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.1.marker",
"value": 1
},
{
"type": 0,
"name": "ds.1.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.2.color",
"value": "0A466A"
},
{
"type": 1,
"name": "ds.2.hosts.0",
"value": "lv-riga*"
},
{
"type": 1,
"name": "ds.2.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.2.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.2.marker",
"value": 2
},
{
"type": 0,
"name": "ds.2.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.3.color",
"value": "3394C3"
},
{
"type": 1,
"name": "ds.3.hosts.0",
"value": "pl-warsaw*"
},
{
"type": 1,
"name": "ds.3.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.3.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.3.marker",
"value": 3
},
{
"type": 0,
"name": "ds.3.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.4.color",
"value": "1492C8"
},
{
"type": 1,
"name": "ds.4.hosts.0",
"value": "se-stockholm*"
},
{
"type": 1,
"name": "ds.4.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.4.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.4.marker",
"value": 4
},
{
"type": 0,
"name": "ds.4.marker_size",
"value": 1
},
{
"type": 0,
"name": "legend_columns",
"value": 2
},
{
"type": 0,
"name": "interpolation",
"value": 1
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.0.x_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "thresholds.0.y_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.1.x_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.y_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "reference",
"value": "JQISY"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Atbilde:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}