1 Typy mediów

Przegląd

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

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

Typy mediów są zarządzane w Alerts > Media types. Niektóre typy mediów są wstępnie zdefiniowane w domyślnym zestawie danych. Wystarczy dostosować ich parametry, aby zaczęły działać.

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

  1. Musi być zdefiniowana operacja action, która wysyła powiadomienia
  2. Musi być zdefiniowany działający media type (na przykład Email, który wysyła alerty za pomocą SMTP)
  3. Szczegóły dostarczania na poziomie użytkownika (takie jak adresy e-mail, numery telefonów itp.) muszą być zdefiniowane w user media
Testowanie typów 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 serwera 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 oczekiwać na zwrócenie wyników przez serwer. Testowanie typów mediów ma domyślnie limit czasu 65 sekund (można go skonfigurować w Administracja > Ogólne > Timeouts).

Zobacz także szczegóły testowania dla:

Konfiguracja

Aby utworzyć typ mediów w frontend Zabbix:

  • 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.

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.

Informacje o parametrach specyficznych dla danej metody znajdują się na stronach email, SMS, custom alertscript lub webhook.

Szablony wiadomości

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

Kliknij Dodaj, aby zdefiniować domyślną wiadomość (lub Edytuj, 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 Wysyłanie wiadomości).
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 niestandardowe wiadomości, jeśli zostały zdefiniowane w operacjach akcji.

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 „Wyślij wiadomość do webhooka Pushover” nie wyśle powiadomień o problemie, jeśli wiadomość o problemie dla webhooka Pushover nie została zdefiniowana.

Opcje

Zakładka Opcje zawiera ustawienia przetwarzania alertów. Ten sam zestaw opcji można skonfigurować dla każdego typu mediów.

Wszystkie typy mediów są przetwarzane równolegle. Maksymalna liczba równoczesnych sesji jest konfigurowalna dla każdego typu mediów, jednak łączna liczba procesów alertera na serwerze może być ograniczona wyłącznie przez parametr StartAlerters. Alerty wygenerowane przez jeden wyzwalacz są przetwarzane sekwencyjnie. Dlatego wiele powiadomień może być przetwarzanych jednocześnie tylko wtedy, gdy zostały wygenerowane przez wiele wyzwalaczy.

Parametr Opis
Równoczesne sesje Wybierz liczbę równoległych sesji alertera dla typu mediów:
Jedna - jedna sesja
Nieograniczona - nieograniczona liczba sesji
Niestandardowa - wybierz niestandardową liczbę sesji
Nieograniczone/wysokie wartości oznaczają więcej równoległych sesji i zwiększoną wydajność wysyłania powiadomień. Nieograniczone/wysokie wartości powinny być używane w dużych środowiskach, w których może być konieczne jednoczesne wysyłanie wielu powiadomień.
Jeśli do wysłania będzie więcej powiadomień niż dostępnych równoczesnych sesji, pozostałe powiadomienia zostaną umieszczone w kolejce; nie zostaną utracone.
Próby Liczba prób wysłania powiadomienia. Można określić maksymalnie 100 prób; wartość domyślna to „3”. Jeśli określono „1”, Zabbix wyśle powiadomienie tylko raz i nie będzie ponawiał próby, jeśli wysyłanie się nie powiedzie.
Interwał prób Częstotliwość ponawiania próby wysłania powiadomienia w przypadku niepowodzenia wysyłania, w sekundach (0-3600). Jeśli określono „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 dostarczenia webhooka X nie są zdefiniowane w profilu użytkownika Admin.

Aby zdefiniować media użytkownika:

  • 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)
  • 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 znajdziesz 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 użytkowniczej strefie czasowej. Jeśli strefa czasowa użytkownika zostanie zmieniona i będzie inna niż systemowa strefa czasowa, to ograniczenie może wymagać odpowiedniego dostosowania, 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 dla 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.