content-sync - by quick check, formal updates, pick-24

Author: thomaskoslowski

src/common/de/wato_services.asciidoc

@@ -1,5 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE % namen synchronisation →
+// NONASCII
 include::global_attr.adoc[]
 = Services verstehen und konfigurieren
 :title: Services verstehen und konfigurieren - Elemente eines Hosts erkennen und überwachen
@@ -12,6 +13,7 @@ xref:wato_rules#[Regeln]
 {related-end}
 
 
+[#intro]
 == Einleitung
 
 Die Services sind das eigentliche Fleisch im Monitoring-System.
@@ -69,7 +71,7 @@ ohne sich dabei Gedanken machen zu müssen, auf welchen Hosts denn nun
 
 Einige wenige Services können nicht über eine automatische Erkennung eingerichtet werden.
 Dazu gehören z.B. Checks, die per HTTP bestimmte Webseiten abrufen sollen.
-Diese werden per Regeln angelegt; wie, erfahren Sie im Artikel über die xref:active_checks#[aktiven Checks.]
+Diese werden per Regeln angelegt; wie, erfahren Sie im Artikel über die xref:active_checks#[aktiven Checks].
 
 Die Möglichkeiten von {CMK}, sich selber zu überwachen, werden im Artikel xref:self_monitoring#[Das eigene System überwachen] aufgeführt.
 
@@ -170,7 +172,7 @@ image::wato_services_disabled_services_conditions.png[alt="Eingabemaske für Dis
 
 Wenn Sie die Regel speichern und erneut auf die Serviceliste des Hosts gehen,
 finden Sie die stillgelegten Services gemeinsam mit manuell deaktivierten
-Services unter [.guihint]#Disabled services.#
+Services unter [.guihint]#Disabled services#.
 
 image::wato_services_disabled_services.png[alt="Liste mit Services mit unterschiedlichen Status."]
 
@@ -209,7 +211,7 @@ ifdef::onprem[]
 === Besonderheiten bei SNMP
 
 Bei Geräten, die per SNMP überwacht werden, gibt es ein paar Sonderheiten.
-Diese erfahren Sie im xref:snmp#services[Artikel über SNMP.]
+Diese erfahren Sie im xref:snmp#services[Artikel über SNMP].
 endif::[]
 
 
@@ -237,8 +239,6 @@ Unter [.guihint]#Selection# können Sie die Auswahl der Hosts noch mal steuern.
 Das ist vor allem dann sinnvoll, wenn Sie diese nicht per Checkboxen, sondern über den Ordner ausgewählt haben.
 Die meisten Optionen zielen auf eine Beschleunigung der Discovery hin:
 
-// ML: icon_inventory_failed-Icon: Konnte das nicht nachstellen, weiß nicht, ob das richtig ist (rein namentlich passt es nicht ...).
-
 [cols=2]
 |===
 |[.guihint]#Include all subfolders#|Wenn Sie die Service-Erkennung für einen
@@ -253,12 +253,7 @@ Unterordnern des aktuell geöffneten Ordners durchgeführt.
 Die [.guihint]#Performance options# sind so voreingestellt, dass immer ein
 vollständiger Service-Scan durchgeführt wird. Wenn Sie nicht auf neue Plugins
 aus sind, können Sie die Erkennung durch Wegnahme der Option beschleunigen.
-////
-Das Arbeiten ohne Cache-Dateien ist nur in Ausnahmefällen ratsam. Insbesondere bei
-Hosts, die per {CMK}-Agent überwacht werden, kann es dann sogar dazu kommen,
-dass, wenn es der Zufall will, neue Logmeldungen quasi von der Discovery
-„verbraucht“ werden und nicht mehr beim eigentlichen Check ankommen.
-////
+
 Die eingestellte `10` unter [.guihint]#Number of hosts to handle at once#
 bedeutet, dass immer zehn Hosts auf ein mal bearbeitet werden. Intern geschieht
 das mit einem HTTP-Request. Sollten Sie Probleme mit Timeouts haben, weil
@@ -308,6 +303,7 @@ check parameters# einblenden. Das sieht dann etwa so aus:
 image::wato_services_check_parameters.png[]
 
 
+[#customize]
 == Anpassen der Service-Erkennung
 
 Wie Sie die Service-Erkennung konfigurieren, um nicht erwünschte Services auszublenden,
@@ -476,9 +472,6 @@ diese Regel greift. Für die eigentliche Überwachung gibt es jetzt drei Fälle:
 . Der Agent stellt überhaupt keine Informationen bereit, z.B. weil NTP überhaupt nicht installiert ist.
 Dann bleibt der Service auf {PEND} und der Service [.guihint]#Check_MK# geht auf {WARN}, mit dem Hinweis, dass die entsprechende Sektion in den Agentendaten fehlt.
 
-//SK: Benutzen wir das Wort "Modul" noch auf diese Weise in der 2.0.0?
-// ML: Ist an einigen Stellen auch neueren Datums noch so zu lesen, insofern würde ich ja tippen.
-
 Die meisten Regelsätze im Modul [.guihint]#Enforced services# werden Sie nie
 benötigen und sind nur der Vollständigkeit halber vorhanden. Die häufigsten
 Fälle für erzwungene Services sind:
@@ -503,15 +496,14 @@ Dieser Service [.guihint]#Check_MK Discovery# existiert für jeden Host und meld
 
 image::wato_services_discovery_check_warn.png[]
 
-Die Einzelheiten zu den nicht überwachten oder verschwundenen Services finden Sie auf der Seite mit den Details des Services [.guihint]#Check_MK Discovery# im Feld [.guihint]#Details:#
+Die Einzelheiten zu den nicht überwachten oder verschwundenen Services finden Sie auf der Seite mit den Details des Services [.guihint]#Check_MK Discovery# im Feld [.guihint]#Details#:
 
-// ML: Padding in einfacher Fonthöhe fehlt.
 image::wato_services_discovery_check_details.png[]
 
 Zu der Service-Liste des Hosts im Setup gelangen Sie bequem über das icon:icon_menu[] Aktionsmenü des [.guihint]#Check_MK Discovery# Services
-und den Eintrag icon:icon_services[] [.guihint]#Run service discovery.#
+und den Eintrag icon:icon_services[] [.guihint]#Run service discovery#.
 
-Das Parametrieren des Discovery Checks geht sehr einfach über den xref:glossar#rule_set[Regelsatz] [.guihint]#Periodic service discovery.#
+Das Parametrieren des Discovery Checks geht sehr einfach über den xref:glossar#rule_set[Regelsatz] [.guihint]#Periodic service discovery#.
 In einer frischen Instanz werden Sie hier bereits eine global wirksame Regel mit den folgenden Einstellungen vorfinden:
 
 image::wato_services_periodic_service_discovery.png[]
@@ -574,7 +566,7 @@ ifdef::onprem[]
 
 Passive Services sind solche, die nicht von {CMK} aktiv angestoßen werden, sondern bei
 denen regelmäßig von außen neue Check-Ergebnisse eingeschleust werden. Dies geschieht
-in der Regel über die Kommando-Pipe des Cores. Hier ist ein Schritt-für-Schritt-Vorgehen
+in der Regel über die Befehls-Pipe des Cores. Hier ist ein Schritt-für-Schritt-Vorgehen
 für das Einrichten eines passiven Services:
 
 Zunächst müssen Sie den Service dem Kern bekannt machen.
@@ -590,9 +582,9 @@ Nach einem [.guihint]#Activate Changes# beginnt der neue Service sein Leben im Z
 
 image::wato_services_passive_checks_pending.png[]
 
-Das Senden der Check-Ergebnisse geschieht nun auf der Kommandozeile durch
+Das Senden der Check-Ergebnisse geschieht nun auf der Befehlszeile durch
 ein `echo` des Befehls `PROCESS_SERVICE_CHECK_RESULT` in die
-Kommando-Pipe `~/tmp/run/nagios.cmd`.
+Befehls-Pipe `~/tmp/run/nagios.cmd`.
 
 Die Syntax entspricht den bei Nagios üblichen Konventionen -- inklusive eines
 aktuellen Zeitstempels in eckigen Klammern. Als Argumente nach dem Befehl
@@ -614,11 +606,11 @@ endif::[]
 
 ifdef::onprem[]
 [#commandline]
-== Service-Erkennung auf der Kommandozeile
+== Service-Erkennung auf der Befehlszeile
 
-So schön eine GUI ist, so praktisch ist doch manchmal noch die gute alte Kommandozeile --
+So schön eine GUI ist, so praktisch ist doch manchmal noch die gute alte Befehlszeile --
 sei es zum Automatisieren oder einfach zum schnellen Arbeiten für den geübten Benutzer.
-Die Service-Erkennung können Sie auf der Kommandozeile mit dem Befehl `cmk -I` auslösen.
+Die Service-Erkennung können Sie auf der Befehlszeile mit dem Befehl `cmk -I` auslösen.
 Dabei gibt es ein paar verschiedene Spielarten. Bei allen empfehlen wir die Option `-v`,
 damit Sie sehen, was genau passiert. Ohne `-v` verhält sich {CMK} nach guter alter
 Unix-Tradition: Solange alles gut geht, schweigt es.
@@ -705,7 +697,6 @@ Ein komplettes Erneuern der Services (Tabula Rasa) machen Sie mit einem Doppel-
 
 // ES: Code-Block als HTML dargestellt, weil das grüne Highlighting sonst Probleme macht.
 // Für den ursprünglichen Inhalt des Blocks siehe Stand hier: https://github.com/Checkmk/checkmk-docs/blob/4f62bca782353009dda6ddfcfaa3d608b0df6c10/src/common/de/wato_services.asciidoc?plain=1#L710
-
 ++++
 <div class="listingblock"><div class="content"><pre class="pygments highlight"><code data-lang="console"><span></span><span class="tok-gp">OMD[mysite]:~$ </span><span class="tok-plaintext">cmk</span><span class="tok-w"> </span><span class="tok-plaintext">-vII</span><span class="tok-w"> </span><span class="tok-plaintext">myserver01
 </span><span class="tok-go">Discovering services and host labels on: myserver01</span><span class="tok-plaintext">
@@ -739,7 +730,6 @@ lautet `--detect-plugins=` und muss vor dem Host-Namen stehen:
 
 // ES: Code-Block als HTML dargestellt.
 // Ursprünglicher Inhalt des Blocks: https://github.com/Checkmk/checkmk-docs/blob/4f62bca782353009dda6ddfcfaa3d608b0df6c10/src/common/de/wato_services.asciidoc?plain=1#L740
-
 ++++
 <div class="listingblock copybutton"><div class="content"><pre class="pygments highlight"><code data-lang="console"><span></span><span class="tok-gp">OMD[mysite]:~$ </span><span class="tok-plaintext">cmk</span><span class="tok-w"> </span><span class="tok-plaintext">-vII</span><span class="tok-w"> </span><span class="tok-plaintext">--detect-plugins</span><span class="tok-o">=</span><span class="tok-plaintext">df</span><span class="tok-w"> </span><span class="tok-plaintext">myserver01
 </span><span class="tok-go">Discovering services and host labels on: myserver01</span><span class="tok-plaintext">
@@ -965,9 +955,7 @@ Wenn Sie Service-Gruppen in xref:glossar#notification[Benachrichtigungen]
 ifdef::onprem[]
 und xref:alert_handlers#[Alert Handlers]
 endif::[]
-nutzen, stehen sie als
-xref:wato_rules#conditions[Bedingungen/Filter] zur Verfügung, von denen Sie
-einen oder mehrere nutzen können:
+nutzen, stehen sie als xref:wato_rules#conditions[Bedingungen/Filter] zur Verfügung, von denen Sie einen oder mehrere nutzen können:
 
 image::wato_services_servicegroups_notification_rule.png[]
 

src/common/en/wato_services.asciidoc

@@ -1,5 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE % synchronisation →
+// NONASCII
 include::global_attr.adoc[]
 = Understanding and configuring services
 :title: Understanding and configuring services - Detecting and monitoring elements of a host
@@ -12,6 +13,7 @@ xref:wato_rules#[Rules]
 {related-end}
 
 
+[#intro]
 == Introduction
 
 Services are the actual ‘substance’ of a monitoring system. Each one represents an important
@@ -70,6 +72,8 @@ A few services can’t be installed using an automatic discovery.
 Among these are e.g., checks queried per HTTP-specified websites.
 These are created via rules, as you can learn about in the article about xref:active_checks#[active checks].
 
+The possibilities for {CMK} to monitor itself are listed in the article xref:self_monitoring#[Monitoring your own system].
+
 
 [#discovery]
 == Host services in the Setup
@@ -250,16 +254,10 @@ will be run on all hosts of all subfolder, as well.
 |[.guihint]#Exclude hosts where the agent is unreachable# |Hosts that are not accessible cause long delays during discovery due to connection timeouts. This can greatly impede a discovery’s performance on larger numbers of hosts. If the hosts are already in monitoring -- and it knows that the hosts are {DOWN} -- you can bypass them here and thus avoid the timeouts.
 |===
 
-
 The [.guihint]#Performance Options# are predefined so that a [.guihint]#full
 service scan# will be performed. If you are not interested in new
 plug-ins a discovery can be greatly accelerated by not choosing this option.
-////
-Working without cache data is only advisable in exceptional cases. Especially
-for hosts that are monitored using {CMK} agents -- as luck will have
-it -- it can occur that log messages are ‘consumed’ by the discovery and not
-be received by the production check.
-////
+
 The `10` set in [.guihint]#Number of hosts to handle at once# means that
 ten hosts are always processed in one action. This is achieved internally
 with an HTTP request. If you encounter timeout problems due to some hosts
@@ -308,6 +306,7 @@ look something like this:
 image::wato_services_check_parameters.png[]
 
 
+[#customize]
 == Customizing the service discovery
 
 We have xref:disabled_services[earlier] shown how you can configure the
@@ -913,7 +912,7 @@ image::wato_services_servicegroups_service_detail.png[]
 
 As already mentioned, the service groups are used in several places, like
 ifdef::onprem[]
-xref:views#[views], NagVis maps, xref:glossar#notification[notifications] and xref:alert_handlers#[alert handlers.]
+xref:views#[views], NagVis maps, xref:glossar#notification[notifications] and xref:alert_handlers#[alert handlers].
 endif::[]
 ifdef::saas[]
 xref:views#[views] and xref:glossar#notification[notifications].
@@ -934,12 +933,9 @@ groups opened in a menu by hovering over a single icon:
 image::wato_services_servicegroups_nagvis_example.png[]
 endif::[]
 
-When you use service groups in
-ifdef::onprem[]
-xref:glossar#notification[notifications] and xref:alert_handlers#[alert handlers],
-endif::[]
+When you use service groups in xref:glossar#notification[notifications]
 ifdef::onprem[]
-xref:glossar#notification[notifications],
+and xref:alert_handlers#[alert handlers],
 endif::[]
 they are available as xref:wato_rules#conditions[conditions/filters], of which you can use one or more: