updating intro to 2.5.0, pick-25

Author: thomaskoslowski

src/common/de/intro_notifications.asciidoc

@@ -39,7 +39,7 @@ Manche Anwender verzichten auf Benachrichtigungen, da Sie einen Leitstand haben,
 Beobachten Sie mindestens ein paar Tage, wie groß das Volumen an Benachrichtigungen ist.
 
 * Aktivieren Sie die Benachrichtigungen für andere Benutzer erst dann, wenn Sie die Fehlalarme (_false positives_) auf ein Minimum reduziert haben.
-Was Sie dafür tun können, haben wir im xref:intro_finetune#[Kapitel über die Feinjustierung des Monitorings] beschrieben.
+Was Sie dafür tun können, steht im xref:intro_finetune#[Kapitel über die Feinjustierung des Monitorings].
 
 
 ifdef::onprem[]
@@ -52,7 +52,7 @@ In einer E-Mail ist genug Platz, um auch die Graphen von Metriken mitzusenden.
 Bevor Sie per E-Mail benachrichtigen können, muss Ihr {CMK}-Server für das Versenden von E-Mails eingerichtet sein.
 Bei allen unterstützten Linux-Distributionen läuft das auf Folgendes hinaus:
 
-. Installieren Sie einen SMTP-Serverdienst.
+. Installieren Sie einen SMTP-Serverdienst (z.B. Postfix).
 Dies geschieht meist automatisch bei der Installation der Distribution.
 
 . Geben Sie einen *Smarthost* an.
@@ -70,7 +70,9 @@ Wenn der E-Mail-Versand korrekt eingerichtet ist, sollten Sie in der Lage sein,
 
 Die E-Mail sollte ohne Verzögerung zugestellt werden.
 Falls das nicht klappt, finden Sie Hinweise in der Logdatei des SMTP-Servers im Verzeichnis `/var/log/`.
+
 Mehr Details zum Einrichten des E-Mail-Versands unter Linux finden Sie im xref:notification_rules#smtp[Artikel über Benachrichtigungsregeln].
+Hilfreich ist außerdem der Blog-Artikel link:https://checkmk.com/de/blog/set-postfix-relay-checkmks-notifications[Einrichten von Postfix zum Weiterleiten von {CMK}-Benachrichtigungen^].
 endif::[]
 
 
@@ -117,7 +119,8 @@ Einfacher geht das mit [.guihint]#Test notifications#, einem Werkzeug, mit dem S
 Öffnen Sie zuerst mit [.guihint]#Setup > Events > Notifications# die Benachrichtigungszentrale:
 
 ifdef::onprem[]
-image::intro_notifications.png[alt="Einstiegsseite im Setup für die Benachrichtigungen."]
+.Die Benachrichtigungszentrale von {CMK} in einer neu erstellten Instanz
+image::intro_notifications.png[alt="Einstiegsseite im Setup für die Benachrichtigungen.",fullscreen=1]
 
 Wenn Sie diese Seite das erste Mal aufrufen, werden Sie über die noch nicht konfigurierte „Fallback-E-Mail-Adresse" informiert, wie im vorherigen Screenshot zu sehen ist.
 Diese Information können Sie im Moment ignorieren.
