13 Karta hosta

Opis

Te parametry oraz możliwe wartości właściwości dla odpowiednich obiektów pól widgetu umożliwiają skonfigurowanie widgetu Karta hosta 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 wprowadza również ryzyko nieprawidłowego tworzenia lub aktualizowania widgetów. Aby zapewnić pomyślne utworzenie lub zaktualizowanie widgetu Karta hosta, zapoznaj się z zachowaniem parametrów opisanym w poniższych tabelach.

Parametry

Następujące parametry są obsługiwane dla widżetu Karta hosta.

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.
Host 3 hostid.0 ID hosta.

Zachowanie parametrów:
- wymagane, jeśli Host (Widżet/Pulpit) nie jest ustawiony

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
Host (Widżet/Pulpit) 1 hostid._reference Zamiast ID hosta:
DASHBOARD.hostid - ustaw selektor hosta pulpitu jako źródło danych dla hosta;
ABCDE._hostid - ustaw kompatybilny widżet (z parametrem Reference ustawionym na "ABCDE") jako źródło danych dla hosta.

Zachowanie parametrów:
- wymagane, jeśli Host nie jest ustawiony

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na pulpicie szablonu.
Pokaż ukryte problemy 0 show_suppressed 0 - (domyślnie) Wyłączone;
1 - Włączone.
Pokaż 0 sections.0 0 - Grupy hostów;
1 - Opis;
2 - Monitorowanie;
3 - Dostępność;
4 - Monitorowane przez;
5 - Szablony;
6 - Inwentarz;
7 - Tagi.

Uwaga: Liczba w nazwie właściwości odnosi się do kolejności sekcji na liście sekcji. Aby skonfigurować wiele sekcji, utwórz obiekt pola widżetu pulpitu dla każdej sekcji, zwiększając numer w nazwie właściwości.

Następujące parametry są obsługiwane, jeśli Pokaż jest ustawione na „Inwentarz”.

Parametr type name value
Pola inwentarza 0 inventory.0 ID inwentarza.

Uwaga: Aby skonfigurować wiele pól inwentarza, utwórz obiekt pola widżetu pulpitu dla każdego pola inwentarza, zwiększając numer w nazwie właściwości.

Przykłady

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

Konfigurowanie widżetu Host card

Skonfiguruj widżet Host card, który wyświetla następujące sekcje: „Monitoring”, „Availability”, „Monitored by”, „Inventory” i „Tags”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "hostcard",
                        "name": "Host card",
                        "x": 0,
                        "y": 0,
                        "width": 14,
                        "height": 7,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 3,
                                "name": "hostid.0",
                                "value": 10084
                            },
                            {
                                "type": 0,
                                "name": "show_suppressed",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "sections.0",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "sections.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "sections.2",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "sections.3",
                                "value": 6
                            },
                            {
                                "type": 0,
                                "name": "sections.4",
                                "value": 7
                            },
                            {
                                "type": 0,
                                "name": "inventory.0",
                                "value": 25
                            },
                            {
                                "type": 0,
                                "name": "inventory.1",
                                "value": 26
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Odpowiedź:

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

Zobacz także