25 Wykres punktowy

Opis

Te parametry oraz możliwe wartości właściwości dla odpowiednich obiektów pól widgetu umożliwiają skonfigurowanie widgetu Scatter plot w metodach dashboard.create i dashboard.update.

Właściwości fields widgetu nie są walidowane podczas tworzenia ani aktualizacji dashboardu. Pozwala to użytkownikom modyfikować wbudowane widgety oraz tworzyć własne widgety, ale jednocześnie wprowadza ryzyko nieprawidłowego tworzenia lub aktualizowania widgetów. Aby zapewnić pomyślne utworzenie lub zaktualizowanie widgetu Scatter plot, zapoznaj się z zachowaniem parametrów opisanym w poniższych tabelach.

Parametry

Następujące parametry są obsługiwane dla widżetu Scatter plot.

Parametr type 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.
Odwołanie 1 reference Dowolna wartość tekstowa składająca się z 5 znaków (np. ABCDE lub JBPNL). Ta wartość musi być unikalna w obrębie dashboardu, do którego należy widżet.

Zachowanie parametru:
- wymagane

Zestaw danych

Następujące parametry są obsługiwane przy konfigurowaniu Zestawu danych.

Pierwsza liczba w nazwie właściwości (np. ds.0.hosts.0, ds.0.items.0) oznacza konkretny zestaw danych, natomiast druga liczba, jeśli występuje, oznacza skonfigurowany host lub pozycję.

Parametr < type name value
Typ zestawu danych < 0 ds.0.dataset_type 0 - Lista pozycji;
1 - (domyślnie) Wzorce pozycji.
Zestaw danych: Lista pozycji < < <
Kolor < 1 ds.0.color.0 Szesnastkowy kod koloru (np. FF0000).

Zachowanie parametru:
- wymagany, jeśli Typ zestawu danych jest ustawiony na "Lista pozycji"
Oś X < 4 ds.0.x_axis_itemids.0 ID pozycji.

Podczas konfigurowania widżetu na pulpicie szablonu należy ustawić tylko pozycje skonfigurowane w szablonie.

Uwaga: Aby skonfigurować wiele pozycji, utwórz obiekt pola widżetu pulpitu dla każdej pozycji z inkrementowanym numerem w nazwie właściwości.

Zachowanie parametru:
- wymagany, jeśli Typ zestawu danych jest ustawiony na "Lista pozycji", a Oś X (Widżet) nie jest ustawiona
Oś X (Widżet) < 1 ds.0.x_axis_itemids.0._reference Zamiast ID pozycji:
ABCDE._itemid - ustaw kompatybilny widżet (z parametrem Reference ustawionym na "ABCDE") jako źródło danych dla pozycji.

Uwaga: Aby skonfigurować wiele widżetów, utwórz obiekt pola widżetu pulpitu dla każdego widżetu z inkrementowanym numerem w nazwie właściwości.

Zachowanie parametru:
- wymagany, jeśli Typ zestawu danych jest ustawiony na "Lista pozycji", a Oś X nie jest ustawiona
Oś Y < 4 ds.0.y_axis_itemids.0 ID pozycji.

Podczas konfigurowania widżetu na pulpicie szablonu należy ustawić tylko pozycje skonfigurowane w szablonie.

Uwaga: Aby skonfigurować wiele pozycji, utwórz obiekt pola widżetu pulpitu dla każdej pozycji z inkrementowanym numerem w nazwie właściwości.

Zachowanie parametru:
- wymagany, jeśli Typ zestawu danych jest ustawiony na "Lista pozycji", a Oś Y (Widżet) nie jest ustawiona
Oś Y (Widżet) < 1 ds.0.y_axis_itemids.0._reference Zamiast ID pozycji:
ABCDE._itemid - ustaw kompatybilny widżet (z parametrem Reference ustawionym na "ABCDE") jako źródło danych dla pozycji.

Uwaga: Aby skonfigurować wiele widżetów, utwórz obiekt pola widżetu pulpitu dla każdego widżetu z inkrementowanym numerem w nazwie właściwości.

