1 Typy mediów

Przegląd

Typy mediów to kanały dostarczania używane do wysyłania powiadomień i alertów z Zabbix.

Typy mediów obsługują następujące metody dostarczania:

Typy mediów są utrzymywane w Alerty > Typy mediów. Niektóre typy mediów są wstępnie zdefiniowane w domyślnym zestawie danych. Wystarczy dostroić ich parametry, aby zaczęły działać.

Aby zobaczyć, jak typy mediów wpisują się w proces alertowania, przyjrzyjmy się trzem wymaganiom dotyczącym dostarczania powiadomień z Zabbix do użytkowników końcowych:

  1. Musi być zdefiniowana operacja operacja, która wysyła powiadomienia
  2. Musi być zdefiniowany działający typ mediów (na przykład E-mail, który wysyła alerty przy użyciu SMTP)
  3. Szczegóły dostarczania na poziomie użytkownika (takie jak adresy e-mail, numery telefonów itp.) muszą być zdefiniowane w mediach użytkownika
Testowanie typu mediów

Aby sprawdzić, czy skonfigurowany typ mediów działa, kliknij Test na liście typów mediów.

Żądanie testowe zostanie wysłane do serwer Zabbix. Serwer Zabbix spróbuje wysłać alert przy użyciu określonego typu mediów i zwróci wynik do frontend. Frontend będzie czekać, aż serwer zwróci wyniki. Testowanie typu mediów ma domyślnie limit czasu 65 sekund (konfigurowalny w Administration > General > Timeouts).

Zobacz także szczegóły testowania dla:

Konfiguracja

Aby utworzyć typ mediów we frontendzie Zabbixa:

  • Przejdź do: Alerts > Media types
  • Kliknij Create media type
  • Wprowadź parametry typu mediów w formularzu

Niektóre parametry są wspólne dla wszystkich metod dostarczania.

Jeśli jedna lub więcej metod dostarczania jest określona w funkcji flagi $ZBX_FEATURE_FLAGS['media_type_denylist'] w pliku konfiguracji frontend (zabbix.conf.php), te metody dostarczania nie są dostępne na liście Type.

Parameter Description
Name Nazwa typu mediów.
Type Wybierz metodę dostarczania dla typu mediów.
Description Wprowadź opis typu mediów.
Enabled Zaznacz pole wyboru, aby włączyć typ mediów.

Parametry specyficzne dla danej metody znajdziesz na stronach email, SMS, custom alertscript lub webhook.

Szablony wiadomości

Karta Message templates zawiera domyślne wiadomości dla poszczególnych typów zdarzeń (problem, odzyskanie po problemie, wykrywanie itp.).

Kliknij Add, aby zdefiniować domyślną wiadomość (lub Edit, aby zaktualizować istniejącą wiadomość):

Parameter Description
Message type Typ zdarzenia, dla którego ma być używana domyślna wiadomość.
Dla każdego typu zdarzenia można zdefiniować tylko jedną domyślną wiadomość.
Subject Temat domyślnej wiadomości. Temat może zawierać makra. Jego długość jest ograniczona do 255 znaków.
Temat nie jest dostępny dla typu nośnika SMS.
Message Domyślna wiadomość. Jej długość jest ograniczona do określonej liczby znaków w zależności od typu bazy danych (więcej informacji można znaleźć w sekcji Sending messages).
Wiadomość może zawierać obsługiwane makra.
W wiadomościach o problemie i aktualizacji problemu obsługiwane są makra wyrażeń (na przykład {?avg(/host/key,1h)}).

Należy pamiętać, że domyślne wiadomości są zastępowane przez wiadomości niestandardowe, jeśli zostały zdefiniowane w action operations.

Definiowanie szablonów wiadomości jest obowiązkowe dla wszystkich metod dostarczania, w tym webhooków lub niestandardowych skryptów alertów, które nie używają domyślnych wiadomości do powiadomień. Na przykład akcja "Send message to Pushover webhook" nie wyśle powiadomień o problemie, jeśli wiadomość o problemie dla Pushover webhook nie została zdefiniowana.

Opcje

Karta Options zawiera ustawienia przetwarzania alertów. Ten sam zestaw opcji można skonfigurować dla każdego typu medium.

