[comment]: # ({364afe17-7f83c4c7})
# 6 Wskaźnik
[comment]: # ({/364afe17-7f83c4c7})
[comment]: # ({fc686620-1c93902f})
### Opis
Te parametry oraz możliwe wartości właściwości dla odpowiednich obiektów pól widgetu umożliwiają konfigurację widgetu [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge) w metodach `dashboard.create` i `dashboard.update`.
::: noteimportant
Właściwości `fields` widgetu nie są walidowane podczas tworzenia ani aktualizacji pulpitu.
Pozwala to użytkownikom modyfikować [wbudowane widgety](/manual/web_interface/frontend_sections/dashboards/widgets) i tworzyć [własne widgety](/devel/modules/tutorials/widget), ale jednocześnie wprowadza ryzyko nieprawidłowego tworzenia lub aktualizowania widgetów.
Aby zapewnić pomyślne utworzenie lub zaktualizowanie widgetu *Gauge*, zapoznaj się z zachowaniem parametrów opisanym w poniższych tabelach.
:::
[comment]: # ({/fc686620-1c93902f})
[comment]: # ({a07c7b8d-2e17e0ed})
### Parametry
Następujące parametry są obsługiwane dla widżetu *Gauge*.
|Parametr|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|-----|-|-----|-------------------|
|*Interwał odświeżania*|<|0|rf_rate|0 - Bez odświeżania;
10 - 10 sekund;
30 - 30 sekund;
60 - *(domyślnie)* 1 minuta;
120 - 2 minuty;
600 - 10 minut;
900 - 15 minut.|
|*Pozycja*|<|4|itemid.0|ID [pozycji](/manual/api/reference/item/get).
[Zachowanie parametrów](/manual/api/reference_commentary#parameter-behavior):
- *wymagane*, jeśli *Pozycja (widżet)* nie jest ustawiona|
|<|*Pozycja (widżet)*|1|itemid.\_reference|Zamiast ID [pozycji](/manual/api/reference/item/get):
`ABCDE._itemid` - ustawia [kompatybilny widżet](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (z parametrem *Reference* ustawionym na "`ABCDE`") jako źródło danych dla pozycji.
[Zachowanie parametrów](/manual/api/reference_commentary#parameter-behavior):
- *wymagane*, jeśli *Pozycja* nie jest ustawiona|
|*Min*|<|1|min|Dowolna wartość liczbowa. Obsługiwane są [sufiksy](/manual/appendix/suffixes) (np. "1d", "2w", "4K", "8G").
Domyślnie: "0".|
|*Max*|<|1|max|Dowolna wartość liczbowa. Obsługiwane są [sufiksy](/manual/appendix/suffixes) (np. "1d", "2w", "4K", "8G").
Domyślnie: "100".|
|*Łuk wartości*|<|1|value_arc_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
|*Tło łuku*|<|1|empty_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
|*Tło*|<|1|bg_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
|*Pokaż*|<|0|show.0|1 - Opis;
2 - Wartość;
3 - Wskazówka;
4 - Skala;
5 - Łuk wartości.
Uwaga: Aby skonfigurować wiele wartości, utwórz obiekt pola widżetu pulpitu dla każdej wartości z inkrementowanym numerem w nazwie właściwości.
Domyślnie: 1, 2, 4, 5.
Wartości „Wskazówka” i „Skala” nie są obsługiwane, jeśli jednocześnie:
- nie ustawiono obiektu pola widżetu pulpitu dla *Pokaż* z wartością „Łuk wartości”;
- parametr [konfiguracji zaawansowanej](#advanced-configuration) *Pokaż łuk* jest ustawiony na „Wyłączone”.
Parametry [konfiguracji zaawansowanej](#advanced-configuration) dla opcji *Pokaż* nie są obsługiwane, jeśli nie ustawiono obiektów pól widżetu pulpitu z odpowiednimi wartościami.|
|*Nadpisz host*|<|1|override_hostid.\_reference|`ABCDE._hostid` - ustawia [kompatybilny widżet](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (z parametrem *Reference* ustawionym na "`ABCDE`") jako źródło danych dla hostów;
`DASHBOARD._hostid` - ustawia [selektor hosta](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) pulpitu jako źródło danych dla hostów.
Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na [pulpicie szablonu](/manual/api/reference/templatedashboard/object).|
[comment]: # ({/a07c7b8d-2e17e0ed})
[comment]: # ({7886dec5-1db7caf7})
#### Konfiguracja zaawansowana
Poniższe zaawansowane parametry konfiguracji są obsługiwane przez widżet *Gauge*.
::: noteclassic
Liczba w nazwie właściwości *Thresholds* (np. thresholds.0.color) odnosi się do miejsca progu na liście posortowanej rosnąco.
Jeśli jednak progi zostaną skonfigurowane w innej kolejności, wartości zostaną posortowane rosnąco po zaktualizowaniu konfiguracji widżetu w frontendzie Zabbix
(np. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`).
:::
|Parametr|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Kąt*|0|angle|Możliwe wartości: 180 *(domyślnie)* lub 270.|
|***Opis***|<|<|<|
|*Opis*|1|description|Dowolna wartość tekstowa, w tym makra.
Obsługiwane makra: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, makra użytkownika.
Domyślnie: {ITEM.NAME}.|
|*Rozmiar*|0|desc_size|Możliwe wartości z zakresu 1-100.
Domyślnie: 15.|
|*Pozycja pionowa*|0|desc_v_pos|0 - Góra;
1 - *(domyślnie)* Dół.|
|*Pogrubienie*|0|desc_bold|0 - *(domyślnie)* Wyłączone;
1 - Włączone.|
|*Kolor*|1|desc_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
|***Wartość***|<|<|<|
|*Miejsca dziesiętne*|0|decimal_places|Możliwe wartości z zakresu 1-10.
Domyślnie: 2.|
|*Rozmiar*|0|value_size|Możliwe wartości z zakresu 1-100.
Domyślnie: 25.|
|*Pogrubienie*|0|value_bold|0 - *(domyślnie)* Wyłączone;
1 - Włączone.|
|*Kolor*|1|value_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
|***Jednostki***|<|<|<|
|*Jednostki* (pole wyboru)|0|units_show|0 - Wyłączone;
1 - *(domyślnie)* Włączone.|
|*Jednostki* (wartość)|1|units|Dowolna wartość tekstowa.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Jednostki* (pole wyboru) jest ustawione na "Włączone"|
|*Rozmiar*|0|units_size|Możliwe wartości z zakresu 1-100.
Domyślnie: 25.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Jednostki* (pole wyboru) jest ustawione na "Włączone"|
|*Pogrubienie*|0|units_bold|0 - *(domyślnie)* Wyłączone;
1 - Włączone.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Jednostki* (pole wyboru) jest ustawione na "Włączone"|
|*Pozycja*|0|units_pos|0 - Przed wartością;
1 - Nad wartością;
2 - *(domyślnie)* Za wartością;
3 - Pod wartością.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Jednostki* (pole wyboru) jest ustawione na "Włączone"
Ten parametr jest ignorowany, jeśli jest ustawiony na jedną z następujących [jednostek związanych z czasem](/manual/config/items/item#configuration): unixtime, uptime, s.|
|*Kolor*|1|units_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
|***Łuk wartości***|<|<|<|
|*Rozmiar łuku*|0|value_arc_size|Możliwe wartości z zakresu 1-100.
Domyślnie: 20.|
|***Wskazówka***|<|<|<|
|*Kolor*|1|needle_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli ustawiono obiekt pola widżetu pulpitu dla *Pokaż* z wartością "Value arc" lub *Pokaż łuk* jest ustawione na "Włączone"|
|***Skala***|<|<|<|
|*Pokaż jednostki*|0|scale_show_units|0 - Wyłączone;
1 - *(domyślnie)* Włączone.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Jednostki* (pole wyboru) jest ustawione na "Włączone" oraz ustawiono obiekt pola widżetu pulpitu dla *Pokaż* z wartością "Value arc" lub *Pokaż łuk* jest ustawione na "Włączone"|
|*Rozmiar*|0|scale_size|Możliwe wartości z zakresu 1-100.
Domyślnie: 15.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli ustawiono obiekt pola widżetu pulpitu dla *Pokaż* z wartością "Value arc" lub *Pokaż łuk* jest ustawione na "Włączone"|
|*Miejsca dziesiętne*|0|scale_decimal_places|Możliwe wartości z zakresu 1-10.
Domyślnie: 0.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli ustawiono obiekt pola widżetu pulpitu dla *Pokaż* z wartością "Value arc" lub *Pokaż łuk* jest ustawione na "Włączone"|
|***Progi***|<|<|<|
|*Kolor*|1|thresholds.0.color|Szesnastkowy kod koloru (np. `FF0000`).|
|*Próg*|1|thresholds.0.threshold|Dowolna wartość liczbowa. Obsługiwane są [sufiksy](/manual/appendix/suffixes) (np. "1d", "2w", "4K", "8G").|
|*Pokaż etykiety*|0|th_show_labels|0 - *(domyślnie)* Wyłączone;
1 - Włączone.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Progi* są ustawione oraz ustawiono obiekt pola widżetu pulpitu dla *Pokaż* z wartością "Value arc" lub *Pokaż łuk* jest ustawione na "Włączone"|
|*Pokaż łuk*|0|th_show_arc|0 - *(domyślnie)* Wyłączone;
1 - Włączone.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Progi* są ustawione|
|*Rozmiar łuku*|0|th_arc_size|Możliwe wartości z zakresu 1-100.
Domyślnie: 5.
[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):
- *obsługiwane*, jeśli *Pokaż łuk* jest ustawione na "Włączone"|
[comment]: # ({/7886dec5-1db7caf7})
[comment]: # ({abd47a5b-f2849ab5})
### Przykłady
Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widżetu pulpitu dla widżetu *Gauge*.
Więcej informacji na temat konfiguracji pulpitu można znaleźć w [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/abd47a5b-f2849ab5})
[comment]: # ({17a49bae-f3687306})
#### Konfigurowanie widżetu *Gauge*
Skonfiguruj widżet *Gauge*, który wyświetla wartość pozycji dla pozycji „44474” (Interface enp0s3: Bits sent).
Dodatkowo dostrój wizualnie widżet za pomocą wielu zaawansowanych opcji, w tym progów.
[Żądanie](/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
}
```
Odpowiedź:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/17a49bae-f3687306})
[comment]: # ({e9d30322-ced660a5})
### Zobacz także
- [Pole widżetu pulpitu](/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})