Zachowanie parametru:
- wymagany, jeśli Typ zestawu danych jest ustawiony na "Lista pozycji", a Oś Y nie jest ustawiona
Nadpisz host < 1 ds.0.override_hostid._reference ABCDE._hostid- ustaw kompatybilny widżet (z parametrem "Reference" ustawionym na "ABCDE") jako źródło danych dla hostów;
DASHBOARD._hostid - ustaw selektor hosta pulpitu jako źródło danych dla hostów.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
Zestaw danych: Wzorce pozycji < < <
Kolor < 1 ds.0.color Szesnastkowy kod koloru (np. FF0000).

Zachowanie parametru:
- obsługiwany, jeśli Typ zestawu danych jest ustawiony na "Wzorce pozycji", a Paleta kolorów nie jest ustawiona
Paleta kolorów < 0 ds.0.color_palette Indeks palety kolorów.

Możliwy zakres wartości: 0-11.

Domyślnie: 0.

Zachowanie parametru:
- obsługiwany, jeśli Typ zestawu danych jest ustawiony na "Wzorce pozycji", a Kolor nie jest ustawiony
Wzorce hostów < 1 ds.0.hosts.0 Nazwa lub wzorzec hosta (np. "Zabbix*").

Zachowanie parametru:
- wymagany, jeśli Typ zestawu danych jest ustawiony na "Wzorce pozycji"

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
Wzorce pozycji osi X < 1 ds.0.x_axis_items.0 Nazwa lub wzorzec pozycji (np. "*: Number of processed *values per second").

Podczas konfigurowania widżetu na pulpicie szablonu należy ustawić tylko wzorce dla pozycji skonfigurowanych w szablonie.

Zachowanie parametru:
- wymagany, jeśli Typ zestawu danych jest ustawiony na "Wzorce pozycji"
Wzorce pozycji osi Y < 1 ds.0.y_axis_items.0 Nazwa lub wzorzec pozycji (np. "*: Number of processed *values per second").

Podczas konfigurowania widżetu na pulpicie szablonu należy ustawić tylko wzorce dla pozycji skonfigurowanych w szablonie.

Zachowanie parametru:
- wymagany, jeśli Typ zestawu danych jest ustawiony na "Wzorce pozycji"
Grupy hostów < 2 groupids.0 ID grupy hostów.

Uwaga: Aby skonfigurować wiele grup hostów, utwórz obiekt pola widżetu pulpitu dla każdej grupy hostów z inkrementowanym numerem w nazwie właściwości.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
Grupy hostów (Widżet) < 1 groupids._reference Zamiast ID grupy hostów:
ABCDE._hostgroupids - ustaw kompatybilny widżet (z parametrem Reference ustawionym na "ABCDE") jako źródło danych dla grup hostów.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
Nadpisz host < 1 ds.0.override_hostid._reference ABCDE._hostid- ustaw kompatybilny widżet (z parametrem "Reference" ustawionym na "ABCDE") jako źródło danych dla hostów;
DASHBOARD._hostid - ustaw selektor hosta pulpitu jako źródło danych dla hostów.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
Tagi hosta < < < <
< Typ oceny 0 evaltype_host 0 - (domyślnie) And/Or;
2 - Or.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
^ Nazwa tagu 1 host_tags.0.tag Dowolna wartość tekstowa.

Uwaga: Liczba w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany przy konfigurowaniu Tagów hosta

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
^ Operator 0 host_tags.0.operator 0 - Zawiera;
1 - Równa się;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.

Uwaga: Liczba w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany przy konfigurowaniu Tagów hosta

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
^ Wartość tagu 1 host_tags.0.value Dowolna wartość tekstowa.

Uwaga: Liczba w nazwie właściwości odnosi się do kolejności tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany przy konfigurowaniu Tagów hosta

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
Znacznik < 0 ds.0.marker 0 - (domyślnie) Elipsa;
1 - Kwadrat;
2 - Trójkąt;
3 - Romb;
4 - Gwiazda;
5 - Krzyżyk.
Rozmiar znacznika < 0 ds.0.marker_size 0 - (domyślnie) Mały (6px);
1 - Średni (9px);
2 - Duży (15px).
Przesunięcie czasu < 1 ds.0.timeshift Prawidłowy ciąg czasu (np. 3600, 1h itd.).
Możesz używać sufiksów czasu. Dozwolone są również wartości ujemne.

