23 Problemy

Opis

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

Parametry

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

Parameter type name value
Refresh interval 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.
Show 0 show 1 - (domyślnie) Ostatnie problemy;
2 - Historia;
3 - Problemy.
Host groups 2 groupids.0 ID host group.

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

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na template dashboard.
Host groups (Widget) 1 groupids._reference Zamiast ID host group:
ABCDE._hostgroupids - ustaw kompatybilny widżet (z parametrem Reference ustawionym na "ABCDE") jako źródło danych dla host group.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na template dashboard.
Exclude host groups 2 exclude_groupids.0 ID host group.

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

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na template dashboard.
Hosts 3 hostids.0 ID host.

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

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na template dashboard.
Hosts (Widget/Dashboard) 1 hostids._reference Zamiast ID Host:
DASHBOARD.hostids - ustaw selektor Host jako źródło danych dla host;
ABCDE._hostids - ustaw kompatybilny widżet (z parametrem Reference ustawionym na "ABCDE") jako źródło danych dla host.

Ten parametr nie jest obsługiwany podczas konfigurowania widżetu na template dashboard.
Problem 1 problem Nazwa zdarzenia problemu (bez rozróżniania wielkości liter, pełna nazwa lub jej część).
Severity 0 severities.0 0 - Nie sklasyfikowano;
1 - Informacja;
2 - Ostrzeżenie;
3 - Średni;
4 - Wysoki;
5 - Katastrofa.

Domyślnie: puste (wszystkie włączone).

Uwaga: Aby skonfigurować wiele wartości, utwórz obiekt pola widżetu dashboardu dla każdej wartości, zwiększając numer w nazwie właściwości.
Problem tags
Evaluation type 0 evaltype 0 - (domyślnie) Oraz/Lub;
2 - Lub.
Tag name 1 tags.0.tag Dowolna wartość tekstowa.

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

Zachowanie parametru:
- wymagany podczas konfigurowania Problem tags
Operator 0 tags.0.operator 0 - Zawiera;
1 - Równa się;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.

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

Zachowanie parametru:
- wymagany podczas konfigurowania Problem tags
Tag value 1 tags.0.value Dowolna wartość tekstowa.

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

Zachowanie parametru:
- wymagany podczas konfigurowania Problem tags
Show tags 0 show_tags 0 - (domyślnie) Brak;
1 - 1;
2 - 2;
3 - 3.
Tag name (format) 0 tag_name_format 0 - (domyślnie) Pełny;
1 - Skrócony;
2 - Brak.

Zachowanie parametru:
- obsługiwany jeśli Show tags ma wartość "1", "2" lub "3"
Tag display priority 1 tag_priority Lista tagów oddzielona przecinkami.

Zachowanie parametru:
- obsługiwany jeśli Show tags ma wartość "1", "2" lub "3"
Show operational data 0 show_opdata 0 - (domyślnie) Brak;
1 - Osobno;
2 - Z nazwą problemu.
Show suppressed problems 0 show_suppressed 0 - (domyślnie) Wyłączone;
1 - Włączone.
Acknowledgement status 0 acknowledgement_status 0 - (domyślnie) wszystkie;
1 - Niepotwierdzone;
2 - Potwierdzone.
By me 0 acknowledged_by_me 0 - (domyślnie) Wyłączone;
1 - Włączone.
Sort entries by 0 sort_triggers 1 - Severity (malejąco);
2 - Host (rosnąco);
3 - Time (rosnąco);
4 - (domyślnie) Time (malejąco);
13 - Severity (rosnąco);
14 - Host (malejąco);
15 - Problem (rosnąco);
16 - Problem (malejąco).

Dla wszystkich wartości, z wyjątkiem "Time (malejąco)" i "Time (rosnąco)", parametr Show timeline musi mieć ustawioną wartość "Disabled".

Wartości "Host (rosnąco)" i "Host (malejąco)" nie są obsługiwane podczas konfigurowania widżetu na template dashboard.
Show timeline 0 show_timeline 0 - Wyłączone;
1 - (domyślnie) Włączone.

Zachowanie parametru:
- obsługiwany jeśli Sort entries by ma ustawioną wartość "Time (malejąco)" lub "Time (rosnąco)"
Highlight whole row 0 highlight_row 0 - (domyślnie) Wyłączone;
1 - Włączone.

Ten parametr nie jest obsługiwany w motywach o wysokim kontraście.

Ta opcja jest obsługiwana od Zabbix 7.4.3.
Show lines 0 show_lines Możliwe wartości mieszczą się w zakresie 1-100.

Domyślnie: 25.
Reference 1 reference Dowolna wartość tekstowa składająca się z 5 znaków (np. ABCDE lub JBPNL). Wartość ta musi być unikalna 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 Problemy. Więcej informacji na temat konfiguracji pulpitu można znaleźć w dashboard.create.

Konfigurowanie widżetu Problemy

Skonfiguruj widżet Problemy, który wyświetla problemy dla grupy hostów „4”, spełniające następujące warunki:

  • Problemy, które mają znacznik o nazwie „scope”, zawierający wartości „performance” lub „availability”, albo „capacity”.
  • Problemy o następujących poziomach ważności: „Warning”, „Average”, „High”, „Disaster”.

Dodatkowo skonfiguruj widżet tak, aby wyświetlał znaczniki i dane operacyjne.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "problems",
                        "name": "Problems",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "type": 1,
                                "name": "tags.0.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "performance"
                            },
                            {
                                "type": 1,
                                "name": "tags.1.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.1.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.1.value",
                                "value": "availability"
                            },
                            {
                                "type": 1,
                                "name": "tags.2.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.2.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.2.value",
                                "value": "capacity"
                            },
                            {
                                "type": 0,
                                "name": "severities.0",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "severities.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "severities.2",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "severities.3",
                                "value": 5
                            },
                            {
                                "type": 0,
                                "name": "show_tags",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show_opdata",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Odpowiedź:

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

Zobacz także