Einrichten des Benachrichtigungsprozesses

Sobald Sie Ihre neue Avantra-Instanz konfiguriert und Ihre ersten Systeme hinzugefügt haben, möchten Sie natürlich informiert werden, wenn etwas nicht so ist, wie es sein sollte. Wir tun dies über Benachrichtigungen und der Prozess zur Einrichtung Ihrer ersten Benachrichtigung ist sehr einfach. Für die Zwecke dieser Erstkonfiguration gehen wir davon aus, dass unsere ersten Benachrichtigungen per E-Mail gesendet werden.

Die Einrichtung unserer Benachrichtigungen erfolgt in drei Schritten:

Konfiguration von Avantra zum Senden von E-Mails über Ihren E-Mail-Server
Erstellen eines Output Channel, damit Benachrichtigungen Ihren neu konfigurierten E-Mail-Server verwenden können
Erstellen einer Notification Action, um die Ereignisse auszuwählen, auf die wir reagieren möchten, und sie mit dem Output Channel zu verknüpfen

Konfigurieren Sie Avantra so, dass E-Mails gesendet werden

Führen Sie die folgenden Schritte aus, um einen Mail-Server zu erstellen:

Select Konfiguration Integrationen Wähle den "@Messaging-Dienste" Tab und benutze die Neu Mailserver Option.

Sure, here’s the plain Asciidoc output without additional formatting:

2. Fülle einen #Name#, eine optionale #Beschreibung# aus und wähle einen #Kunden#. Für einen E-Mail-Server, der nicht auf einen bestimmten konfigurierten Kunden beschränkt ist, wähle einfach `ROOT`, andernfalls wähle den entsprechenden Kunden.
+
Wähle entweder `SMTP` oder `SMTPS` aus der #Protokoll#-Auswahlliste.
+
Definiere den Server-Hostname in #Ziel# und optional die #Port#-Nummer.
+
Wähle, ob der Server #TLS# benötigt oder nicht (d.h. die sogenannte `STARTTLS`-Methode).
+
Falls dein E-Mail-Server eine Authentifizierung erfordert, gib bitte einen #Benutzer# und ein #Passwort# ein.

3. Drücke den btn:[Erstellen] Button, um abzuschließen.

Du kannst nun den Mailserver im Feld #Mailserver# des E-Mail {_output-channel} verwenden.

== Erstelle deinen E-Mail-Ausgabekanal

Um einen E-Mail-basierten Ausgabekanal zu erstellen, der einen Benachrichtigungsausgang mit einem E-Mail-Server verknüpft (und alle Konfigurationspunkte, die du möglicherweise benötigst), gehe wie folgt vor:

1. Wähle menu:Konfiguration[Benachrichtigungen, Benachrichtigungen Global].

2. Wähle den "Kanäle"-Tab und benutze die menu:Neu[E-Mail] Option.
+
a. Geben Sie einen #Namen# und optional eine #Beschreibung# ein. Der Name des Ausgabekanals muss eindeutig sein.
b. Wenn Sie den Ausgabekanal auf einen oder mehrere Kunden beschränken möchten, wählen Sie die entsprechenden Elemente aus dem #Customer Filter# aus.
c. Wählen Sie eine oder mehrere der #Supported Action Types# aus.
+
Drücke den btn:[Fertigstellen] Button. Die {_output-channel}-Detailansicht wird automatisch geöffnet.

3. Gib eine gültige Absender-E-Mail-Adresse im Feld #Absender-E-Mail-Adresse# ein, ein Standardwert dafür kann in {_notifier-mail-fromsendername} definiert werden. Ein #Absendername# kann ebenfalls konfiguriert werden, ist jedoch nicht zwingend erforderlich. Wenn detailliertere Kontrolle über den Absender benötigt wird, öffne die Absenderdetails mit dem btn:[Details bearbeiten...] Button, nachdem du den {_output-channel} gespeichert hast. Die `Reply-To` und die `Return-Path` E-Mail-Adresse können dort eingegeben werden.

4. Wähle einen Wert für #Empfänger#.
+
a. If you want this Output Channel to deliver only to a single user, select #Single user#. Choose a User from the #User# drop-down list. You can only select a User that has the "Receive Notification Messages" permission for the Customers selected in #Customer Filter#.
b. If you want this Output Channel to deliver to a group of users, select #Group of users#. You can only select a Group that has a Role containing the "Receive Notification Messages" permission for the Customers selected in #Customer Filter#.
c. If you want this Output Channel to deliver to all Users of the selected Customers (or all Customers) that have the "Receive Notification Messages" permission, select #Users of selected/all customers#.

