[comment]: # ({364afe17-7f83c4c7})
# 6 Mērinstruments
[comment]: # ({/364afe17-7f83c4c7})
[comment]: # ({fc686620-1c93902f})
### Apraksts
Šie parametri un iespējamās īpašību vērtības attiecīgajiem paneļa logrīka lauku objektiem ļauj konfigurēt [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge) logrīku `dashboard.create` un `dashboard.update` metodēs.
::: noteimportant
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](/manual/web_interface/frontend_sections/dashboards/widgets) un izveidot [pielāgotus logrīkus](/devel/modules/tutorials/widget), 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.
:::
[comment]: # ({/fc686620-1c93902f})
[comment]: # ({a07c7b8d-2e17e0ed})
### Parametri
Tālāk norādītie parametri tiek atbalstīti *Gauge* logrīkam.
|Parametrs|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|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](/manual/api/reference/item/get) ID.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja *Vienums (logrīks)* nav iestatīts|
|<|*Vienums (logrīks)*|1|itemid.\_reference|[Item](/manual/api/reference/item/get) ID vietā:
`ABCDE._itemid` - iestatīt [saderīgu logrīku](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā parametru *Reference*, kas iestatīts uz "`ABCDE`") kā datu avotu vienumiem.
[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):
- *obligāts*, ja *Vienums* nav iestatīts|
|*Min*|<|1|min|Jebkura skaitliska vērtība. Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (piemēram, "1d", "2w", "4K", "8G").
Noklusējums: "0".|
|*Max*|<|1|max|Jebkura skaitliska vērtība. Tiek atbalstīti [sufiksi](/manual/appendix/suffixes) (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](#advanced-configuration) parametrs ir iestatīts uz "Atspējots".
*Rādīt* opciju [paplašinātās konfigurācijas](#advanced-configuration) 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](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (ar tā parametru *Reference*, kas iestatīts uz "`ABCDE`") kā datu avotu hostiem;
`DASHBOARD._hostid` - iestatīt dashboard [hostu atlasītāju](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) kā datu avotu hostiem.
Šis parametrs netiek atbalstīts, ja logrīks tiek konfigurēts [veidnes panelī](/manual/api/reference/templatedashboard/object).|
[comment]: # ({/a07c7b8d-2e17e0ed})
[comment]: # ({7886dec5-1db7caf7})
#### Paplašinātā konfigurācija
Tālāk norādītie paplašinātās konfigurācijas parametri tiek atbalstīti *Gauge* logrīkam.
::: noteclassic
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](/manual/api/reference/dashboard/object#dashboard-widget-field)|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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/config/items/item#configuration): 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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/appendix/suffixes) (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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *atbalstīts*, ja *Show arc* ir iestatīts uz "Iespējots"|
[comment]: # ({/7886dec5-1db7caf7})
[comment]: # ({abd47a5b-f2849ab5})
### 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`](/manual/api/reference/dashboard/create).
[comment]: # ({/abd47a5b-f2849ab5})
[comment]: # ({17a49bae-f3687306})
#### *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.
[Pieprasījums](/manual/api#performing-requests):
```json
{
"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:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/17a49bae-f3687306})
[comment]: # ({e9d30322-ced660a5})
### Skatiet arī
- [Informācijas paneļa logrīka lauks](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-ced660a5})