Documentation
Table of Contents
8 Wykres
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 w metodach dashboard.create i dashboard.update.
Właściwości widżetu fields nie są walidowane podczas tworzenia lub aktualizacji pulpitu. Pozwala to użytkownikom modyfikować wbudowane widżety i tworzyć niestandardowe widżety, 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.
Parametry
Poniższe parametry są obsługiwane dla widżetu Wykres.
| Parametr | typ | 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. |
Zbiór danych
Poniższe parametry są obsługiwane podczas konfigurowania Zbioru danych.
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 | nazwa | wartość |
|---|---|---|---|
| Wzorzec hosta (wymagane) |
1 | ds.hosts.0.0 | Host nazwa lub wzorzec (np. Zabbix*). |
| Wzorzec pozycji (wymagane) |
1 | ds.items.0.0 | Nazwa Pozycji 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. 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. 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". |
Opcje wyświetlania
Poniższe parametry są obsługiwane do konfiguracji Opcji wyświetlania.
| Parametr | typ | nazwa | wartość |
|---|---|---|---|
| Wybór danych historycznych | 0 | source | 0 - (domyślne) Auto; 1 - Historia; 2 - Trendy. |
Okres czasu
Poniższe parametry są obsługiwane do konfiguracji Okresu czasu.
| Parametr | typ | 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 ( 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 ( now, now/d, now/w-1w, itp.) są również obsługiwane.Domyślnie: now. |
Osie
Poniższe parametry są obsługiwane do konfiguracji Osi.
| Parametr | typ | 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. |
Legenda
Poniższe parametry są obsługiwane do konfiguracji Legendy.
| Parametr | typ | 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. |
Problemy
Poniższe parametry są obsługiwane do konfiguracji Problemów.
| Parametr | typ | 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. 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 (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. |
|
Nadpisania
Poniższe parametry są obsługiwane do konfiguracji Nadpisania.
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 | 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. Dozwolone są wartości ujemne. |
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.
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:
{
"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ź: