17 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
Šādi parametri ir atbalstīti Vienuma vērtība logrīkam.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 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. |
|
| Item | 4 | itemid.0 | Vienuma ID. Parametra darbība: - obligāts, ja Vienums (Widget) nav iestatīts |
|
| Vienums (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 Vienums nav iestatīts |
|
| Show | 0 | show.0 | 1 - Apraksts; 2 - Vērtība; 3 - Laiks; 4 - Izmaiņu indikators. Noklusējums: 1, 2, 3, 4 (visi iespējoti). Piezīme: lai konfigurētu vairākas vērtības, izveidojiet dashboard widget field objektu katrai vērtībai ar palielinātu numuru īpašuma 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 dashboard Host atlasītāju kā datu avotu hosts.Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes dashboard. |
|
Papildu konfigurācija
Tālāk norādītie papildu konfigurācijas parametri ir atbalstīti Vienuma vērtība logrīkā.
Skaitlis Sliekšņi īpašuma 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").
| Parameter | type | name | value | |
|---|---|---|---|---|
| Fona krāsa | 1 | bg_color | Hexadecimāls krāsas kods (piem., FF0000).Noklusējums: "" (tukšs). |
|
| Sliekšņi | ||||
| Krāsa | 1 | thresholds.0.color | Hexadecimāls krāsas kods (piem., FF0000). |
|
| Slieksnis | 1 | thresholds.0.threshold | Jebkura virknes vērtība. | |
| Agregēš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 Agregēš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 u.c.).Parametra darbība: - atbalstīts, ja Laika periods nav iestatīts un Agregēš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 u.c.).Parametra darbība: - atbalstīts, ja Laika periods nav iestatīts un Agregēš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). |
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
}