@@ -134,7 +137,8 @@ Als „wichtig“ werden dabei alle Zustandswechsel von Hosts nach {DOWN} und {U
 endif::[]
 
 ifdef::saas[]
-image::intro_notifications_saas.png[alt="Einstiegsseite im Setup für die Benachrichtigungen."]
+.Die Benachrichtigungszentrale von {CMK} in einer neu erstellten Instanz
+image::intro_notifications_saas.png[alt="Einstiegsseite im Setup für die Benachrichtigungen.",fullscreen=1]
 
 Diese Seite zeigt Statusinformationen -- wie die Zahl gesendeter und fehlgeschlagener Benachrichtigungen -- und dient zum Aufruf von Aktionen rund um das Thema Benachrichtigungen, z. B. der Erstellung einer Benachrichtigungsregel, aber auch dem Aufruf von Host- und Service-Regeln, die Benachrichtigungen beeinflussen können.
 
@@ -154,7 +158,15 @@ endif::[]
 Beim Benachrichtigungstest werden die angezeigten Benachrichtigungsregeln ausgewertet.
 Sie öffnen den Benachrichtigungstest mit dem Knopf [.guihint]#Test notifications#:
 
+ifdef::onprem[]
+.Vor dem Test muss ein Host ausgewählt werden
 image::intro_test_notifications.png[alt="Dialog zur Festlegung der Eigenschaften der simulierten Benachrichtigung."]
+endif::[]
+
+ifdef::saas[]
+.Vor dem Test muss ein Host ausgewählt werden
+image::intro_test_notifications_saas.png[alt="Dialog zur Festlegung der Eigenschaften der simulierten Benachrichtigung."]
+endif::[]
 
 Wählen Sie einfach einen Host aus und dann als Ereignis einen beliebigen Zustandswechsel.
 Durch Aktivieren der Checkbox [.guihint]#Trigger notification for a specific method# legen Sie fest, dass die Benachrichtigung nicht nur simuliert, sondern auch tatsächlich versendet wird.
@@ -163,28 +175,33 @@ Klicken Sie auf [.guihint]#Test notifications#.
 Die Ergebnisse werden unten auf der Seite eingeblendet.
 Am wichtigsten ist die erste Zusammenfassung [.guihint]#Test results#:
 
+.Die Zusammenfassung der Testergebnisse
 image::intro_test_notifications_result1.png[alt="Die Zusammenfassung zum Test der simulierten Benachrichtigung."]
 
 Für einen erfolgreichen Test muss zumindest eine Benachrichtigungsregel greifen.
-Die Zeile mit `notification has been triggered.` am Ende zeigt an, dass die Benachrichtigung auch tatsächlich versendet wurde.
+Die Zeile mit `notification has been triggered` am Ende zeigt an, dass die Benachrichtigung auch tatsächlich versendet wurde.
 
 Unter [.guihint]#Predicted notifications# sehen Sie dann, an wen und über welchen Weg die Benachrichtigung abgesetzt wurde:
 
 ifdef::onprem[]
+.Empfänger und Methode der simulierten Benachrichtigung
 image::intro_test_notifications_result2.png[alt="Die resultierende Benachrichtigung zur Simulation."]
 endif::[]
 
 ifdef::saas[]
+.Empfänger und Methode der simulierten Benachrichtigung
 image::intro_test_notifications_result2_saas.png[alt="Die resultierende Benachrichtigung zur Simulation."]
 endif::[]
 
 Im untersten Kasten wird schließlich in der ersten Spalte angezeigt, welche der Benachrichtigungsregeln gegriffen hat icon:icon_checkmark[alt="Symbol zur Anzeige eines positiven Status."] und welche nicht icon:icon_hyphen[alt="Symbol zur Anzeige eines negativen Status."]:
 
 ifdef::onprem[]
+.Anzeige, welche der Benachrichtigungsregeln angewendet wurden
 image::intro_test_notifications_result3.png[alt="Für jede Benachrichtigungsregel wird angezeigt, ob sie gegriffen hat."]
 endif::[]
 
 ifdef::saas[]
+.Anzeige, welche der Benachrichtigungsregeln angewendet wurden
 image::intro_test_notifications_result3_saas.png[alt="Für jede Benachrichtigungsregel wird angezeigt, ob sie gegriffen hat."]
 endif::[]
 
@@ -222,13 +239,7 @@ Diese werden auf der Seite [.guihint]#Monitor > System > Failed notifications# a
 Die Spalte [.guihint]#Summary# zeigt den Grund des Fehlers -- oder gibt Ihnen zumindest einen Hinweis auf die Ursache.
 
 Eine weitere Möglichkeit bietet Ihnen {CMK} durch die Analyse der letzten Benachrichtigungen, die das System erzeugt hat, und die die Benachrichtigungsregeln durchlaufen haben.
-ifdef::onprem[]
 Die Tabelle der Benachrichtigungen für die Analyse öffnen Sie mit [.guihint]#Setup > Events > Analyze recent notifications#.
-endif::[]
-ifdef::saas[]
-Die Tabelle der Benachrichtigungen für die Analyse öffnen Sie mit [.guihint]#Setup > Events > Notifications#.
-Klicken Sie auf dieser Seite [.guihint]#Show analysis#.
-endif::[]
 Hier können Sie eine Benachrichtigung erneut senden, sich deren Kontext anzeigen lassen und die zugehörigen Benachrichtigungsregeln analysieren lassen.
 Mehr Information dazu finden Sie im Artikel zu den xref:notifications#rule_analysis[Benachrichtigungen].
 
@@ -240,6 +251,7 @@ Dort finden Sie alle Ereignisse zu Benachrichtigungen für diesen Service chrono
 ifdef::onprem[]
 Hier ist ein Beispiel eines Services, für den die Benachrichtigung versucht wurde, aber der E-Mail-Versand gescheitert ist, weil kein SMTP-Server installiert ist.
 
+.Chronologie der Benachrichtigungen für einen Service
 image::intro_service_notifications.png[alt="Liste der Ereignisse zu Benachrichtigungen für einen Service."]
 
 Noch mehr Informationen finden Sie in der Datei `~/var/log/notifiy.log`.

src/common/en/intro_notifications.asciidoc

@@ -39,7 +39,7 @@ Some users do without the notifications because they have a control center that
 Observe over at least a few days how large the number of notifications is.
 
 * Do not activate notifications for other users until you have reduced the false alarms (_false positives_) to a minimum.
-We have described how you can do this in the xref:intro_finetune#[chapter on fine-tuning monitoring].
+For information on how you can do this, see xref:intro_finetune#[chapter on fine-tuning monitoring].
 
 
 ifdef::onprem[]
@@ -52,7 +52,7 @@ There is enough space in an email to also include the graphs of metrics as well.
 Before you can notify by email, your {CMK} server must be set up for sending emails.
 For all supported Linux distributions, this boils down to the following:
 
-. Install an SMTP server service.
+. Install an SMTP server service (e.g., Postfix).
 This is usually done automatically during the installation of the distribution.
 
 . Specify a *smarthost*.
@@ -70,7 +70,9 @@ If the mail dispatch has been set up correctly, you should be able to send an em
 
 The email should be delivered without delay.
 If this does not work, you will find clues as to the source of the problem in the SMTP server's log file in the `/var/log/` directory.
+
 More details on setting up mail delivery under Linux can be found in the xref:notification_rules#smtp[article on notification rules].
+You may also find the blog post link:https://checkmk.com/blog/set-postfix-relay-checkmks-notifications[Set up Postfix to relay {CMK}'s notifications^] helpful.
 endif::[]
 
 
@@ -117,7 +119,8 @@ This is easier with [.guihint]#Test notifications#, a tool with which you can si
 First open the notification center with [.guihint]#Setup > Events > Notifications#:
 
 ifdef::onprem[]
-image::intro_notifications.png[alt="Entry page in the setup for the notifications."]
+.The {CMK} notification center in a newly created site
+image::intro_notifications.png[alt="Entry page in the setup for the notifications.",fullscreen=1]
 
 When you call up this page for the first time, you will be informed about the 'fallback email address' that has not yet been configured, as can be seen in the above screenshot.
 This information can be ignored for the moment.
@@ -134,7 +137,8 @@ All status changes of hosts to {DOWN} and {UP}, and of services to {CRIT}, {WARN
 endif::[]
 
 ifdef::saas[]
-image::intro_notifications_saas.png[alt="Intro page in the setup for the notifications."]
+.The {CMK} notification center in a newly created site
+image::intro_notifications_saas.png[alt="Entry page in the setup for the notifications.",fullscreen=1]
 
 This page shows status information -- such as the number of sent and failed notifications -- and it is used to call up actions relating to the topic of notifications, e.g. the creation of a notification rule, but also the calling up of host and service rules that can influence notifications.
 
@@ -154,7 +158,15 @@ endif::[]
 The notification test evaluates the notification rules displayed.
 You can access the notification test via [.guihint]#Setup > Events > Notifications# and the [.guihint]#Test notifications# button:
 
+ifdef::onprem[]
+.A host must be selected before the test
 image::intro_test_notifications.png[alt="Dialog for defining the properties of the simulated notification."]
+endif::[]
+
+ifdef::saas[]
+.A host must be selected before the test
+image::intro_test_notifications_saas.png[alt="Dialog for defining the properties of the simulated notification."]
+endif::[]
 
 Simply select a host and then any state change as the event.
 By activating the [.guihint]#Trigger notification for a specific method# checkbox, you specify that the notification is not only simulated but also actually sent.
@@ -163,6 +175,7 @@ Click on [.guihint]#Test notifications#.
 The results are displayed at the bottom of the page.
 The most important is the summary [.guihint]#Test results# at the top:
 
+.The summary of the test results
 image::intro_test_notifications_result1.png[alt="The summary for testing the simulated notification."]
 
 For the test to be successful, at least one notification rule must match.
@@ -171,20 +184,24 @@ The message containing [.guihint]#notification has been triggered# indicates tha
 Under [.guihint]#Predicted notifications# you can then see to whom and via which channel the notification was sent:
 
 ifdef::onprem[]
+.Recipient and method of the simulated notification
 image::intro_test_notifications_result2.png[alt="The resulting notification for the simulation."]
 endif::[]
 
 ifdef::saas[]
+.Recipient and method of the simulated notification
 image::intro_test_notifications_result2_saas.png[alt="The resulting notification for the simulation."]
 endif::[]
 
 Finally, the first column in the bottom field shows which of the notification rules has taken effect icon:icon_checkmark[alt="Symbol for displaying a positive status."], and which has not icon:icon_hyphen[alt="Symbol for displaying a negative status. "]:
 
 ifdef::onprem[]
+.Indication which notification rules were applied
 image::intro_test_notifications_result3.png[alt="For each notification rule, it is displayed whether it has taken effect."]
 endif::[]
 
 ifdef::saas[]
+.Indication which notification rules were applied
 image::intro_test_notifications_result3_saas.png[alt="For each notification rule, it is displayed whether it has taken effect."]
 endif::[]
 
@@ -222,13 +239,7 @@ These are listed on the [.guihint]#Monitor > System > Failed notifications# page
 The [.guihint]#Summary# column shows the reason for the error -- or at least gives you an indication of the probable cause.
 
 Another possibility is offered by {CMK} by analyzing the most recent notifications that the system has generated and which have passed through the notification rules.
-ifdef::onprem[]
 Open the table of notifications for analysis with [.guihint]#Setup > Events > Analyze recent notifications#.
-endif::[]
-ifdef::saas[]
-Open the table of notifications for analysis with [.guihint]#Setup > Events > Notifications#.
-On this page, click [.guihint]#Show analysis#.
-endif::[]
 Here you can resend a notification, display its context and analyze its associated notification rules.
 You can find more information on this in the article on xref:notifications#rule_analysis[notifications].
 
@@ -240,6 +251,7 @@ There you will find all notification events for this service listed chronologica
 ifdef::onprem[]
 Here is an example of a service for which notification was attempted, but for which the sending of emails failed because no SMTP server has been installed.
 
+.Timeline of notifications for a service
 image::intro_service_notifications.png[alt="List of notification events for a service."]
 
 You can find even more information in the file `~/var/log/notifiy.log`.