18 Vienuma vērtība

Apraksts

Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauka objektiem ļauj konfigurēt Vienuma vērtība 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 Vienuma vērtība logrīka izveidi vai atjaunināšanu, lūdzu, skatiet parametru darbību, kas aprakstīta tālāk esošajās tabulās.

Parametri

Tālāk norādītie parametri tiek atbalstīti logrīkam Vienuma vērtība.

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.
Vienums 4 itemid.0 Vienuma ID.

Parametra darbība:
- obligāts, ja Vienums (logrīks) nav iestatīts
Vienums (logrīks) 1 itemid._reference Vienuma ID vietā:
ABCDE._itemid - iestatīt saderīgu logrīku (ar tā parametru Atsauce, kas iestatīts uz "ABCDE") kā datu avotu vienumiem.

Parametra darbība:
- obligāts, ja Vienums nav iestatīts
Rādīt 0 show.0 1 - Apraksts;
2 - Vērtība;
3 - Laiks;
4 - Izmaiņu indikators;
5 - Dzirksteles diagramma.

Noklusējums: 1, 2, 3, 4.

Piezīme: Lai konfigurētu vairākas vērtības, izveidojiet informācijas paneļa logrīka lauka objektu katrai vērtībai ar palielinātu numuru īpašības nosaukumā.
Pārrakstīt hostu 1 override_hostid._reference ABCDE._hostid - iestatīt saderīgu logrīku (ar tā parametru Atsauce, kas iestatīts uz "ABCDE") kā datu avotu hostiem;
DASHBOARD._hostid - iestatīt informācijas paneļa hostu atlasītāju kā datu avotu hostiem.

Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes informācijas panelī.

Paplašinātā konfigurācija

Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti logrīkam Vienuma vērtība.

Skaitlis īpašības Thresholds 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
Fona krāsa 1 bg_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Sliekšņi
Krāsa 1 thresholds.0.color Heksadecimāls krāsas kods (piemēram, FF0000).
Slieksnis 1 thresholds.0.threshold Jebkura virknes vērtība.
Agregācijas funkcija 0 aggregate_function 0 - (noklusējums) netiek izmantota;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.
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 reference, kas vienāds ar ABCDE) kā datu avotu.

Noklusējums: DASHBOARD._timeperiod

Alternatīvi, laika periodu var iestatīt tikai parametros No un Līdz.

Parametra darbība:
- atbalstīts, ja Agregācijas funkcija ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"
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 un Agregācijas funkcija ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"
- 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 un Agregācijas funkcija ir iestatīta uz "min", "max", "avg", "count", "sum", "first", "last"
- obligāts, ja ir iestatīts time_period.from
Vēstures dati 0 history 0 - (noklusējums) Auto;
1 - Vēsture;
2 - Tendences.
Apraksts

Ja Rādīt ir iestatīts uz “Apraksts”, tiek atbalstīti tālāk norādītie papildu konfigurācijas parametri.

Parametrs type name value
Apraksts 1 description Jebkura virknes vērtība, tostarp makro.
Atbalstītie makro: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makro.

Noklusējums: {ITEM.NAME}.
Horizontālais novietojums 0 desc_h_pos 0 - Pa kreisi;
1 - (noklusējums) Centrā;
2 - Pa labi.

Diviem vai vairākiem elementiem (Apraksts, Vērtība, Laiks) nevar būt vienāds Horizontālais novietojums un Vertikālais novietojums.
Vertikālais novietojums 0 desc_v_pos 0 - Augšā;
1 - Vidū;
2 - (noklusējums) Apakšā.

Diviem vai vairākiem elementiem (Apraksts, Vērtība, Laiks) nevar būt vienāds Horizontālais novietojums un Vertikālais novietojums.
Izmērs 0 desc_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 15.
Treknraksts 0 desc_bold 0 - (noklusējums) Atspējots;
1 - Iespējots.
Krāsa 1 desc_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Vērtība

Ja Rādīt ir iestatīts uz “Vērtība”, tiek atbalstīti šādi papildu konfigurācijas parametri.

Parametrs type name value
Cipari aiz komata
Cipari aiz komata 0 decimal_places Iespējamās vērtības ir no 1 līdz 10.

Noklusējums: 2.
Izmērs 0 decimal_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 35.
Pozīcija
Horizontālā pozīcija 0 value_h_pos 0 - pa kreisi;
1 - (noklusējums) centrā;
2 - pa labi.

Diviem vai vairākiem elementiem (Apraksts, Vērtība, Laiks) nevar būt vienāda Horizontālā pozīcija un Vertikālā pozīcija.
Vertikālā pozīcija 0 value_v_pos 0 - augšā;
1 - (noklusējums) vidū;
2 - apakšā.

