1 Medientypen

Übersicht

Medientypen sind die Übertragungskanäle, die zum Senden von Benachrichtigungen und Warnmeldungen aus Zabbix verwendet werden.

Medientypen unterstützen die folgenden Zustellmethoden:

Medientypen werden unter Warnmeldungen > Medientypen verwaltet. Einige Medientypen sind im Standarddatensatz bereits vordefiniert.
Sie müssen nur deren Parameter feinabstimmen, damit sie funktionieren.

Um zu sehen, wie Medientypen in den Benachrichtigungsprozess passen, betrachten wir die drei Voraussetzungen für die Zustellung von Benachrichtigungen aus Zabbix an Endbenutzer:

  1. Es muss eine Aktions-Operation definiert sein, die Benachrichtigungen sendet
  2. Es muss ein funktionierender Medientyp definiert sein (z. B. E-Mail, die Warnmeldungen über SMTP sendet)
  3. Zustellungsdetails auf Benutzerebene (wie E-Mail-Adressen, Telefonnummern usw.) müssen in Benutzermedien definiert sein
Testen von Medientypen

Um zu testen, ob ein konfigurierter Medientyp funktioniert, klicken Sie in der Medientypliste auf Test.

Die Testanfrage wird an den Zabbix Server gesendet. Der Zabbix Server versucht, mithilfe des angegebenen Medientyps eine Benachrichtigung zu senden, und gibt das Ergebnis an das Frontend zurück. Das Frontend wartet darauf, dass der Server die Ergebnisse zurückgibt. Das Testen von Medientypen hat standardmäßig ein Timeout von 65 Sekunden (konfigurierbar unter Administration > General > Timeouts).

Siehe auch Testdetails für:

Konfiguration

So erstellen Sie einen Medientyp im Zabbix Frontend:

  • Gehen Sie zu: Benachrichtigungen > Medientypen
  • Klicken Sie auf Medientyp erstellen
  • Geben Sie die Parameter des Medientyps im Formular ein

Einige Parameter sind für alle Zustellungsmethoden gemeinsam.

Parameter Beschreibung
Name Name des Medientyps.
Type Wählen Sie die Zustellungsmethode für den Medientyp aus.
Description Geben Sie eine Beschreibung für den Medientyp ein.
Enabled Aktivieren Sie das Kontrollkästchen, um den Medientyp zu aktivieren.

Methodenspezifische Parameter finden Sie auf den Seiten E-Mail, SMS, benutzerdefiniertes Alert-Skript oder webhook.

Nachrichtenvorlagen

Die Registerkarte Nachrichtenvorlagen enthält Standardnachrichten pro Ereignistyp (Problem, Problembehebung, Discovery usw.).

Klicken Sie auf Hinzufügen, um eine Standardnachricht zu definieren (oder auf Bearbeiten, um eine vorhandene Nachricht zu aktualisieren):

Parameter Beschreibung
Nachrichtentyp Typ eines Ereignisses, für das die Standardnachricht verwendet werden soll.
Für jeden Ereignistyp kann nur eine Standardnachricht definiert werden.
Betreff Betreff der Standardnachricht. Der Betreff kann Makros enthalten. Er ist auf 255 Zeichen begrenzt.
Der Betreff ist für den Medientyp SMS nicht verfügbar.
Nachricht Die Standardnachricht. Sie ist abhängig vom Datenbanktyp auf eine bestimmte Anzahl von Zeichen begrenzt (weitere Informationen finden Sie unter Nachrichten senden).
Die Nachricht kann unterstützte Makros enthalten.
In Problem- und Problemaktualisierungsnachrichten werden Ausdrucksmakros unterstützt (zum Beispiel {?avg(/host/key,1h)}).

Beachten Sie, dass Standardnachrichten durch benutzerdefinierte Nachrichten überschrieben werden, falls diese in Aktionsoperationen definiert sind.

Das Definieren von Nachrichtenvorlagen ist für alle Zustellmethoden obligatorisch, einschließlich webhooks oder benutzerdefinierter Alarmskripte, die keine Standardnachrichten für Benachrichtigungen verwenden. Beispielsweise schlägt die Aktion „Nachricht an Pushover-webhook senden“ beim Senden von Problembenachrichtigungen fehl, wenn die Problemnachricht für den Pushover-webhook nicht definiert ist.

Optionen

Die Registerkarte Optionen enthält Einstellungen für die Alarmverarbeitung. Dieselbe Gruppe von Optionen kann für jeden Medientyp konfiguriert werden.

Alle Medientypen werden parallel verarbeitet. Während die maximale Anzahl gleichzeitiger Sitzungen pro Medientyp konfigurierbar ist, kann die Gesamtzahl der Alerter-Prozesse auf dem Server nur durch den StartAlerters-Parameter begrenzt werden. Von einem Auslöser erzeugte Alarme werden sequenziell verarbeitet. Daher können mehrere Benachrichtigungen nur dann gleichzeitig verarbeitet werden, wenn sie von mehreren Auslösern erzeugt werden.