5. Wähle einen Wert für #Priorität#. Mögliche Werte sind Höchste, Hoch, Normal, Niedrig und Niedrigste. Bitte beachte, dass es vom E-Mail-Client des Empfängers abhängt, wie dieser Wert interpretiert wird. Du kannst auch wählen, die Nachrichten nur als Blindkopien (`BCC`) zu versenden.

6. Definiere den #Betreff# der E-Mail.

7. Um den #E-Mail-Inhalt# zu bearbeiten, drücke den Button #E-Mail-Inhalt bearbeiten...#. Ein Dialog wird geöffnet, in dem die Details des E-Mail-Inhalts bearbeitet werden können. Es ist möglich, entweder HTML- oder Nur-Text-Inhalte zu definieren. Wenn fertig, speichere deine Details und schließe den Dialog.

8. Siehe {_handling-mail-servers}, um zu erfahren, wie man einen Mailserver erstellt, und wähle anschließend einen Mailserver aus der #Mailserver#-Auswahlliste.

9. Drücke den btn:[Speichern] Button.

Du kannst deine Einstellungen testen, indem du den btn:[Test-E-Mail senden] Button drückst.

== Erstelle deine Benachrichtigungsaktion (verknüpfe ein Ereignis mit deinem E-Mail-Ausgang)

1. Wähle menu:Konfiguration[Benachrichtigungen] aus dem Hauptmenü. Wähle den #Aktionen# Tab. Wähle menu:Neu[] in der Symbolleiste. Wähle #Aktion für Checks …# aus der Auswahlliste.

2. Fülle einen #Name# und eine #Beschreibung# aus. Der Name der {_notification-action} muss eindeutig sein.
+
Falls du dies kundenbezogen machen möchtest, kannst du es hier filtern oder die Standardeinstellung verwenden, um es nicht spezifisch zu machen.
+
Schließlich deaktiviere unter #Unterstützte Aktionstypen# alle Optionen außer #Checks (RTM, Tägliche Check-Details)#.
+
Drücke den #Weiter# Button.

3. Jetzt müssen wir definieren, für welche Ereignisse diese Aktion funktioniert. Für die Zwecke dieser ersten Konfiguration werden wir #eine 'Ad-Hoc' benutzerdefinierte Auswahl erstellen#. Sobald du auf #Erstellen# drückst, wirst du aufgefordert, den "Check Selector Type" zu bestätigen, der "RTM & Daily Check Details" sein wird (im Grunde ein Alarm für alles).

a. Drücke den btn:[Erstellen] Button.
b. Wähle den {check_selector}-Typ "RTM & Daily Check Details" aus der Liste und drücke den btn:[Weiter].
c. Fülle die Auswahlkriterien aus, indem du ein einzelnes System ähnlich dem untenstehenden Screenshot auswählst (wir empfehlen den {avantra} Server selbst), drücke den btn:[Test-Selektor] Button, um die Auswahl zu überprüfen, und drücke den btn:[Speichern & Schließen] Button.
+
image::ad-hoc-check-selector-example.png[Ein Beispiel, wie man einen Ad-Hoc-Check-Selektor erstellt]
+
Drücke den btn:[Weiter] Button.

4. Wähle den #Status#, für den du Alarme auslösen möchtest (normalerweise WARNUNG und KRITISCH).
+
Drücke den #Weiter# Button.

5. Wähle im Drop-down-Menü #Ausgabekanal# den Ausgabekanal aus, den du im vorherigen Schritt erstellt hast. Du kannst später mehr über die anderen Optionen erfahren: {defining-filter-lists} und {defining-a-resolver}.

6. Drücke den btn:[Fertigstellen] Button. Die {_notification-action}-Detailansicht öffnet sich.

7. Drücke den btn:[Speichern] Button.

8. Drücke den btn:[Aktivieren] Button, um die gesamte Kette zu aktivieren und mit dem Versenden von Benachrichtigungen zu beginnen.

Du hast nun eine (minimale) {_notification-action} für {_check}s erstellt, die nur aus einer Trigger-Definition und einem {_output-channel} besteht.

[HINWEIS]
====
Die {_notification-action} ist nicht aktiv, es sei denn, du drückst #Aktivieren#.
Du möchtest sie jedoch möglicherweise deaktiviert lassen, bis du sie erfolgreich getestet hast.
====