Šajā lapā
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._timeperiodAlternatī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 papildu 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, 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 tālāk norādītie 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
Ja Rādīt ir iestatīts uz “Laiks”, tiek atbalstīti tālāk norādītie papildu konfigurācijas parametri.
| 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 Show ir iestatīts uz “Sparkline”, tiek atbalstīti tālāk norādītie papildu konfigurācijas parametri.
| Parametrs | type | name | value | |
|---|---|---|---|---|
| Width | 0 | sparkline.width | Iespējamās vērtības ir no 0 līdz 10. Noklusējums: 1. |
|
| Fill | 0 | sparkline.fill | Iespējamās vērtības ir 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 logrīku (ar reference parametru, kas ir vienāds ar ABCDE) kā datu avotu.Noklusējums: DASHBOARD._timeperiodVarat arī iestatīt laika periodu 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: - obligāts, 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: - obligāts, ja ir iestatīts sparkline.time_period.from |
|
| History data | 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.
{
"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
}