Documentation
Table of Contents
17 Problemy
Opis
Te parametry i możliwe wartości właściwości dla odpowiednich obiektów pola widżetu pulpitu pozwalają skonfigurować widżet Problemy w metodach dashboard.create i dashboard.update.
Właściwości widżetu fields nie są walidowane podczas tworzenia lub aktualizacji pulpitu. Pozwala to użytkownikom modyfikować wbudowane widżety i tworzyć niestandardowe widżety, ale wprowadza również ryzyko nieprawidłowego tworzenia lub aktualizacji widżetów. Aby zapewnić pomyślne utworzenie lub aktualizację widżetu Problemy, należy odwołać się do wymagań dotyczących parametrów przedstawionych w poniższych tabelach.
Parametry
Poniższe parametry są obsługiwane dla widżetu Problemy.
| Parametr | typ | nazwa | wartość | |
|---|---|---|---|---|
| Interwał odświeżania | 0 | rf_rate | 0 - Brak odświeżania; 10 - 10 sekund; 30 - 30 sekund; 60 - (domyślne) 1 minuta; 120 - 2 minuty; 600 - 10 minut; 900 - 15 minut. |
|
| Pokaż | 0 | show | 1 - (domyślne) Ostatnie problemy; 2 - Historia; 3 - Problemy. |
|
| Grupy hostów | 2 | groupids | ID grupy hostów. Uwaga: Aby skonfigurować wiele grup hostów, utwórz obiekt pola widżetu pulpitu nawigacyjnego dla każdej grupy hostów. |
|
| Wyklucz grupy hostów | 2 | exclude_groupids | ID grupy hostów. Uwaga: Aby wykluczyć wiele grup hostów, utwórz obiekt pola widżetu pulpitu nawigacyjnego dla każdej grupy hostów. |
|
| Hosty | 3 | hostids | ID hosta. Uwaga: Aby skonfigurować wiele hostów, utwórz obiekt pola widżetu pulpitu nawigacyjnego dla każdego hosta. Dla wielu hostów parametr Grupy hostów musi być albo w ogóle nie skonfigurowany, albo skonfigurowany z co najmniej jedną grupą hostów, do której należą skonfigurowane hosty. |
|
| Problem | 1 | problem | Nazwa zdarzenia problemu (bez rozróżniania wielkości liter, pełna nazwa lub jej część). | |
| Poziom | 0 | severities | 0 - Nieklasyfikowany; 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 pulpitu nawigacyjnego dla każdej wartości. |
|
| Znaczniki (numer w nazwie właściwości (np. tags.tag.0) odnosi się do kolejności tagów na liście ewaluacyjnej tagów) | ||||
| Typ ewaluacji | 0 | evaltype | 0 - (domyślne) I/Lub; 2 - Lub. |
|
| Nazwa znacznika | 1 | tags.tag.0 | Dowolna wartość ciągu znaków. Parametr Nazwa tagu jest wymagany przy konfiguracji Znaczników. |
|
| Operator | 0 | tags.operator.0 | 0 - Zawiera; 1 - Równa się; 2 - Nie zawiera; 3 - Nie równa się; 4 - Istnieje; 5 - Nie istnieje. Parametr Operator jest wymagany przy konfiguracji Znaczników. |
|
| Wartość znacznika | 1 | tags.value.0 | Dowolna wartość ciągu znaków. Parametr Wartość tagu jest wymagany przy konfiguracji Znaczników. |
|
| Pokaż znaczniki | 0 | show_tags | 0 - (domyślne) Brak; 1 - 1; 2 - 2; 3 - 3. |
|
| Nazwa znacznika (format) | 0 | tag_name_format | 0 - (domyślne) Pełny; 1 - Skrócony; 2 - Brak. Parametr Nazwa tagu (format) nie jest dostępny, jeśli Pokaż znaczniki jest ustawione na "Brak". |
|
| Priorytet wyświetlania znaczników | 1 | tag_priority | Lista tagów oddzielonych przecinkami. Parametr Priorytet wyświetlania znaczników niedostępny, jeśli Pokaż znacnziki jest ustawione na "Brak". |
|
| Pokaż dane operacyjne | 0 | show_opdata | 0 - (domyślne) Brak; 1 - Oddzielnie; 2 - Z nazwą problemu. |
|
| Pokaż wstrzymane problemy | 0 | show_suppressed | 0 - (domyślne) Wyłączone; 1 - Włączone. |
|
| Pokaż tylko niepotwierdzone | 0 | unacknowledged | 0 - (domyślne) Wyłączone; 1 - Włączone. |
|
| Sortuj pozycje wg | 0 | sort_triggers | 1 - Poziom (malejąco); 2 - Host (rosnąco); 3 - Czas (rosnąco); 4 - (domyślne) Czas (malejąco); 13 - Poziom (rosnąco); 14 - Host (malejąco); 15 - Problem (rosnąco); 16 - Problem (malejąco). Dla wszystkich wartości, z wyjątkiem "Czas (malejąco)" i "Czas (rosnąco)", parametr Pokaż linię czasu musi być ustawiony na "Wyłączone". |
|
| Pokaż linię czasu | 0 | show_timeline | 0 - Wyłączone; 1 - (domyślne) Włączone. Parametr Pokaż linię czasu jest dostępny, jeśli Sortuj wpisy według jest ustawiony na "Czas (malejąco)" lub "Czas (rosnąco)". |
|
| Wyświetl linie | 0 | show_lines | Dopuszczalne wartości wynoszą od 1 do 100. Domyślnie: 25. |
|
Przykłady
Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widżetu pulpitu dla widżetu Problemy. Aby uzyskać więcej informacji na temat konfigurowania pulpitu nawigacyjnego, zobacz dashboard.create.
Konfigurowanie widżetu Problemy
Skonfiguruj widżet Problemy, który wyświetla problemy dla grupy hostów "4", które spełniają następujące warunki:
- Problemy, które mają tag o nazwie "scope", który zawiera wartości "performance" lub "availability" lub "capacity".
- Problemy, które mają następujące poziomy: "Ostrzeżenie", "Średni", "Wysoki", "Katastrofa".
Dodatkowo, skonfiguruj widżet tak, aby wyświetlał znaczniki i dane operacyjne.
Zapytanie:
{
"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": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids",
"value": 4
},
{
"type": 1,
"name": "tags.tag.0",
"value": "scope"
},
{
"type": 0,
"name": "tags.operator.0",
"value": 0
},
{
"type": 1,
"name": "tags.value.0",
"value": "performance"
},
{
"type": 1,
"name": "tags.tag.1",
"value": "scope"
},
{
"type": 0,
"name": "tags.operator.1",
"value": 0
},
{
"type": 1,
"name": "tags.value.1",
"value": "availability"
},
{
"type": 1,
"name": "tags.tag.2",
"value": "scope"
},
{
"type": 0,
"name": "tags.operator.2",
"value": 0
},
{
"type": 1,
"name": "tags.value.2",
"value": "capacity"
},
{
"type": 0,
"name": "severities",
"value": 2
},
{
"type": 0,
"name": "severities",
"value": 3
},
{
"type": 0,
"name": "severities",
"value": 4
},
{
"type": 0,
"name": "severities",
"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
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź: