9 Graph (classic)

Opis

Te parametry i możliwe wartości właściwości odpowiednich obiektów pól widgetu pulpitu nawigacyjnego umożliwiają skonfigurowanie widgetu Graph (classic) w metodach dashboard.create i dashboard.update.

Właściwości fields widgetu nie są sprawdzane podczas tworzenia ani aktualizowania pulpitu nawigacyjnego. Umożliwia to użytkownikom modyfikowanie wbudowanych widgetów i tworzenie niestandardowych widgetów, ale wiąże się również z ryzykiem nieprawidłowego utworzenia lub zaktualizowania widgetów. Aby zapewnić pomyślne utworzenie lub zaktualizowanie widgetu Graph (classic), należy zapoznać się z opisem działania parametrów przedstawionym w poniższych tabelach.

Parametry

Następujące parametry są obsługiwane dla widżetu Wykres (klasyczny).

Parametr type 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.
Źródło 0 source_type 0 - (domyślnie) Wykres;
1 - Wykres prosty.
Wykres 6 graphid.0 ID wykresu.

Zachowanie parametru:
- wymagany, jeśli Źródło jest ustawione na "Wykres"
Wykres (widżet) 1 graphid._reference Zamiast ID wykresu:
ABCDE._graphid - ustaw kompatybilny widżet (z parametrem Odwołanie ustawionym na "ABCDE") jako źródło danych dla wykresów.

Zachowanie parametru:
- wymagany, jeśli Źródło jest ustawione na "Wykres prosty", a Wykres nie jest ustawiony
Pozycja 4 itemid.0 ID pozycji.

Zachowanie parametru:
- wymagany, jeśli Źródło jest ustawione na "Wykres prosty", a Pozycja (widżet) nie jest ustawiona
Pozycja (widżet) 1 itemid._reference Zamiast ID pozycji:
ABCDE._itemid - ustaw kompatybilny widżet (z parametrem Odwołanie ustawionym na "ABCDE") jako źródło danych dla pozycji.

Zachowanie parametru:
- wymagany, jeśli Źródło jest ustawione na "Wykres prosty", a Pozycja nie jest ustawiona
Okres czasu 1 time_period._reference DASHBOARD._timeperiod - ustaw selektor okresu czasu pulpitu jako źródło danych;
ABCDE._timeperiod - ustaw kompatybilny widżet (z parametrem Odwołanie ustawionym na "ABCDE") jako źródło danych.

Domyślnie: DASHBOARD._timeperiod

Alternatywnie możesz 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
Pokaż legendę 0 show_legend 0 - Wyłączone;
1 - (domyślnie) Włączone.
Nadpisz host 1 override_hostid._reference ABCDE._hostid - ustaw kompatybilny widżet (z parametrem Odwołanie 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.
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 pulpitu, do którego należy widżet.

Zachowanie parametru:
- wymagany

Przykłady

Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widżetu pulpitu dla widżetu Wykres (klasyczny). Aby uzyskać więcej informacji na temat konfigurowania pulpitu nawigacyjnego, zobacz dashboard.create.

Konfigurowanie widżetu Graph (classic)

Skonfiguruj widżet Graph (classic), który wyświetla prosty wykres dla pozycji „42269”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "graph",
                        "name": "Graph (classic)",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "source_type",
                                "value": 1
                            },
                            {
                                "type": 4,
                                "name": "itemid.0",
                                "value": 42269
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "RSTUV"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Odpowiedź:

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

Zobacz także