Diviem vai vairākiem elementiem (Apraksts, Vērtība, Laiks) nevar būt vienāda Horizontālā pozīcija un Vertikālā pozīcija.
Izmērs 0 value_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 45.
Treknraksts 0 value_bold 0 - atspējots;
1 - (noklusējums) iespējots.
Krāsa 1 value_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Mērvienības
Mērvienības (izvēles rūtiņa) 0 units_show 0 - atspējots;
1 - (noklusējums) iespējots.
Mērvienības (vērtība) 1 units Jebkura virknes vērtība.
Pozīcija 0 units_pos 0 - pirms vērtības;
1 - virs vērtības;
2 - (noklusējums) pēc vērtības;
3 - zem vērtības.
Izmērs 0 units_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 35.
Treknraksts 0 units_bold 0 - atspējots;
1 - (noklusējums) iespējots.
Krāsa 1 units_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Laiks

Tiek atbalstīti tālāk norādītie papildu konfigurācijas parametri, ja Rādīt ir iestatīts uz “Laiks”.

Parametrs type name value
Horizontālais novietojums 0 time_h_pos 0 - Pa kreisi;
1 - (noklusējums) Centrā;
2 - Pa labi.

Diviem vai vairākiem elementiem (Apraksts, Vērtība, Laiks) nevar būt vienāds Horizontālais novietojums un Vertikālais novietojums.
Vertikālais novietojums 0 time_v_pos 0 - (noklusējums) Augšā;
1 - Vidū;
2 - Apakšā.

Diviem vai vairākiem elementiem (Apraksts, Vērtība, Laiks) nevar būt vienāds Horizontālais novietojums un Vertikālais novietojums.
Izmērs 0 time_size Iespējamās vērtības ir no 1 līdz 100.

Noklusējums: 15.
Treknraksts 0 time_bold 0 - (noklusējums) Atspējots;
1 - Iespējots.
Krāsa 1 time_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Izmaiņu indikators

Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja Rādīt ir iestatīts uz "Izmaiņu indikators".

Parametrs type name value
Izmaiņu indikatora ↑ krāsa 1 up_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Izmaiņu indikatora ↓ krāsa 1 down_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Izmaiņu indikatora ↕ krāsa 1 updown_color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: "" (tukšs).
Sparkline

Ja Rādīt ir iestatīts uz “Sparkline”, tiek atbalstīti tālāk norādītie papildu konfigurācijas parametri.

Parametrs type name value
Platums 0 sparkline.width Iespējamās vērtības ir no 0 līdz 10.

Noklusējums: 1.
Aizpildījums 0 sparkline.fill Iespējamās vērtības ir no 0 līdz 10.

Noklusējums: 3.
Krāsa 1 sparkline.color Heksadecimāls krāsas kods (piemēram, FF0000).

Noklusējums: 42A5F5.
Laika periods 1 sparkline.time_period._reference DASHBOARD._timeperiod - iestatīt informācijas paneļa laika perioda atlasītāju kā datu avotu;
ABCDE._timeperiod - iestatīt saderīgu logrīku (ar reference parametru, kas ir vienāds ar ABCDE) kā datu avotu.

Noklusējums: DASHBOARD._timeperiod

Varat arī iestatīt laika periodu tikai parametros No un Līdz.
No 1 sparkline.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:
- obligāts, ja ir iestatīts sparkline.time_period.to
Līdz 1 sparkline.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:
- obligāts, ja ir iestatīts sparkline.time_period.from
Vēsturiskie dati 0 sparkline.history 0 - (noklusējums) Automātiski;
1 - Vēsture;
2 - Tendences.

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 Vienuma vērtība. Plašāku informāciju par paneļa konfigurēšanu skatiet dashboard.create.

Vienuma vērtības logrīka konfigurēšana

Konfigurējiet Vienuma vērtības logrīku, kas attēlo vienuma vērtību vienumam "42266" (Zabbix aģenta pieejamība). Papildus tam vizuāli pielāgojiet logrīku, izmantojot vairākas papildu opcijas, tostarp dinamisku fona krāsu, kas mainās atkarībā no Zabbix aģenta pieejamības statusa.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "item",
                        "name": "Item value",
                        "x": 0,
                        "y": 0,
                        "width": 12,
                        "height": 3,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 4,
                                "name": "itemid.0",
                                "value": 42266
                            },
                            {
                                "type": 0,
                                "name": "show.0",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show.1",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "show.2",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "description",
                                "value": "Agent status"
                            },
                            {
                                "type": 0,
                                "name": "desc_h_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "desc_v_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "desc_bold",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "desc_color",
                                "value": "F06291"
                            },
                            {
                                "type": 0,
                                "name": "value_h_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "value_size",
                                "value": 25
                            },
                            {
                                "type": 1,
                                "name": "value_color",
                                "value": "FFFF00"
                            },
                            {
                                "type": 0,
                                "name": "units_show",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "time_h_pos",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "time_v_pos",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "time_size",
                                "value": 10
                            },
                            {
                                "type": 0,
                                "name": "time_bold",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_color",
                                "value": "9FA8DA"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.color",
                                "value": "E1E1E1"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.threshold",
                                "value": "0"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.color",
                                "value": "D1C4E9"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.threshold",
                                "value": "1"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}

Skatiet arī