On this page
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._timeperiodAlternatī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
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). |
Dzirksteļdiagramma
Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti, ja Rādīt ir iestatīts uz "Dzirksteļdiagramma".
| Parametrs | type | name | value | |
|---|---|---|---|---|
| Platums | 0 | sparkline.width | Iespējamās vērtības ir diapazonā no 0 līdz 10. Noklusējums: 1. |
|
| Aizpildījums | 0 | sparkline.fill | Iespējamās vērtības ir diapazonā 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 paneļa laika perioda atlasītāju kā datu avotu;ABCDE._timeperiod — iestatīt saderīgu logrīku (ar tā reference parametru, kas vienāds ar ABCDE) kā datu avotu.Noklusējums: DASHBOARD._timeperiodAlternatīvi, laika periodu var iestatīt 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 utt.).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 utt.).Parametra darbība: - obligāts, ja ir iestatīts sparkline.time_period.from |
|
| Vēstures 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.
{
"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
}