Parameter Beschreibung
Gleichzeitige Sitzungen Wählen Sie die Anzahl paralleler Alerter-Sitzungen für den Medientyp aus:
Eine - eine Sitzung
Unbegrenzt - unbegrenzte Anzahl von Sitzungen
Benutzerdefiniert - wählen Sie eine benutzerdefinierte Anzahl von Sitzungen aus
Unbegrenzte/hohe Werte bedeuten mehr parallele Sitzungen und eine höhere Kapazität für das Senden von Benachrichtigungen. Unbegrenzte/hohe Werte sollten in großen Umgebungen verwendet werden, in denen möglicherweise viele Benachrichtigungen gleichzeitig gesendet werden müssen.
Wenn mehr Benachrichtigungen gesendet werden müssen, als gleichzeitige Sitzungen verfügbar sind, werden die verbleibenden Benachrichtigungen in eine Warteschlange gestellt; sie gehen nicht verloren.
Versuche Anzahl der Versuche zum Senden einer Benachrichtigung. Es können bis zu 100 Versuche angegeben werden; der Standardwert ist „3“. Wenn „1“ angegeben ist, sendet Zabbix die Benachrichtigung nur einmal und versucht es bei einem Sendefehler nicht erneut.
Intervall zwischen Versuchen Häufigkeit in Sekunden (0-3600), mit der erneut versucht wird, eine Benachrichtigung zu senden, falls das Senden fehlgeschlagen ist. Wenn „0“ angegeben ist, versucht Zabbix es sofort erneut.
Zeitsuffixe werden unterstützt, z. B. 5s, 3m, 1h.

Benutzermedien

Während Medientypen definieren, wie eine Benachrichtigung gesendet wird, definieren Benutzermedien, wohin die Benachrichtigung gesendet werden muss.

Benutzermedien (z. B. E-Mail-Adresse, webhook-Benutzer-ID usw.) müssen unabhängig von der Zustellmethode im Benutzerprofil definiert werden. Eine Aktion, die Nachrichten mit webhook X an den Benutzer Admin sendet, kann nicht zugestellt werden, wenn die Zustellungsdetails für webhook X nicht im Benutzerprofil von Admin definiert sind.

So definieren Sie Benutzermedien:

  • Gehen Sie zu Benutzer > Benutzer und öffnen Sie das Formular mit den Benutzereigenschaften (oder gehen Sie in Ihrem eigenen Benutzerprofil zu Benutzereinstellungen > Benachrichtigungen)
  • Klicken Sie auf der Registerkarte „Medien“ auf Hinzufügen

Parameter Beschreibung
Type Die Dropdown-Liste enthält die Namen der aktivierten Medientypen.
Beachten Sie, dass beim Bearbeiten eines Mediums eines deaktivierten Medientyps der Typ rot angezeigt wird.
Send to Geben Sie die Kontaktinformationen ein, an die Nachrichten gesendet werden sollen.
Für den Medientyp E-Mail können durch Klicken auf die Schaltfläche unter dem Adressfeld mehrere Adressen hinzugefügt werden. In diesem Fall werden Benachrichtigungen an alle aufgeführten Adressen gesendet. Adressbeispiele finden Sie in der Beschreibung des Parameters Email für den Medientyp email.
When active Sie können den Zeitraum einschränken, in dem Nachrichten gesendet werden, z. B. nur auf Arbeitstage (1-5,09:00-18:00). Beachten Sie, dass diese Einschränkung auf der Zeitzone des Benutzers basiert. Wenn die Zeitzone des Benutzers geändert wird und sich von der Systemzeitzone unterscheidet, muss diese Einschränkung möglicherweise entsprechend angepasst werden, damit keine wichtigen Nachrichten verpasst werden.
Eine Beschreibung des Formats finden Sie auf der Seite Zeitraumspezifikation.
Benutzermakros werden unterstützt.
Use if severity Markieren Sie die Kontrollkästchen der Auslöser-Schweregrade, für die Sie Benachrichtigungen erhalten möchten.
Beachten Sie, dass der Standardschweregrad („Nicht klassifiziert“) aktiviert sein muss, wenn Sie Benachrichtigungen für Nicht-Auslöser-Ereignisse erhalten möchten.
Nach dem Speichern werden die ausgewählten Auslöser-Schweregrade in den entsprechenden Schweregradfarben angezeigt, während nicht ausgewählte ausgegraut dargestellt werden.
Status Status des Benutzermediums.
Aktiviert - wird verwendet.
Deaktiviert - wird nicht verwendet.