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ī. |
|
Papildu konfigurācija
Gauge logrīkam tiek atbalstīti šādi papildu konfigurācijas parametri.
Skaitlis rekvizīta Thresholds nosaukumā (piemēram, thresholds.0.color) norāda sliekšņa vietu augošā secībā sakārtotā sarakstā.
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, tostarp makrosi. Atbalstītie makrosi: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makrosi.Noklusējums: {ITEM.NAME}. |
| Izmērs | 0 | desc_size | Iespējamās vērtības ir no 1 līdz 100. Noklusējums: 15. |
| Vertikālais novietojums | 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āldaļas | 0 | decimal_places | Iespējamās vērtības ir no 1 līdz 10. Noklusējums: 2. |
| Izmērs | 0 | value_size | Iespējamās vērtības ir 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 ir 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” |
| Novietojums | 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 tam iestatīta kāda no tālāk norādītajā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 ir 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 informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku 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 informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku ir iestatīts uz “Iespējots” |
| Izmērs | 0 | scale_size | Iespējamās vērtības ir no 1 līdz 100. Noklusējums: 15. Parametra darbība: - atbalstīts, ja informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku ir iestatīts uz “Iespējots” |
| Decimāldaļas | 0 | scale_decimal_places | Iespējamās vērtības ir no 1 līdz 10. Noklusējums: 0. Parametra darbība: - atbalstīts, ja informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku 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 ir iestatīti Sliekšņi un informācijas paneļa logrīka lauka objektam Rādīt ir iestatīta vērtība “Vērtības loks” vai Rādīt loku 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 ir iestatīti Sliekšņi |
| Loka izmērs | 0 | th_arc_size | Iespējamās vērtības ir no 1 līdz 100. Noklusējums: 5. Parametra darbība: - atbalstīts, ja Rādīt loku 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
}