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.
პარამეტრები
Tālāk norādītie parametri ir atbalstīti Gauge 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 |
|
| Min | 1 | min | Jebkura skaitliska vērtība. Tiek atbalstīti piedēkļi (piem., "1d", "2w", "4K", "8G"). Noklusējums: "0". |
|
| Max | 1 | max | Jebkura skaitliska vērtība. Tiek atbalstīti piedēkļi (piem., "1d", "2w", "4K", "8G"). Noklusējums: "100". |
|
| Value arc | 1 | value_arc_color | Heksadecimāls krāsas kods (piem., FF0000).Noklusējums: "" (tukšs). |
|
| Arc background | 1 | empty_color | Heksadecimāls krāsas kods (piem., FF0000).Noklusējums: "" (tukšs). |
|
| Background | 1 | bg_color | Heksadecimāls krāsas kods (piem., FF0000).Noklusējums: "" (tukšs). |
|
| Show | 0 | show.0 | 1 - Apraksts; 2 - Vērtība; 3 - Bulta; 4 - Skala; 5 - Vērtības loks. Piezīme: lai konfigurētu vairākas vērtības, izveidojiet dashboard widget field objektu katrai vērtībai ar pieaugošu numuru īpašuma nosaukumā. Noklusējums: 1, 2, 4, 5. Vērtības "Bulta" un "Skala" netiek atbalstītas, ja abi nosacījumi ir spēkā: - nav iestatīts neviens dashboard widget field objekts Show ar vērtību "Vērtības loks"; - Show arc papildu konfigurācijas parametrs ir iestatīts uz "Disabled". Papildu konfigurācijas parametri Show opcijām netiek atbalstīti, ja nav iestatīti dashboard widget field objekti ar attiecīgajām vērtībām. |
|
| 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, ja logrīks tiek konfigurēts veidnes panelī. |
|
Papildu konfigurācija
Gauge logrīkam tiek atbalstīti tālāk norādītie 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 makro. Atbalstītie makro: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makro. 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ļu skaits | 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 laika 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” |
| Mērogs | |||
| 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ļu skaits | 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
}