[comment]: # ({167707a1-efa63679})
# 8 Wykres
[comment]: # ({/167707a1-efa63679})
[comment]: # ({c2d12536-4bb44173})
### Opis
Te parametry i możliwe wartości właściwości dla odpowiednich obiektów pola widżetu pulpitu pozwalają skonfigurować widżet [*Wykres*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock) w metodach `dashboard.create` i `dashboard.update`.
::: noteimportant
Właściwości widżetu `fields` nie są walidowane podczas tworzenia lub aktualizacji pulpitu.
Pozwala to użytkownikom modyfikować [wbudowane widżety](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i tworzyć [niestandardowe widżety](/manual/modules#developing-modules), ale wprowadza również ryzyko nieprawidłowego tworzenia lub aktualizacji widżetów.
Aby zapewnić pomyślne utworzenie lub aktualizację widżetu *Wykres*, należy odwołać się do wymagań dotyczących parametrów przedstawionych w poniższych tabelach.
:::
[comment]: # ({/c2d12536-4bb44173})
[comment]: # ({86c426f8-153fd258})
### Parametry
Poniższe parametry są obsługiwane dla widżetu *Wykres*.
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|*Interwał odświeżania*|0|rf_rate|0 - Brak odświeżania;
10 - 10 sekund;
30 - 30 sekund;
60 - *(domyślnie)* 1 minuta;
120 - 2 minuty;
600 - 10 minut;
900 - 15 minut.|
[comment]: # ({/86c426f8-153fd258})
[comment]: # ({84088409-7bb6f7c8})
#### Zbiór danych
Poniższe parametry są obsługiwane podczas konfigurowania *Zbioru danych*.
::: noteclassic
Pierwsza liczba w nazwie właściwości (np. ds.hosts.0.0, ds.items.0.0) reprezentuje określony zbiór danych,
podczas gdy druga liczba, jeśli jest obecna, reprezentuje skonfigurowany host lub pozycję.
:::
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|***Wzorzec hosta***
(wymagane)|1|ds.hosts.0.0|[Host](/manual/api/reference/host/get) nazwa lub wzorzec (np. `Zabbix*`).|
|***Wzorzec pozycji***
(wymagane)|1|ds.items.0.0|Nazwa [Pozycji](/manual/api/reference/item/get) lub wzorzec (np. `*: Liczba przetwarzanych *wartości na sekundę`).|
|*Kolor*|1|ds.color.0|Kod koloru szesnastkowego (np. `FF0000`).
Domyślnie: `FF465C`.|
|*Rysuj*|0|ds.type.0|0 - *(domyślne)* Linia;
1 - Punkty;
2 - Schody;
3 - Belka.|
|*Szerokość*|0|ds.width.0|Dopuszczalne wartości w zakresie od 1 do 10.
Domyślnie: 1.
Parametr *Szerokość* jest niedostępny, jeśli *Rysuj* jest ustawiony na "Punkty" lub "Belka".|
|*Rozmiar punktu*|0|ds.pointsize.0|Dopuszczalne wartości w zakresie od 1 do 10.
Domyślnie: 3.
Parametr *Rozmiar punktu* jest niedostępny, jeśli *Rysuj* jest ustawiony na "Linia", "Schody" lub "Belka".|
|*Przezroczystość*|0|ds.transparency.0|Dopuszczalne wartości w zakresie od 1 do 10.
Domyślnie: 5.|
|*Wypełnienie*|0|ds.fill.0|Dopuszczalne wartości w zakresie od 1 do 10.
Domyślnie: 3.
Parametr *Wypełnienie* jest niedostępny, jeśli *Rysuj* jest ustawiony na "Punkty" lub "Belka".|
|*Brakujące dane*|0|ds.missingdatafunc.0|0 - *(domyślne)* Brak;
1 - Połączony;
2 - Traktuj jako 0.
Parametr *Brakujące dane* jest niedostępny, jeśli *Rysuj* jest ustawiony na "Punkty" lub "Belka".|
|*Oś Y*|0|ds.axisy.0|0 - *(domyślne)* Z lewej;
1 - Z prawej.|
|*Przesunięcie czasowe*|1|ds.timeshift.0|Poprawny ciąg czasu (np. `3600`, `1h`, itp.).
Możesz używać [przyrostków czasu](/manual/appendix/suffixes#time-suffixes). Dopuszczalne są także wartości ujemne.
Domyślnie: `""` (puste).|
|*Funkcja agregująca*|0|ds.aggregate_function.0|0 - *(domyślne)* nieużywany (brak);
1 - min;
2 - maks;
3 - śr;
4 - zliczyć;
5 - suma;
6 - pierwszy;
7 - ostatni.|
|*Interwał agregacji*|1|ds.aggregate_interval.0|Poprawny ciąg czasu (np. `3600`, `1h`, itp.).
Możesz używać [przyrostków czasu](/manual/appendix/suffixes#time-suffixes).
Domyślnie: `1h`.|
|*Agregacja*|0|ds.aggregate_grouping.0|0 - *(domyślne)* Każda pozycja;
1 - Zestaw danych.
Parametr *Agregacja* jest niedostępny, jeśli *Funkcja agregacji* jest ustawiona na "nieużywany".|
[comment]: # ({/84088409-7bb6f7c8})
[comment]: # ({54acedd8-065c780b})
#### Opcje wyświetlania
Poniższe parametry są obsługiwane do konfiguracji *Opcji wyświetlania*.
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|*Wybór danych historycznych*|0|source|0 - *(domyślne)* Auto;
1 - Historia;
2 - Trendy.|
[comment]: # ({/54acedd8-065c780b})
[comment]: # ({36354072-3919b8dd})
#### Okres czasu
Poniższe parametry są obsługiwane do konfiguracji *Okresu czasu*.
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|*Ustaw niestandardowy okres czasu*|0|graph_time|0 - *(domyślnie)* Wyłączone;
1 - Włączone.|
|*Od*|1|time_from|Poprawny ciąg czasu w formacie `YYYY-MM-DD hh:mm:ss`.
[Wartości względnego okresu czasu](/manual/config/visualization/graphs/simple#time-period-selector) (`now`, `now/d`, `now/w-1w`, itp.) są również obsługiwane.
Domyślnie: `now-1h`.|
|*Do*|1|time_to|Poprawna wartość ciągu czasu w formacie `YYYY-MM-DD hh:mm:ss`.
[Wartości względne okresu czasu](/manual/config/visualization/graphs/simple#time-period-selector) (`now`, `now/d`, `now/w-1w`, itp.) są również obsługiwane.
Domyślnie: `now`.|
[comment]: # ({/36354072-3919b8dd})
[comment]: # ({a0674fde-5b9b0680})
#### Osie
Poniższe parametry są obsługiwane do konfiguracji *Osi*.
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|*Y z lewej*|0|lefty|0 - Wyłączone;
1 - *(domyślne)* Włączone.
Parametr dostępny, jeśli *Oś Y* (w konfiguracji *Zbioru danych*) jest ustawiona na "z lewej".|
|*Prawa Y*|0|righty|0 - *(domyślne)* Wyłączone;
1 - Włączone.
Parametr dostępny, jeśli *Oś Y* (w konfiguracji *Zbioru danych*) jest ustawiona na "z prawej".|
|*Minimalny*|1|lefty_min|Dowolna wartość numeryczna.
Domyślnie: `""` (puste).|
|^|^|righty_min|^|
|*Maksymalny*|1|lefty_max|Dowolna wartość numeryczna.
Domyślnie: `""` (puste).|
|^|^|righty_max|^|
|*Jednostki* (typ)|0|lefty_units|0 - *(domyślne)* Auto;
1 - Statyczny.|
|^|^|righty_units|^|
|*Jednostki* (wartość)|1|lefty_static_units|Dowolna wartość tekstowa.
Domyślnie: `""` (puste).|
|^|^|righty_static_units|^|
|*Oś X*|0|xaxis|0 - Wyłączone;
1 - *(domyślne)* Włączone.|
[comment]: # ({/a0674fde-5b9b0680})
[comment]: # ({07ca4559-12287620})
#### Legenda
Poniższe parametry są obsługiwane do konfiguracji *Legendy*.
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|*Wyświetl legendę*|0|legend|0 - Wyłączone;
1 - *(domyślne)* Włączone.|
|*Liczba wierszy*|0|legend_lines|Dopuszczalne wartości od 1 do 5.
Domyślnie: 1.|
[comment]: # ({/07ca4559-12287620})
[comment]: # ({64d6609b-e89fa375})
#### Problemy
Poniższe parametry są obsługiwane do konfiguracji *Problemów*.
|Parametr|<|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-|--------|--|--------|-------------------------------|
|*Pokaż problemy*|<|0|show_problems|0 - *(domyślne)* Wyłączone;
1 - Włączone.|
|*Tylko wybrane pozycje*|<|0|graph_item_problems|0 - Wyłączone;
1 - *(domyślne)* Włączone.|
|*Problemy hostów*|<|1|problemhosts.0|Nazwa [hosta](/manual/api/reference/host/get).
Uwaga: Liczba w nazwie właściwości odnosi się do skonfigurowanego hosta.
Aby skonfigurować wiele hostów, utwórz obiekt pola widżetu pulpitu nawigacyjnego dla każdego hosta.|
|*Poziom*|<|0|severities|0 - Nieklasyfikowany;
1 - Informacja;
2 - Ostrzeżenie;
3 - Średni;
4 - Wysoki;
5 - Katastrofa.
puste (wszystkie włączone)
Uwaga: Aby skonfigurować wiele wartości, utwórz obiekt pola widżetu pulpitu nawigacyjnego dla każdej wartości.|
|*Problem*|<|1|problem_name|Nazwa [zdarzenia problemowego](/manual/config/triggers/trigger#configuration) (wielkość liter nie ma znaczenia, pełna nazwa lub jej część).|
|*Znaczniki* (liczba w nazwie właściwości (np. tags.tag.0) odnosi się do kolejności tagów na liście ewaluacji tagów)|<|<|<|<|
|<|*Typ ewaluacji*|0|evaltype|0 - *(domyślne)* I/Lub;
2 - Lub.|
|^|*Nazwa tagu*|1|tags.tag.0|Dowolna wartość ciągu znaków.
Parametr *Nazwa tagu* wymagany jest przy konfigurowaniu *Znaczników*.|
|^|*Operator*|0|tags.operator.0|0 - Zawiera;
1 - Jest równy;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.
Parametr *Operator* wymagany przy konfigurowaniu *Znaczników*.|
|^|*Wartość tagu*|1|tags.value.0|Dowolna wartość ciągu znaków.
Parametr *Wartość tagu* wymagany przy konfigurowaniu *Znaczników*.|
[comment]: # ({/64d6609b-e89fa375})
[comment]: # ({7f3903f6-f2e36a05})
#### Nadpisania
Poniższe parametry są obsługiwane do konfiguracji *Nadpisania*.
::: noteclassic
Pierwsza liczba w nazwie właściwości (np. or.hosts.0.0, or.items.0.0) oznacza konkretny zbiór danych,
natomiast druga liczba, jeśli występuje, oznacza skonfigurowany host lub pozycję.
:::
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|***Wzorzec hosta***
(wymagany)|1|or.hosts.0.0|Nazwa hosta lub wzorzec (np. `Zabbix*`).|
|***Wzorzec pozycji***
(wymagany)|1|or.items.0.0|Nazwa pozycji lub wzorzec (np. `*: Liczba przetworzonych *wartości na sekundę`).|
|*Podstawowy kolor*|1|or.color.0|Szesnastkowy kod koloru (np. `FF0000`).|
|*Szerokość*|0|or.width.0|Dopuszczalne wartości z zakresu od 1 do 10.|
|*Rysuj*|0|or.type.0|0 - Linia;
1 - Punkty;
2 - Schody;
3 - Belki.|
|*Przezroczystość*|0|or.transparency.0|Dopuszczalne wartości z zakresu od 1 do 10.|
|*Wypełnienie*|0|or.fill.0|Dopuszczalne wartości z zakresu od 1 do 10.|
|*Rozmiar punktu*|0|or.pointsize.0|Dopuszczalne wartości z zakresu od 1 do 10.|
|*Brakujące dane*|0|or.missingdatafunc.0|0 - Brak;
1 - Połączono;
2 - Traktuj jako 0.|
|*Oś Y*|0|or.axisy.0|0 - Z lewej;
1 - Z prawej.|
|*Przesunięcie czasu*|1|or.timeshift.0|Dopuszczalny ciąg czasu (np. `3600`, `1h`, itp.).
Możesz użyć [przedrostków czasu](/manual/appendix/suffixes#time-suffixes). Dozwolone są wartości ujemne.|
[comment]: # ({/7f3903f6-f2e36a05})
[comment]: # ({0d773487-0a1ab554})
### Przykłady
Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widżetu pulpitu dla widżetu *Wykres*.
Aby uzyskać więcej informacji na temat konfigurowania pulpitu nawigacyjnego, zobacz [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/0d773487-0a1ab554})
[comment]: # ({f11b369f-6c20191c})
#### Konfiguracja widżetu *Wykres*
Skonfiguruj widżet *Wykres* w następujący sposób:
- 4 zbiory danych dla łącznie 9 pozycji na 1 hoście.
- Każdy zbiór danych składa się z linii, która ma niestandardowy kolor, szerokość, przezroczystość i wypełnienie.
- Zestaw danych nr 4 ma skonfigurowane agregowanie.
- Dane na wykresie są wyświetlane przez ostatnie 3 godziny.
- Problemy na wykresie są wyświetlane tylko dla skonfigurowanych pozycji.
- Wykres ma dwie osie Y, z których prawa oś Y wyświetla wartości tylko dla zestawu danych nr 4.
- Legenda wykresu wyświetla skonfigurowane pozycje w 2 wierszach.
Zapytanie:
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "svggraph",
"name": "Graph",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "ds.hosts.0.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.0.0",
"value": "Zabbix server: Utilization of poller data collector processes, in %"
},
{
"type": 1,
"name": "ds.color.0",
"value": "FF0000"
},
{
"type": 0,
"name": "ds.width.0",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.0",
"value": 3
},
{
"type": 0,
"name": "ds.fill.0",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.1.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.1.0",
"value": "Zabbix server: Utilization of trapper data collector processes, in %"
},
{
"type": 1,
"name": "ds.color.1",
"value": "BF00FF"
},
{
"type": 0,
"name": "ds.width.1",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.1",
"value": 3
},
{
"type": 0,
"name": "ds.fill.1",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.2.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.2.0",
"value": "Zabbix server: Utilization of history syncer internal processes, in %"
},
{
"type": 1,
"name": "ds.color.2",
"value": "0040FF"
},
{
"type": 0,
"name": "ds.width.2",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.2",
"value": 3
},
{
"type": 0,
"name": "ds.fill.2",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.3.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.3.0",
"value": "*: Number of processed *values per second"
},
{
"type": 1,
"name": "ds.color.3",
"value": "000000"
},
{
"type": 0,
"name": "ds.transparency.3",
"value": 0
},
{
"type": 0,
"name": "ds.fill.3",
"value": 0
},
{
"type": 0,
"name": "ds.axisy.3",
"value": 1
},
{
"type": 0,
"name": "ds.aggregate_function.3",
"value": 3
},
{
"type": 1,
"name": "ds.aggregate_interval.3",
"value": "1m"
},
{
"type": 0,
"name": "ds.aggregate_grouping.3",
"value": 1
},
{
"type": 0,
"name": "graph_time",
"value": 1
},
{
"type": 1,
"name": "time_from",
"value": "now-3h"
},
{
"type": 0,
"name": "legend_lines",
"value": 2
},
{
"type": 0,
"name": "show_problems",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Odpowiedź:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/f11b369f-6c20191c})
[comment]: # ({e9d30322-1a6bfc6f})
### 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-1a6bfc6f})