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
Tālāk norādītie papildu konfigurācijas parametri ir atbalstīti Gauge logrīkam.
Skaitlis Thresholds īpašuma nosaukumā (piem., 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ā, vērtības pēc logrīka konfigurācijas atjaunināšanas Zabbix lietotāja saskarne 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 |
|---|---|---|---|
| Angle | 0 | angle | Iespējamās vērtības: 180 (noklusējums) vai 270. |
| Description | |||
| Description | 1 | description | Jebkura virknes vērtība, tostarp makrosi. Atbalstītie makrosi: {HOST.*}, {ITEM.*}, {INVENTORY.*}, lietotāja makrosi.Noklusējums: {ITEM.NAME}. |
| Size | 0 | desc_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 15. |
| Vertical position | 0 | desc_v_pos | 0 - Augšā; 1 - (noklusējums) Apakšā. |
| Bold | 0 | desc_bold | 0 - (noklusējums) Atspējots; 1 - Iespējots. |
| Color | 1 | desc_color | Heksadecimāls krāsas kods (piem., FF0000).Noklusējums: "" (tukšs). |
| Value | |||
| Decimal places | 0 | decimal_places | Iespējamās vērtības diapazonā no 1 līdz 10. Noklusējums: 2. |
| Size | 0 | value_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 25. |
| Bold | 0 | value_bold | 0 - (noklusējums) Atspējots; 1 - Iespējots. |
| Color | 1 | value_color | Heksadecimāls krāsas kods (piem., FF0000).Noklusējums: "" (tukšs). |
| Units | |||
| Units (checkbox) | 0 | units_show | 0 - Atspējots; 1 - (noklusējums) Iespējots. |
| Units (value) | 1 | units | Jebkura virknes vērtība. Parameter behavior: - supported if Units (checkbox) is set to "Enabled" |
| Size | 0 | units_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 25. Parameter behavior: - supported if Units (checkbox) is set to "Enabled" |
| Bold | 0 | units_bold | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parameter behavior: - supported if Units (checkbox) is set to "Enabled" |
| Position | 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. Parameter behavior: - supported if Units (checkbox) is set to "Enabled" This parameter is ignored if set to one of the following time-related units: unixtime, uptime, s. |
| Color | 1 | units_color | Heksadecimāls krāsas kods (piem., FF0000).Noklusējums: "" (tukšs). |
| Value arc | |||
| Arc size | 0 | value_arc_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 20. |
| Needle | |||
| Color | 1 | needle_color | Heksadecimāls krāsas kods (piem., FF0000).Noklusējums: "" (tukšs).Parameter behavior: - supported if a dashboard widget field object for Show with the value "Value arc" is set, or Show arc is set to "Enabled" |
| Scale | |||
| Show units | 0 | scale_show_units | 0 - Atspējots; 1 - (noklusējums) Iespējots. Parameter behavior: - supported if Units (checkbox) is set to "Enabled" and either a dashboard widget field object for Show with the value "Value arc" is set, or Show arc is set to "Enabled" |
| Size | 0 | scale_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 15. Parameter behavior: - supported if a dashboard widget field object for Show with the value "Value arc" is set, or Show arc is set to "Enabled" |
| Decimal places | 0 | scale_decimal_places | Iespējamās vērtības diapazonā no 1 līdz 10. Noklusējums: 0. Parameter behavior: - supported if a dashboard widget field object for Show with the value "Value arc" is set, or Show arc is set to "Enabled" |
| Thresholds | |||
| Color | 1 | thresholds.0.color | Heksadecimāls krāsas kods (piem., FF0000). |
| Threshold | 1 | thresholds.0.threshold | Jebkura skaitliska vērtība. Tiek atbalstīti piedēkļi (piem., "1d", "2w", "4K", "8G"). |
| Show labels | 0 | th_show_labels | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parameter behavior: - supported if Thresholds are set and either a dashboard widget field object for Show with the value "Value arc" is set or Show arc is set to "Enabled" |
| Show arc | 0 | th_show_arc | 0 - (noklusējums) Atspējots; 1 - Iespējots. Parameter behavior: - supported if Thresholds are set |
| Arc size | 0 | th_arc_size | Iespējamās vērtības diapazonā no 1 līdz 100. Noklusējums: 5. Parameter behavior: - supported if Show arc is set to "Enabled" |
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
}