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

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ā palielinot 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ā palielinot 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”
Vienuma tips 0 ds.0.type.0 0 - (noklusējums) Parasts;
1 - Kopsumma.

Vērtību “Kopsumma” 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 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
Apkopošanas funkcija 0 ds.0.aggregate_function 1 - minimums;
2 - maksimums;
3 - vidējais;
4 - skaits;
5 - summa;
6 - pirmais;
7 - (noklusējums) pēdējais.
Datu kopas apkopošana 0 ds.0.dataset_aggregation 0 - (noklusējums) nav;
1 - minimums;
2 - maksimums;
3 - vidējais;
4 - skaits;
5 - summa.

Parametra darbība:
- atbalstīts, ja Vienuma tips ir iestatīts uz “Kopsumma”
Datu kopas etiķete 1 ds.0.data_set_label Jebkura virknes vērtība.

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

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

Parametra darbība:
- obligāts, ja tiek konfigurēti Vienumu tagi
Operators 0 ds.0.item_tags.0.operator 0 - Satur;
1 - Ir vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Pastāv;
5 - Nepastāv.

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

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

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

Parametra darbība:
- obligāts, ja tiek konfigurēti Vienumu tagi

Attēlošanas opcijas

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

Parametrs type name value
Vēsturisko datu atlase 0 source 0 - (noklusējums) Automātiski;
1 - Vēsture;
2 - Tendences.
Zīmēšana 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ēšana ir iestatīta uz “Gredzenveida diagramma”
Līnijas platums 0 stroke Iespējamās vērtības ir no 0 līdz 10.

Noklusējums: 0.

Parametra darbība:
- atbalstīts, ja Zīmēšana ir iestatīta 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ēšana ir iestatīta uz “Gredzenveida diagramma”
Izmērs 0 value_size_type 0 - (noklusējums) Automātiski;
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 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ļas 0 decimal_places Iespējamās vērtības ir 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 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 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._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

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

Pieprasījums:

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

Skatiet arī