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

Šie parametri ir atbalstīti Vienuma vērtība logrīkam.

Parameter type name value
Refresh interval 0 rf_rate 0 - Nav 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.
Item 4 itemid.0 Vienuma ID.

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

Parametra darbība:
- obligāts, ja Item nav iestatīts
Show 0 show.0 1 - Apraksts;
2 - Vērtība;
3 - Laiks;
4 - Izmaiņu indikators;
5 - Sparkline.

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

Piezīme: lai konfigurētu vairākas vērtības, izveidojiet katrai vērtībai atsevišķu dashboard widget field objektu ar palielinātu numuru īpašības nosaukumā.
Override host 1 override_hostid._reference ABCDE._hostid - iestatiet saderīgu logrīku (ar tā Reference parametru iestatītu uz "ABCDE") kā datu avotu hosts;
DASHBOARD._hostid - iestatiet paneļa Host atlasītāju kā datu avotu hosts.

Šis parametrs netiek atbalstīts, konfigurējot logrīku veidnes panelī.

Papildu konfigurācija

Tālāk norādītie papildu konfigurācijas parametri ir atbalstīti Vienuma vērtība logrīkam.

Skaitlis Sliekšņi rekvizīta nosaukumā (piem., thresholds.0.color) norāda sliekšņa pozīciju sarakstā, kas sakārtots augošā secībā. Tomēr, ja sliekšņi ir konfigurēti citā secībā, vērtības pēc logrīka konfigurācijas atjaunināšanas Zabbix lietotāja saskarnē tiks sakārtotas augošā secībā (piem., "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").

Parametrs tips nosaukums vērtība
Fona krāsa 1 bg_color Heksadecimāls krāsas kods (piem., FF0000).

Noklusējums: "" (tukšs).
Sliekšņi
Krāsa 1 thresholds.0.color Heksadecimāls krāsas kods (piem., FF0000).
Slieksnis 1 thresholds.0.threshold Jebkura virknes vērtība.
Apkopošanas funkcija 0 aggregate_function 0 - (noklusējums) netiek izmantots;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.
Laika periods 1 time_period._reference DASHBOARD._timeperiod - iestata Laika perioda atlasītāju kā datu avotu;
ABCDE._timeperiod - iestata saderīgu logrīku (ar tā reference parametru, kas ir 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 Apkopošanas 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 Apkopošanas 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 Apkopošanas 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 - History;
2 - Trends.
Apraksts

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

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

Noklusējums: {ITEM.NAME}.
Horizontālā pozīcija 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āda Horizontālā pozīcija un Vertikālā pozīcija.
Vertikālā pozīcija 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āda Horizontālā pozīcija un Vertikālā pozīcija.
Izmērs 0 desc_size Iespējamās vērtības ir diapazonā 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

Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja Rādīt ir iestatīts uz "Vērtība".

Parametrs type name value
Decimālvietas
Decimālvietas 0 decimal_places Iespējamās vērtības ir diapazonā no 1 līdz 10.

Noklusējums: 2.
Izmērs 0 decimal_size Iespējamās vērtības ir diapazonā 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 diapazonā 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 diapazonā 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

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

Parametrs type name value
Horizontālā pozīcija 0 time_h_pos 0 - Pa kreisi;
1 - (noklusējums) Centrā;
2 - Pa labi.

Divi vai vairāki elementi (Apraksts, Vērtība, Laiks) nevar koplietot vienu un to pašu Horizontālo pozīciju un Vertikālo pozīciju.
Vertikālā pozīcija 0 time_v_pos 0 - (noklusējums) Augšā;
1 - Vidū;
2 - Apakšā.

Divi vai vairāki elementi (Apraksts, Vērtība, Laiks) nevar koplietot vienu un to pašu Horizontālo pozīciju un Vertikālo pozīciju.
Izmērs 0 time_size Iespējamās vērtības ir diapazonā 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

Tālāk norādītie papildu konfigurācijas parametri tiek atbalstīti, ja Show ir iestatīts uz "Sparkline".

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

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

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

Noklusējums: 42A5F5.
Time period 1 sparkline.time_period._reference DASHBOARD._timeperiod - iestatīt Time period atlasītāju kā datu avotu;
ABCDE._timeperiod - iestatīt saderīgu widget (ar tā reference parametru, kas ir vienāds ar ABCDE) kā datu avotu.

Noklusējums: DASHBOARD._timeperiod

Alternatīvi laika periodu var iestatīt tikai parametros From un To.
From 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:
- required ja ir iestatīts sparkline.time_period.to
To 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:
- required ja ir iestatīts sparkline.time_period.from
History data 0 sparkline.history 0 - (noklusējums) Auto;
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ī