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._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 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.

Pieprasījums:

{
    "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
}

Skatiet arī