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 nośnika w frontend Zabbix:

  1. Przejdź do Alerts > Media types.
  2. Kliknij Create media type.
  3. Wprowadź parametry typu nośnika w formularzu.

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

Jeśli co najmniej jedna metoda dostarczania jest określona we fladze funkcji $ZBX_FEATURE_FLAGS['media_type_denylist'] w pliku konfiguracyjnym frontend (zabbix.conf.php), te metody dostarczania nie są dostępne na liście Type.

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

Parametry specyficzne dla poszczególnych metod opisano na stronach dotyczących poczty elektronicznej, SMS, niestandardowego 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 Opcje zawiera ustawienia przetwarzania alertów.
Ten sam zestaw opcji można skonfigurować dla każdego typu nośnika.

Wszystkie typy nośników są przetwarzane równolegle.
Maksymalną liczbę jednoczesnych sesji można skonfigurować dla każdego typu nośnika,
natomiast całkowitą liczbę procesów alertera na serwerze można ograniczyć wyłącznie za pomocą parametru StartAlerters.
Alerty wygenerowane przez jeden wyzwalacz są przetwarzane sekwencyjnie.
Oznacza to, że wiele powiadomień może być przetwarzanych jednocześnie tylko wtedy, gdy zostały wygenerowane przez wiele wyzwalaczy.

Parametr Opis
Jednoczesne sesje Wybierz liczbę równoległych sesji alertera dla typu nośnika:
Jedna - jedna sesja
Bez ograniczeń - nieograniczona liczba sesji
Niestandardowa - wybierz niestandardową liczbę sesji
Brak ograniczeń/duże wartości oznaczają większą liczbę równoległych sesji i większą wydajność wysyłania powiadomień. Brak ograniczeń/duże wartości należy stosować w dużych środowiskach, w których może być konieczne jednoczesne wysłanie wielu powiadomień.
Jeśli liczba powiadomień do wysłania przekracza liczbę jednoczesnych 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 ponowi próby w przypadku niepowodzenia wysyłania.
Interwał między próbami 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ą przyrostki czasu (np. 30s, 1m, 1h).

Media użytkownika

Podczas gdy typy mediów określają, w jaki sposób zostanie wysłane powiadomienie, media użytkownika określają, dokąd należy je wysłać.

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

Aby zdefiniować media użytkownika:

  1. Przejdź do Użytkownicy > Użytkownicy i otwórz formularz właściwości użytkownika. Możesz również przejść do sekcji Ustawienia użytkownika > Powiadomienia własnego profilu użytkownika.
  2. Kliknij Dodaj na karcie Media.
  3. Wprowadź parametry mediów użytkownika w formularzu.

Parametr Opis
Typ Lista rozwijana zawiera nazwy włączonych typów mediów.
Należy pamiętać, że podczas edytowania medium wyłączonego typu mediów typ będzie wyświetlany na czerwono.
Wyślij do Wprowadź dane kontaktowe, na które powinny być wysyłane wiadomości.
W przypadku typu mediów e-mail można dodać wiele adresów, klikając przycisk poniżej pola adresu. W takim przypadku powiadomienia będą wysyłane na wszystkie wymienione adresy. Przykłady adresów można znaleźć w opisie parametru E-mail dla typu mediów e-mail.
Aktywne w godzinach Możesz ograniczyć czas wysyłania wiadomości, na przykład ustawić tylko dni robocze (1-5,09:00-18:00). Należy pamiętać, że ograniczenie to jest oparte na strefie czasowej użytkownika. Jeśli strefa czasowa użytkownika zostanie zmieniona i będzie różnić się od strefy czasowej systemu, może być konieczne odpowiednie dostosowanie tego ograniczenia, aby nie pominąć ważnych wiadomości.
Opis formatu znajduje się na stronie Specyfikacja okresu.
Obsługiwane są makra użytkownika.
Użyj, jeśli ważność Zaznacz pola wyboru ważności wyzwalaczy, dla których chcesz otrzymywać powiadomienia.
Uwaga: domyślna ważność („Niesklasyfikowane”) musi być zaznaczona, jeśli chcesz otrzymywać powiadomienia dotyczące zdarzeń innych niż wyzwalacze.
Po zapisaniu wybrane ważności wyzwalaczy będą wyświetlane w odpowiadających im kolorach ważności, a niezaznaczone zostaną wyszarzone.
Stan Stan mediów użytkownika.
Włączone - jest używane.
Wyłączone - nie jest używane.