On this page
6 Mērinstruments
Apraksts
Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt Gauge 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 Gauge logrīka izveidi vai atjaunināšanu, lūdzu, skatiet tālāk esošajās tabulās aprakstīto parametru darbību.
Parametri
Tālāk norādītie parametri tiek atbalstīti Gauge logrīkam.
| 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 | Item ID. Parametra darbība: - obligāts, ja Vienums (logrīks) nav iestatīts |
|
| Vienums (logrīks) | 1 | itemid._reference | Item ID vietā:ABCDE._itemid - iestatīt saderīgu logrīku (ar tā parametru Reference, kas iestatīts uz "ABCDE") kā datu avotu vienumiem.Parametra darbība: - obligāts, ja Vienums nav iestatīts |
|
| Min | 1 | min | Jebkura skaitliska vērtība. Tiek atbalstīti sufiksi (piemēram, "1d", "2w", "4K", "8G"). Noklusējums: "0". |
|
| Max | 1 | max | Jebkura skaitliska vērtība. Tiek atbalstīti sufiksi (piemēram, "1d", "2w", "4K", "8G"). Noklusējums: "100". |
|
| Vērtības loks | 1 | value_arc_color | Heksadecimāls krāsas kods (piemēram, FF0000).Noklusējums: "" (tukšs). |
|
| Loka fons | 1 | empty_color | Heksadecimāls krāsas kods (piemēram, FF0000).Noklusējums: "" (tukšs). |
|
| Fons | 1 | bg_color | Heksadecimāls krāsas kods (piemēram, FF0000).Noklusējums: "" (tukšs). |
|
| Rādīt | 0 | show.0 | 1 - Apraksts; 2 - Vērtība; 3 - Rādītājs; 4 - Skala; 5 - Vērtības loks. Piezīme: Lai konfigurētu vairākas vērtības, izveidojiet dashboard logrīka lauka objektu katrai vērtībai ar palielinātu numuru īpašības nosaukumā. Noklusējums: 1, 2, 4, 5. Vērtības "Rādītājs" un "Skala" netiek atbalstītas, ja ir spēkā abi nosacījumi: - nav iestatīts neviens dashboard logrīka lauka objekts parametram Rādīt ar vērtību "Vērtības loks"; - Rādīt loku paplašinātās konfigurācijas parametrs ir iestatīts uz "Atspējots". Rādīt opciju paplašinātās konfigurācijas parametri netiek atbalstīti, ja nav iestatīti dashboard logrīka lauka objekti ar attiecīgajām vērtībām. |
|
| Aizstāt hostu | 1 | override_hostid._reference | ABCDE._hostid - iestatīt saderīgu logrīku (ar tā parametru Reference, kas iestatīts uz "ABCDE") kā datu avotu hostiem;DASHBOARD._hostid - iestatīt dashboard hostu atlasītāju kā datu avotu hostiem.Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts veidnes panelī. |
|
Paplašinātā konfigurācija
Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti Gauge logrīkam.
Skaitlis Thresholds īpašības 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 |
|---|---|---|---|
| Leņķis | 0 | angle | Iespējamās vērtības: 180 (noklusējums) vai 270. |
| Apraksts | |||
| Apraksts | 1 | description | Jebkura virknes vērtība, ieskaitot makrosus. Atbalstītie makrosi: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makrosi. Noklusējums: {ITEM.NAME}. |
| Izmērs | 0 | desc_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 15. |
| Vertikālā pozīcija | 0 | desc_v_pos | 0 - Augšā; 1 - (noklusējums) Apakšā. |
| 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 | |||
| Decimālvietas | 0 | decimal_places | Iespējamās vērtības diapazonā no 1 līdz 10. Noklusējums: 2. |
| Izmērs | 0 | value_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 25. |
| Treknraksts | 0 | value_bold | 0 - (noklusējums) Atspējots; 1 - 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. Parametra darbība: - atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz "Iespējots" |
| Izmērs | 0 | units_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 25. Parametra darbība: - atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz "Iespējots" |
| Treknraksts | 0 | units_bold | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parametra darbība: - atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz "Iespējots" |
| 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. Parametra darbība: - atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz "Iespējots" Šis parametrs tiek ignorēts, ja tas ir iestatīts uz kādu no šīm ar laiku saistītajām mērvienībām: unixtime, uptime, s. |
| Krāsa | 1 | units_color | Heksadecimāls krāsas kods (piemēram, FF0000).Noklusējums: "" (tukšs). |
| Vērtības loks | |||
| Loka izmērs | 0 | value_arc_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 20. |
| Rādītājs | |||
| Krāsa | 1 | needle_color | Heksadecimāls krāsas kods (piemēram, FF0000).Noklusējums: "" (tukšs).Parametra darbība: - atbalstīts, ja ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc ir iestatīts uz "Iespējots" |
| Skala | |||
| Rādīt mērvienības | 0 | scale_show_units | 0 - Atspējots; 1 - (noklusējums) Iespējots. Parametra darbība: - atbalstīts, ja Mērvienības (izvēles rūtiņa) ir iestatīta uz "Iespējots" un ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc ir iestatīts uz "Iespējots" |
| Izmērs | 0 | scale_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 15. Parametra darbība: - atbalstīts, ja ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc ir iestatīts uz "Iespējots" |
| Decimālvietas | 0 | scale_decimal_places | Iespējamās vērtības diapazonā no 1 līdz 10. Noklusējums: 0. Parametra darbība: - atbalstīts, ja ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc ir iestatīts uz "Iespējots" |
| Sliekšņi | |||
| Krāsa | 1 | thresholds.0.color | Heksadecimāls krāsas kods (piemēram, FF0000). |
| Slieksnis | 1 | thresholds.0.threshold | Jebkura skaitliska vērtība. Tiek atbalstīti sufiksi (piemēram, "1d", "2w", "4K", "8G"). |
| Rādīt etiķetes | 0 | th_show_labels | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parametra darbība: - atbalstīts, ja Sliekšņi ir iestatīti un ir iestatīts paneļa logrīka lauka objekts Show ar vērtību "Value arc" vai Show arc ir iestatīts uz "Iespējots" |
| Rādīt loku | 0 | th_show_arc | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parametra darbība: - atbalstīts, ja Sliekšņi ir iestatīti |
| Loka izmērs | 0 | th_arc_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 5. Parametra darbība: - atbalstīts, ja Show arc ir iestatīts uz "Iespējots" |
Piemēri
Tālāk sniegto piemēru mērķis ir tikai aprakstīt paneļa logrīka lauku objektu konfigurāciju Mērinstrumenta logrīkam.
Plašāku informāciju par paneļa konfigurēšanu skatiet dashboard.create.
Gauge logrīka konfigurēšana
Konfigurējiet Gauge logrīku, kas attēlo vienuma vērtību vienumam "44474" (Saskarne enp0s3: Nosūtītie biti). Papildus vizuāli pielāgojiet logrīku, izmantojot vairākas papildu opcijas, tostarp sliekšņus.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "gauge",
"name": "Gauge",
"x": 0,
"y": 0,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 44474
},
{
"type": 1,
"name": "min",
"value": "100000"
},
{
"type": 1,
"name": "max",
"value": "1000000"
},
{
"type": 0,
"name": "show.0",
"value": 1
},
{
"type": 0,
"name": "show.1",
"value": 2
},
{
"type": 0,
"name": "show.2",
"value": 3
},
{
"type": 0,
"name": "show.4",
"value": 4
},
{
"type": 0,
"name": "show.5",
"value": 5
},
{
"type": 0,
"name": "angle",
"value": 270
},
{
"type": 0,
"name": "desc_size",
"value": 10
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 0,
"name": "decimal_places",
"value": 0
},
{
"type": 0,
"name": "value_bold",
"value": 1
},
{
"type": 0,
"name": "units_size",
"value": 15
},
{
"type": 0,
"name": "units_pos",
"value": 3
},
{
"type": 1,
"name": "needle_color",
"value": "3C3C3C"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "FF465C"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "700000"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "FFD54F"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "500000"
},
{
"type": 1,
"name": "thresholds.2.color",
"value": "0EC9AC"
},
{
"type": 1,
"name": "thresholds.2.threshold",
"value": "100000"
},
{
"type": 0,
"name": "th_show_labels",
"value": 1
},
{
"type": 0,
"name": "th_show_arc",
"value": 1
},
{
"type": 0,
"name": "th_arc_size",
"value": 15
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Atbilde:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}