Domyślnie: "" (puste).
Interwał agregacji < 1 ds.0.aggregate_interval Prawidłowy ciąg czasu (np. 3600, 1h itd.).
Możesz używać sufiksów czasu.

Domyślnie: 15m.
Funkcja agregacji < 0 ds.0.aggregate_function 0 - nieużywane;
1 - min;
2 - max;
3 - (domyślnie) avg;
4 - count;
5 - sum;
6 - first;
7 - last.

Opcje wyświetlania

Następujące parametry są obsługiwane przy konfigurowaniu Opcji wyświetlania.

Parametr type name value
Wybór danych historycznych 0 source 0 - (domyślnie) Auto;
1 - Historia;
2 - Trendy.
Nazwy hostów na etykietach 0 show_hostnames 0 - (domyślnie) Auto;
1 - Pokaż;
2 - Ukryj.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na dashboardzie szablonu.

Okres czasu

Następujące parametry są obsługiwane przy konfigurowaniu Okresu czasu.

Parametr type name value
Okres czasu 1 time_period._reference DASHBOARD._timeperiod — ustaw selektor okresu czasu pulpitu jako źródło danych;
ABCDE._timeperiod — ustaw kompatybilny widget (z parametrem Reference ustawionym na "ABCDE") jako źródło danych.

Domyślnie: DASHBOARD._timeperiod

Alternatywnie można ustawić okres czasu tylko w parametrach Od i Do.
Od 1 time_period.from Prawidłowy ciąg czasu w składni bezwzględnej (YYYY-MM-DD hh:mm:ss) lub względnej (now, now/d, now/w-1w itd.).

Zachowanie parametru:
- obsługiwany, jeśli Okres czasu nie jest ustawiony
- wymagany, jeśli ustawiono time_period.to
Do 1 time_period.to Prawidłowy ciąg czasu w składni bezwzględnej (YYYY-MM-DD hh:mm:ss) lub względnej (now, now/d, now/w-1w itd.).

Zachowanie parametru:
- obsługiwany, jeśli Okres czasu nie jest ustawiony
- wymagany, jeśli ustawiono time_period.from

Osie

Następujące parametry są obsługiwane do konfiguracji Osi.

Parametr type name value
Oś X 0 x_axis 0 - Wyłączona;
1 - (domyślnie) Włączona.
Oś Y 0 y_axis 0 - (domyślnie) Wyłączona;
1 - Włączona.
Min 1 x_axis_min Dowolna wartość liczbowa.

Domyślnie: "" (puste).
y_axis_min
Max 1 x_axis_max Dowolna wartość liczbowa.

Domyślnie: "" (puste).
y_axis_max
Jednostki (typ) 0 x_axis_units 0 - (domyślnie) Automatycznie;
1 - Statyczne.
y_axis_units
Jednostki (wartość) 1 x_axis_static_units Dowolna wartość tekstowa.

Domyślnie: "" (puste).
y_axis_static_units

Legenda

Następujące parametry są obsługiwane przy konfigurowaniu Legendy.

Parametr type name value
Pokaż legendę 0 legend 0 - Wyłączone;
1 - (domyślnie) Włączone.
Pokaż funkcję agregacji 0 legend_aggregation 0 - (domyślnie) Wyłączone;
1 - Włączone.

Zachowanie parametru:
- obsługiwane, jeśli Pokaż legendę jest ustawione na „Włączone”
Wiersze 0 legend_lines_mode 0 - (domyślnie) Stałe;
1 - Zmienne.

Zachowanie parametru:
- obsługiwane, jeśli Pokaż legendę jest ustawione na „Włączone”
Liczba wierszy/
Maksymalna liczba wierszy
0 legend_lines Możliwe wartości z zakresu: 1-10.

Domyślnie: 1.

Zachowanie parametru:
- obsługiwane, jeśli Pokaż legendę jest ustawione na „Włączone”
Liczba kolumn 0 legend_columns Możliwe wartości z zakresu: 1-4.

Domyślnie: 4.

Zachowanie parametru:
- obsługiwane, jeśli Pokaż legendę jest ustawione na „Włączone”

Progi