Wszystkie typy medium są przetwarzane równolegle. Chociaż maksymalna liczba równoczesnych sesji jest konfigurowalna dla każdego typu medium, łączna liczba procesów alerter na serwerze może być ograniczona tylko przez parametr StartAlerters parameter. Alerty wygenerowane przez jeden wyzwalacz są przetwarzane sekwencyjnie. Dlatego wiele powiadomień może być przetwarzanych jednocześnie tylko wtedy, gdy są generowane przez wiele wyzwalaczy.

Parameter Description
Concurrent sessions Wybierz liczbę równoległych sesji alerter dla typu medium:
One - jedna sesja
Unlimited - nieograniczona liczba sesji
Custom - wybierz niestandardową liczbę sesji
Wartości Unlimited/wysokie oznaczają więcej równoległych sesji i większą wydajność wysyłania powiadomień. Wartości Unlimited/wysokie należy stosować w dużych środowiskach, w których może być konieczne jednoczesne wysyłanie wielu powiadomień.
Jeśli trzeba wysłać więcej powiadomień, niż jest równoczesnych sesji, pozostałe powiadomienia zostaną umieszczone w kolejce; nie zostaną utracone.
Attempts Liczba prób wysłania powiadomienia. Można określić maksymalnie 100 prób; wartość domyślna to '3'. Jeśli zostanie określone '1', Zabbix wyśle powiadomienie tylko raz i nie będzie ponawiać próby w przypadku niepowodzenia wysyłania.
Attempt interval Częstotliwość ponawiania próby wysłania powiadomienia w przypadku niepowodzenia wysyłania, w sekundach (0-3600). Jeśli zostanie określone '0', Zabbix ponowi próbę natychmiast.
Obsługiwane są sufiksy czasu, np. 5s, 3m, 1h.

Media użytkownika

Podczas gdy typy mediów określają jak zostanie wysłane powiadomienie, media użytkownika określają dokąd powiadomienie musi zostać wysłane.

Media użytkownika (np. adres e-mail, identyfikator użytkownika webhooka itp.) muszą być zdefiniowane w profilu użytkownika niezależnie od metody dostarczenia. Akcja wysyłająca wiadomości do użytkownika Admin za pomocą webhooka X zakończy się niepowodzeniem, jeśli szczegóły dostarczania webhooka X nie są zdefiniowane w profilu użytkownika Admin.

Aby zdefiniować media użytkownika:

  1. Przejdź do Users > Users i otwórz formularz właściwości użytkownika (lub przejdź do User settings > Notifications własnego profilu użytkownika).
  2. Kliknij Add na karcie Media.

Parameter Description
Type Lista rozwijana zawiera nazwy włączonych typów mediów.
Zwróć uwagę, że podczas edycji medium wyłączonego typu medium, typ będzie wyświetlany na czerwono.
Send to Wprowadź dane kontaktowe, na które mają być wysyłane wiadomości.
W przypadku typu medium e-mail można dodać wiele adresów, klikając przycisk poniżej pola adresu. W takim przypadku powiadomienia zostaną wysłane na wszystkie wymienione adresy. Przykłady adresów znajdują się w opisie parametru Email dla typu medium email.
When active Możesz ograniczyć czas wysyłania wiadomości, na przykład ustawić tylko dni robocze (1-5,09:00-18:00). Zwróć uwagę, że to ograniczenie jest oparte na strefie czasowej użytkownika. Jeśli strefa czasowa użytkownika zostanie zmieniona i będzie inna niż strefa czasowa systemu, może być konieczne odpowiednie dostosowanie tego ograniczenia, aby nie przegapić ważnych wiadomości.
Opis formatu znajduje się na stronie Specyfikacja okresu czasu.
Obsługiwane są makra użytkownika.
Use if severity Zaznacz pola wyboru poziomów ważności wyzwalaczy, dla których chcesz otrzymywać powiadomienia.
Uwaga domyślny poziom ważności ('Not classified') musi być zaznaczony, jeśli chcesz otrzymywać powiadomienia dla zdarzeń events innych niż wyzwalacze.
Po zapisaniu wybrane poziomy ważności wyzwalaczy będą wyświetlane w odpowiadających im kolorach, a niewybrane zostaną wyszarzone.
Status Status mediów użytkownika.
Enabled - jest używane.
Disabled - nie jest używane.