dictionary and formal updates, pick-25

Author: thomaskoslowski

src/onprem/de/ec.asciidoc

@@ -1,5 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE +1 Addons Eventlog Finetune Logfile cancelling logfile logfiles
+// NONASCII
 include::global_attr.adoc[]
 = Die Event Console
 :title: Die Event Console - Logs und SNMP-Traps in {CMK} verarbeiten
@@ -12,6 +13,7 @@ xref:livestatus#[Statusdaten abrufen via Livestatus]
 {related-end}
 
 
+[#intro]
 == Einleitung
 
 === Ereignisse sind keine Zustände
@@ -129,6 +131,7 @@ Initializing Crontab...OK
 ----
 
 
+[#first_steps]
 == Erste Schritte mit der Event Console
 
 [#first_steps_rules]
@@ -143,7 +146,7 @@ Aber was jetzt WARN und CRIT ist, wurde bei der Programmierung dieser Klassifizi
 Und es ist noch nicht einmal gesagt, dass die Anwendung, welche die Meldung produziert hat, auf diesem Rechner überhaupt wichtig ist.
 Kurzum: Sie kommen nicht drumherum, selbst zu konfigurieren, welche Meldungen für Sie nach einem Problem aussehen und welche einfach verworfen werden können.
 
-Wie überall in {CMK} erfolgt auch hier die Konfiguration über xref:glossar#rule[Regeln,] welche bei jeder eingehenden Meldung von der EC nach dem „first match“-Prinzip abgearbeitet werden.
+Wie überall in {CMK} erfolgt auch hier die Konfiguration über xref:glossar#rule[Regeln], welche bei jeder eingehenden Meldung von der EC nach dem „first match“-Prinzip abgearbeitet werden.
 Die erste Regel, die auf eine eingehende Meldung greift, entscheidet also über deren Schicksal.
 Greift keine Regel, so wird die Meldung einfach lautlos verworfen.
 
@@ -275,7 +278,7 @@ Auch hier ist es übrigens möglich, im Syslog-Format zu senden, damit alle Feld
 [#globalsettings]
 === Einstellungen der Event Console
 
-Die Event Console hat ihre eigenen globalen Einstellungen, welche Sie nicht bei denen der anderen Module finden, sondern unter [.guihint]#Setup > Events > Event Console# mit dem Knopf [.guihint]#Settings.#
+Die Event Console hat ihre eigenen globalen Einstellungen, welche Sie nicht bei denen der anderen Module finden, sondern unter [.guihint]#Setup > Events > Event Console# mit dem Knopf [.guihint]#Settings#.
 
 image::ec_settings.png[]
 
@@ -319,7 +322,7 @@ Am flexibelsten ist die Arbeit mit xref:regexes#[regulären Ausdrücken], welche
 Insbesondere, wenn zwar Host-Namen eineindeutig sind, aber nur der in {CMK} mitverwendete Domain-Teil fehlt, hilft eine simple Regel: `(.*)` wird zu `\1.mydomain.test`. 
 In Fällen, wo das alles nicht genügt, können Sie noch mit [.guihint]#Explicit hostname mapping# eine Tabelle von einzelnen Namen und deren jeweiliger Übersetzung angeben.
 
-*Wichtig:* Die Namensumwandlung geschieht bereits *vor* dem Prüfen der Regelbedingungen und somit lange vor einem möglichen Umschreiben des Host-Namens durch die Regelaktion [.guihint]#Rewrite hostname# beim xref:rewriting[automatischen Umschreiben von Texten.]
+*Wichtig:* Die Namensumwandlung geschieht bereits *vor* dem Prüfen der Regelbedingungen und somit lange vor einem möglichen Umschreiben des Host-Namens durch die Regelaktion [.guihint]#Rewrite hostname# beim xref:rewriting[automatischen Umschreiben von Texten].
 
 Etwas einfacher ist die Zuordnung bei xref:snmp#[SNMP].
 Hier wird die IP-Adresse des Senders mit den zwischengespeicherten IP-Adressen der Hosts im Monitoring verglichen, d.h. sobald regelmäßige aktive Checks vorhanden sind, wie Erreichbarkeitsprüfung des Telnet- oder SSH-Ports eines Switches, werden per SNMP versandte Statusmeldungen dieses Gerätes dem korrekten Host zugeordnet.
@@ -331,7 +334,7 @@ Hier wird die IP-Adresse des Senders mit den zwischengespeicherten IP-Adressen d
 === Event-Ansichten
 
 Von der Event Console erzeugte Events werden analog zu Hosts und Services in der xref:glossar#monitoring_environment[Monitoring-Umgebung] angezeigt. 
-Den Einstieg dazu finden Sie im [.guihint]#Monitor#-Menü unter [.guihint]#Event Console > Events:#
+Den Einstieg dazu finden Sie im [.guihint]#Monitor#-Menü unter [.guihint]#Event Console > Events#:
 
 image::ec_open_events_hilites.png[]
 
@@ -1083,7 +1086,7 @@ echo "$OMD_ROOT/local/bin/myaction '$HOST$' '$TEXT$' | at now
 ==== Versenden von E-Mails
 
 Der Aktionstyp [.guihint]#Send Email# versendet eine einfache Text-E-Mail.
-Eigentlich könnten Sie das auch über den Umweg mit einem Skript erreichen, indem Sie z.B. mit dem Kommandozeilenbefehl `mail` arbeiten.
+Eigentlich könnten Sie das auch über den Umweg mit einem Skript erreichen, indem Sie z.B. mit dem Befehl `mail` arbeiten.
 Aber so ist es komfortabler.
 Beachten Sie, dass auch in den Feldern [.guihint]#Recipient E-Mail address# und [.guihint]#Subject# Platzhalter erlaubt sind.
 
@@ -1394,7 +1397,7 @@ Hinweise zu den MIBs:
 // * Die hochgeladenen Dateien werden unter `local/share/snmp/mibs` abgelegt. Dort können Sie sie auch von Hand ablegen, wenn Ihnen der Weg über die GUI zu umständlich ist.
 * Anstelle von Einzeldateien können Sie auch ZIP-Dateien mit MIBs-Sammlungen in einem Rutsch hochladen.
 * MIBs haben untereinander Abhängigkeiten. Fehlende MIBs werden Ihnen von {CMK} angezeigt.
-* Die hochgeladenen MIBs werden auch auf der Kommandozeile von `cmk --snmptranslate` verwendet.
+* Die hochgeladenen MIBs werden auch auf der Befehlszeile von `cmk --snmptranslate` verwendet.
 
 
 [#logwatch]
@@ -1474,7 +1477,7 @@ Hier ist ein Fall mit offenen Events im Zustand {CRIT}:
 
 image::ec_events_check_crit.png[]
 
-Diesen aktiven Check erzeugen Sie durch eine Regel im Regelsatz [.guihint]#Check event state in Event Console.#
+Diesen aktiven Check erzeugen Sie durch eine Regel im Regelsatz [.guihint]#Check event state in Event Console#.
 Dabei können Sie auch angeben, ob bereits quittierte Events noch zum Status beitragen sollen oder nicht:
 
 image::ec_check_remote.png[]
@@ -1818,14 +1821,15 @@ image::ec_graph_processing_time.png[]
 Daneben gibt es noch etliche weitere Diagramme.
 
 
+[#distributed]
 == Verteiltes Monitoring
 
 Wie Sie die Event Console in einer Installation mit mehreren {CMK}-Instanzen einsetzen, erfahren Sie im xref:distributed_monitoring#ec[Artikel über das verteilte Monitoring].
 
 [#statusinterface]
 == Die Statusschnittstelle
 
-Die Event Console bietet über das Unix-Socket `~/tmp/run/mkeventd/status` sowohl Zugriff auf den internen Status als auch die Möglichkeit, Kommandos auszuführen.
+Die Event Console bietet über das Unix-Socket `~/tmp/run/mkeventd/status` sowohl Zugriff auf den internen Status als auch die Möglichkeit, Befehle auszuführen.
 Das hier verwendete Protokoll ist eine stark eingeschränkte Teilmenge von xref:glossar#livestatus[Livestatus].
 Auf diese Schnittstelle greift der Monitoring-Kern zu und reicht die Daten an die GUI durch, um so ein xref:distributed_monitoring#[verteiltes Monitoring] auch für die Event Console zu ermöglichen.
 
@@ -1843,21 +1847,21 @@ Folgende Tabellen sind verfügbar:
 |`status` |Status- und Performancewerte der EC. Diese Tabelle hat immer genau eine Zeile.
 |===
 
-Kommandos können Sie mithilfe von `unixcat` mit einer sehr einfachen Syntax in das Socket schreiben:
+Befehle können Sie mithilfe von `unixcat` mit einer sehr einfachen Syntax in das Socket schreiben:
 
 [{shell}]
 ----
 {c-omd} echo "COMMAND RELOAD" | unixcat tmp/run/mkeventd/status
 ----
 
-Folgende Kommandos sind verfügbar:
+Folgende Befehle sind verfügbar:
 
 [cols="20,~"]
 |===
 |`DELETE` |Archiviert ein Event. Argumente: Event-ID und Benutzerkürzel.
 |`RELOAD` |Neuladen der Konfiguration.
 |`SHUTDOWN` |Beendet die Event Console.
-|`REOPENLOG` |Die Log-Datei wird neu geöffnet. Dieses Kommando wird von der Log-Dateirotation benötigt.
+|`REOPENLOG` |Die Log-Datei wird neu geöffnet. Dieser Befehl wird von der Log-Dateirotation benötigt.
 |`FLUSH` |Löscht alle aktuellen und archivierten Events.
 |`SYNC` |Löst ein sofortiges Aktualisieren der Datei `~/var/mkeventd/status` aus.
 |`RESETCOUNTERS` |Setzt die Trefferzähler der Regeln zurück (entspricht dem Menüeintrag [.guihint]#Event Console > Reset counters# in der Setup-GUI).
@@ -1867,6 +1871,7 @@ Folgende Kommandos sind verfügbar:
 |===
 
 
+[#files]
 == Dateien und Verzeichnisse
 
 [cols="50,~",options="header"]
@@ -1881,6 +1886,6 @@ Folgende Kommandos sind verfügbar:
 |`tmp/run/mkeventd/events` |Eine _named pipe_, in die Sie mit `echo` oder anderen Befehlen direkt Meldungen schreiben können, um diese an die EC zu übergeben. Achten Sie darauf, dass zu jedem Zeitpunkt nur eine einzige Anwendung in diese Pipe schreibt, da sich die Texte der Meldungen sonst vermischen können.
 |`tmp/run/mkeventd/eventsocket` |Ein Unix-Socket, das die gleiche Aufgabe wie die Pipe erfüllt, aber ein gleichzeitiges Schreiben mehrerer Anwendungen ermöglicht. Zum Hineinschreiben benötigen Sie den Befehl `unixcat` oder `socat`.
 |`tmp/run/mkeventd/pid` |Die aktuelle Prozess-ID des Event Daemons während dieser läuft.
-|`tmp/run/mkeventd/status` |Ein Unix-Socket, das die Abfrage des aktuellen Status und das Senden von Kommandos erlaubt. Die Anfragen der GUI gehen zunächst zum Monitoring-Kern, der dann auf diesen Socket zugreift.
+|`tmp/run/mkeventd/status` |Ein Unix-Socket, das die Abfrage des aktuellen Status und das Senden von Befehlen erlaubt. Die Anfragen der GUI gehen zunächst zum Monitoring-Kern, der dann auf diesen Socket zugreift.
 |`local/share/snmp/mibs` |Von Ihnen hochgeladene MIB-Dateien für die Übersetzung von SNMP-Traps.
 |===

src/onprem/en/ec.asciidoc

@@ -1,5 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE +1 Addons Eventlog Finetune Logfile cancelling logfile logfiles pre
+// NONASCII
 include::global_attr.adoc[]
 = The Event Console
 :title: The Event Console - Processing logs and SNMP traps
@@ -12,6 +13,7 @@ xref:livestatus#[Retrieving status data via Livestatus]
 {related-end}
 
 
+[#intro]
 == Introduction
 
 === Events are not states
@@ -127,6 +129,7 @@ Initializing Crontab...OK
 ----
 
 
+[#first_steps]
 == The first steps with the Event Console
 
 [#first_steps_rules]
@@ -141,7 +144,7 @@ But what WARN and CRIT actually mean can be defined subjectively by their progra
 And it can't even be definitely said that the application which has produced the message is even important on this computer.
 In short: You cannot get around needing to configure which messages look like a real problem to you and which ones can simply be discarded.
 
-As everywhere in {CMK}, the configuration is performed via xref:glossar#rule[rules,] which are processed by the EC for each incoming message according to the 'first match' principle.
+As everywhere in {CMK}, the configuration is performed via xref:glossar#rule[rules], which are processed by the EC for each incoming message according to the 'first match' principle.
 The first rule which is applied to an incoming message decides its fate.
 If no rule is applied, the message will simply be silently discarded.
 
@@ -327,7 +330,7 @@ Here the IP address of the sender is compared with the cached IP addresses of th
 === Event views
 
 Events generated by the Event Console are displayed analogously to hosts and services in the xref:glossar#monitoring_environment[monitoring environment]. 
-You can find the entry point for this in the [.guihint]#Monitor# menu under [.guihint]#Event Console > Events:#
+You can find the entry point for this in the [.guihint]#Monitor# menu under [.guihint]#Event Console > Events#:
 
 image::ec_open_events_hilites.png[]
 
@@ -1070,7 +1073,7 @@ echo "$OMD_ROOT/local/bin/myaction '$HOST$' '$TEXT$' | at now
 ==== Sending emails
 
 The [.guihint]#Send Email# action type sends a simple text email.
-You could actually also do this with a script, for instance by using the `mail` command line command.
+You could actually also do this with a script, for instance by using the `mail` command.
 But this way it is more convenient.
 Note that placeholders are also allowed in the [.guihint]#Recipient email address# and [.guihint]#Subject# fields.
 
@@ -1508,7 +1511,7 @@ The archive contains the following action types which are displayed in the [.gui
 === Location of the archive
 
 As mentioned above, the Event Console archive has not been designed as a fully-fledged syslog archive.
-To keep the implementation and especially the administration as simple as possible, a database back-end has been omitted.
+To keep the implementation and especially the administration as simple as possible, a database backend has been omitted.
 Instead the archive is written to simple text files.
 Each entry consists of one line of text, which contains columns separated by tabs.
 You can find the files in `~/var/mkeventd/history`:
@@ -1781,6 +1784,7 @@ image::ec_graph_processing_time.png[]
 There are also quite a few additional graphs.
 
 
+[#distributed]
 == Distributed monitoring
 
 How to use the Event Console in an installation with multiple {CMK} sites, see the xref:distributed_monitoring#ec[article on distributed monitoring].
@@ -1830,6 +1834,7 @@ The following commands are available:
 |===
 
 
+[#files]
 == Files and directories 
 
 [cols="50,~",options="header"]