[comment]: # ({e88c898d-e88c898d})
# 1 Typy mediów

[comment]: # ({/e88c898d-e88c898d})

[comment]: # ({dbad0c34-3c7a0fa2})
#### 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:

-   [Email](/manual/config/notifications/media/email)
-   [SMS](/manual/config/notifications/media/sms)
-   [Custom script](/manual/config/notifications/media/script)
-   [Webhook](/manual/config/notifications/media/webhook)

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

![](../../../../assets/en/manual/config/notifications/media_type_list.png){width="600"}

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](/manual/config/notifications/action/operation#configuring-an-operation), która wysyła powiadomienia
2. Musi być zdefiniowany działający [media type](#configuration) (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](#user-media)

[comment]: # ({/dbad0c34-3c7a0fa2})

[comment]: # ({6d474343-aab3354b})
###### 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 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 czekać, aż serwer zwróci wyniki. Testowanie typu mediów ma domyślnie limit czasu 65 sekund (konfigurowalny w *Administracja* > *Ogólne* > *[Limity czasu](/manual/web_interface/frontend_sections/administration/general#timeouts)*).

Zobacz także szczegóły testowania dla:

- [Email](/manual/config/notifications/media/email#testing)
- [Webhook](/manual/config/notifications/media/webhook#testing)
- [Script](/manual/config/notifications/media/script#testing)

[comment]: # ({/6d474343-aab3354b})

[comment]: # ({8ccd9290-dfae5c19})
#### Konfiguracja

Aby utworzyć typ mediów w frontend 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.

![](../../../../assets/en/manual/config/notifications/media_types_common.png){width="600"}

|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 znajdziesz na stronach [email](/manual/config/notifications/media/email#configuration), [SMS](/manual/config/notifications/media/sms#configuration), [custom alertscript](/manual/config/notifications/media/script#configuration) lub [webhook](/manual/config/notifications/media/webhook#configuration).

[comment]: # ({/8ccd9290-dfae5c19})

[comment]: # ({11d7e927-55a28037})
###### Szablony wiadomości

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

![](../../../../assets/en/manual/config/notifications/media_type_messages.png){width="600"}

Kliknij **Dodaj**, aby zdefiniować domyślną wiadomość (lub **Edytuj**, aby zaktualizować istniejącą wiadomość):

![](../../../../assets/en/manual/config/notifications/media/media_types2.png){width="600"}

|Parameter|Description|
|--|-----------|
|*Message type*|Typ zdarzenia, dla którego ma być używana domyślna wiadomość.<br>Dla każdego typu zdarzenia można zdefiniować tylko jedną domyślną wiadomość.<br>|
|*Subject*|Temat domyślnej wiadomości. Temat może zawierać makra. Jest ograniczony do 255 znaków.<br>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, zależnie od typu bazy danych (więcej informacji znajdziesz w sekcji [Wysyłanie wiadomości](/manual/config/notifications/action/operation/message/)).<br>Wiadomość może zawierać obsługiwane [makra](/manual/appendix/macros/supported_by_location).<br>W wiadomościach o problemie i aktualizacji problemu obsługiwane są makra wyrażeń (na przykład `{?avg(/host/key,1h)}`).|

Pamiętaj, że domyślne wiadomości są zastępowane przez wiadomości niestandardowe, jeśli zostały zdefiniowane w [operacjach akcji](/manual/config/notifications/action/operation#operation-details).

::: notewarning
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. 
:::

[comment]: # ({/11d7e927-55a28037})

[comment]: # ({22fbec32-161fb66e})
###### 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 alertera na serwerze może być ograniczona tylko przez parametr StartAlerters [parameter](/manual/appendix/config/zabbix_server). 
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.

![](../../../../assets/en/manual/config/notifications/media/media_type_options.png){width="600"}

|Parameter|Description|
|--|--------|
|*Concurrent sessions*|Wybierz liczbę równoległych sesji alertera dla typu medium:<br>**One** - jedna sesja<br>**Unlimited** - nieograniczona liczba sesji<br>**Custom** - wybierz niestandardową liczbę sesji<br>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ń.<br>Jeśli trzeba wysłać więcej powiadomień, niż dostępnych 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.<br>Obsługiwane są sufiksy czasu, np. 5s, 3m, 1h.|

[comment]: # ({/22fbec32-161fb66e})

[comment]: # ({db1efc6e-cb94600e})
#### Media użytkownika

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

Media użytkownika (np. adres e-mail, identyfikator użytkownika webhook 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:

-   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

![](../../../../assets/en/manual/config/notifications/media/user_media2.png){width="600"}

|Parameter|Description|
|--|--------|
|*Type*|Lista rozwijana zawiera nazwy włączonych typów mediów.<br>Zwróć uwagę, że podczas edycji medium należącego do wyłączonego typu mediów, typ będzie wyświetlany na czerwono.|
|*Send to*|Wprowadź dane kontaktowe, na które mają być wysyłane wiadomości.<br>W przypadku typu mediów e-mail można dodać wiele adresów, klikając przycisk ![](../../../../assets/en/manual/config/add_link.png) 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 mediów [email](/manual/config/notifications/media/email#configuration).|
|*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](/manual/web_interface/time_zone) użytkownika. Jeśli strefa czasowa użytkownika zostanie zmieniona i różni się od strefy czasowej systemu, ograniczenie to może wymagać odpowiedniego dostosowania, aby nie przegapić ważnych wiadomości.<br>Opis formatu znajduje się na stronie [Specyfikacja okresu czasu](/manual/appendix/time_period).<br>Obsługiwane są makra użytkownika.|
|*Use if severity*|Zaznacz pola wyboru odpowiadające poziomom ważności wyzwalaczy, dla których chcesz otrzymywać powiadomienia.<br>*Uwaga* domyślny poziom ważności ('Not classified') **musi być** zaznaczony, jeśli chcesz otrzymywać powiadomienia dla zdarzeń [events](/manual/config/events) innych niż wyzwalacze.<br>Po zapisaniu wybrane poziomy ważności wyzwalaczy będą wyświetlane w odpowiadających im kolorach, a niezaznaczone zostaną wyszarzone.|
|*Status*|Status mediów użytkownika.<br>**Enabled** - jest używane.<br>**Disabled** - nie jest używane.|

[comment]: # ({/db1efc6e-cb94600e})

[comment]: # ({7ba43dfc-54669df1})
#### Automatyczne typy mediów Gmail/Office365

Użytkownicy Gmail lub Office365 mogą skorzystać z łatwiejszej konfiguracji typu mediów. 
Pole *Email provider* w konfiguracji typu mediów poczty umożliwia wybór 
wstępnie skonfigurowanych opcji dla Gmail i Office 365.

Podczas wybierania opcji związanych z Gmail/Office365 wystarczy podać adres e-mail/nazwę użytkownika i hasło nadawcy, aby utworzyć działający typ mediów. 

![](../../../../assets/en/manual/config/notifications/media_type_gmail.png){width="600"}

Gdy tylko zostanie podany adres e-mail/hasło, Zabbix będzie mógł automatycznie wypełnić wszystkie wymagane ustawienia dla typów mediów Gmail/Office365 rzeczywistymi/rekomendowanymi wartościami, tj. *SMTP server*, *SMTP server port*, *SMTP helo* oraz *Connection security*. Z tego powodu pola te nie są nawet wyświetlane, jednak w liście typów mediów można zobaczyć serwer SMTP i szczegóły e-maila (zob. kolumna *Details*).

Należy również pamiętać, że:

-   Hasło nie jest wymagane dla opcji relay.
-   W przypadku Office365 relay nazwa domeny podanego adresu e-mail zostanie użyta do dynamicznego wypełnienia serwera SMTP (tj. zastąpienia "example.com" w `example-com.mail.protection.outlook.com` rzeczywistą wartością).

[comment]: # ({/7ba43dfc-54669df1})