Następujące parametry są obsługiwane do konfigurowania Progów.

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 są 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 name value
Interpolacja kolorów 0 interpolation 0 - (domyślnie) Wyłączona;
1 - Włączona.
Kolor 1 thresholds.0.color Szesnastkowy kod koloru (np. FF0000).
Oś X 1 thresholds.0.x_axis_threshold Dowolna wartość liczbowa. Obsługiwane są sufiksy (np. "1d", "2w", "4K", "8G").
Oś Y 1 thresholds.0.y_axis_threshold Dowolna wartość liczbowa. Obsługiwane są sufiksy (np. "1d", "2w", "4K", "8G").

Przykłady

Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widgetu pulpitu dla widgetu Scatter plot. Więcej informacji na temat konfiguracji pulpitu można znaleźć w dashboard.create.

Konfigurowanie widżetu Scatter plot

Skonfiguruj widżet Scatter plot w następujący sposób:

  • 5 zestawów danych typu „Wzorce pozycji”, każdy z domyślną agregacją (avg, 15m) i różnymi znacznikami.
  • Legenda wyświetla skonfigurowane pozycje w jednym wierszu i dwóch kolumnach.
  • Progi są skonfigurowane tak, aby kolor znacznika zmieniał się na czerwony, gdy jego wartość osiągnie 80 na dowolnej osi.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "scatterplot",
                        "name": "Scatter plot",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 1,
                                "name": "ds.0.color",
                                "value": "0C5A87"
                            },
                            {
                                "type": 1,
                                "name": "ds.0.hosts.0",
                                "value": "de-frankfurt*"
                            },
                            {
                                "type": 1,
                                "name": "ds.0.x_axis_items.0",
                                "value": "Memory utilization"
                            },
                            {
                                "type": 1,
                                "name": "ds.0.y_axis_items.0",
                                "value": "CPU utilization"
                            },
                            {
                                "type": 0,
                                "name": "ds.0.marker",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.0.marker_size",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.1.color",
                                "value": "66B0D9"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.hosts.0",
                                "value": "fr-paris*"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.x_axis_items.0",
                                "value": "Memory utilization"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.y_axis_items.0",
                                "value": "CPU utilization"
                            },
                            {
                                "type": 0,
                                "name": "ds.1.marker",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "ds.1.marker_size",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.2.color",
                                "value": "0A466A"
                            },
                            {
                                "type": 1,
                                "name": "ds.2.hosts.0",
                                "value": "lv-riga*"
                            },
                            {
                                "type": 1,
                                "name": "ds.2.x_axis_items.0",
                                "value": "Memory utilization"
                            },
                            {
                                "type": 1,
                                "name": "ds.2.y_axis_items.0",
                                "value": "CPU utilization"
                            },
                            {
                                "type": 0,
                                "name": "ds.2.marker",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "ds.2.marker_size",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.3.color",
                                "value": "3394C3"
                            },
                            {
                                "type": 1,
                                "name": "ds.3.hosts.0",
                                "value": "pl-warsaw*"
                            },
                            {
                                "type": 1,
                                "name": "ds.3.x_axis_items.0",
                                "value": "Memory utilization"
                            },
                            {
                                "type": 1,
                                "name": "ds.3.y_axis_items.0",
                                "value": "CPU utilization"
                            },
                            {
                                "type": 0,
                                "name": "ds.3.marker",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.3.marker_size",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.4.color",
                                "value": "1492C8"
                            },
                            {
                                "type": 1,
                                "name": "ds.4.hosts.0",
                                "value": "se-stockholm*"
                            },
                            {
                                "type": 1,
                                "name": "ds.4.x_axis_items.0",
                                "value": "Memory utilization"
                            },
                            {
                                "type": 1,
                                "name": "ds.4.y_axis_items.0",
                                "value": "CPU utilization"
                            },
                            {
                                "type": 0,
                                "name": "ds.4.marker",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "ds.4.marker_size",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "legend_columns",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "interpolation",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.color",
                                "value": "D40000"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.x_axis_threshold",
                                "value": "80"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.0.y_axis_threshold",
                                "value": ""
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.color",
                                "value": "D40000"
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.x_axis_threshold",
                                "value": ""
                            },
                            {
                                "type": 1,
                                "name": "thresholds.1.y_axis_threshold",
                                "value": "80"
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "JQISY"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}

Zobacz także