17 Nawigator pozycji

Opis

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

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

Parametry

Poniższe parametry są obsługiwane przez widżet Nawigator pozycji.

Parametr type name value
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.
Grupy hostów 2 groupids.0 Identyfikator grupy hostów.

Uwaga: Aby skonfigurować wiele grup hostów, utwórz obiekt pola widżetu dashboardu dla każdej grupy hostów, zwiększając numer w nazwie właściwości.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na dashboardzie szablonu.
Grupy hostów (widżet) 1 groupids._reference Zamiast identyfikatora grupy hostów:
ABCDE._hostgroupids - ustaw zgodny 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 dashboardzie szablonu.
Hosty 3 hostids.0 Identyfikator hosta.

Uwaga: Aby skonfigurować wiele hostów, utwórz obiekt pola widżetu dashboardu dla każdego hosta, zwiększając numer w nazwie właściwości. W przypadku wielu hostów parametr Grupy hostów musi być całkowicie nieskonfigurowany albo skonfigurowany z co najmniej jedną grupą hostów, do której należą skonfigurowane hosty.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na dashboardzie szablonu.
Hosty (widżet/dashboard) 1 hostids._reference Zamiast identyfikatora hosta:
DASHBOARD.hostid - ustaw selektor hosta dashboardu jako źródło danych dla hostów;
ABCDE._hostid - ustaw zgodny widżet (z parametrem Reference ustawionym na "ABCDE") jako źródło danych dla hostów.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na dashboardzie szablonu.
Tagi hostów
Typ oceny 0 host_tags_evaltype 0 - (domyślnie) And/Or;
2 - Or.

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

Uwaga: Numer w nazwie właściwości wskazuje kolejność tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany podczas konfigurowania Tagów hostów

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na dashboardzie szablonu.
Operator 0 host_tags.0.operator 0 - Zawiera;
1 - Jest równe;
2 - Nie zawiera;
3 - Nie jest równe;
4 - Istnieje;
5 - Nie istnieje.

Uwaga: Numer w nazwie właściwości wskazuje kolejność tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany podczas konfigurowania Tagów hostów

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

Uwaga: Numer w nazwie właściwości wskazuje kolejność tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany podczas konfigurowania Tagów hostów

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na dashboardzie szablonu.
Wzorce pozycji 1 items.0 Nazwa lub wzorzec pozycji.

Uwaga: Aby skonfigurować wiele wzorców pozycji, utwórz obiekt pola widżetu dashboardu dla każdego wzorca pozycji, zwiększając numer w nazwie właściwości.
Tagi pozycji
Typ oceny 0 item_tags_evaltype 0 - (domyślnie) And/Or;
2 - Or.
Nazwa tagu 1 item_tags.0.tag Dowolna wartość tekstowa.

Uwaga: Numer w nazwie właściwości wskazuje kolejność tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany podczas konfigurowania Tagów pozycji
Operator 0 item_tags.0.operator 0 - Zawiera;
1 - Jest równe;
2 - Nie zawiera;
3 - Nie jest równe;
4 - Istnieje;
5 - Nie istnieje.

Uwaga: Numer w nazwie właściwości wskazuje kolejność tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany podczas konfigurowania Tagów pozycji
Wartość tagu 1 item_tags.0.value Dowolna wartość tekstowa.

Uwaga: Numer w nazwie właściwości wskazuje kolejność tagu na liście oceny tagów.

Zachowanie parametru:
- wymagany podczas konfigurowania Tagów pozycji
Stan 0 state -1 - (domyślnie) Wszystkie;
0 - Normalny;
1 - Nieobsługiwane.
Pokaż problemy 0 show_problems 0 - Wszystkie;
1 - (domyślnie) Niewyciszone;
2 - Brak.
Grupuj według
Atrybut 0 group_by.0.attribute 0 - Grupa hostów;
1 - Nazwa hosta;
2 - Wartość tagu hosta;
3 - Wartość tagu pozycji.

Uwaga: Numer w nazwie właściwości wskazuje kolejność atrybutu na liście atrybutów grupowania.

Zachowanie parametru:
- wymagany podczas konfigurowania Grupuj według
Wartość 1 group_by.0.tag_name Dowolna wartość tekstowa.

Uwaga: Numer w nazwie właściwości wskazuje zestaw atrybutów grupowania określony w parametrze Atrybut.

Zachowanie parametru:
- wymagany podczas konfigurowania Grupuj według, gdy parametr Atrybut jest ustawiony na „Wartość tagu hosta” lub „Wartość tagu pozycji”
Limit pozycji 0 show_lines Dozwolone wartości mieszczą się w zakresie od 1 do 9999.

Wartość domyślna: 100.
Reference 1 reference Dowolna wartość tekstowa składająca się z 5 znaków (np. ABCDE lub JBPNL). Ta wartość musi być unikatowa w obrębie dashboardu, 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 Item navigator. Więcej informacji na temat konfiguracji pulpitu można znaleźć w dashboard.create.

Konfigurowanie widżetu Nawigator pozycji

Skonfiguruj widżet Nawigator pozycji, który wyświetla do 1000 pozycji pogrupowanych według ich hosta, a następnie według wartości tagu pozycji „component”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": "30",
        "auto_start": "1",
        "pages": [
            {
                "widgets": [
                    {
                        "type": "itemnavigator",
                        "name": "Item navigator",
                        "x": "0",
                        "y": "0",
                        "width": "12",
                        "height": "5",
                        "view_mode": "0",
                        "fields": [
                            {
                                "type": 0,
                                "name": "group_by.0.attribute",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "group_by.1.attribute",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "group_by.1.tag_name",
                                "value": "component"
                            },
                            {
                                "type": 0,
                                "name": "show_lines",
                                "value": 1000
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "DFNLK"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Odpowiedź:

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

Zobacz także