content-sync - KNW-1944 translation finished, pick-24

Author: thomaskoslowski

src/onprem/de/devel_check_plugins.asciidoc

@@ -1,9 +1,11 @@
 // -*- coding: utf-8 -*-
 // IGNORE % 1000er 1024er check_mk →
+// NONASCII
 include::global_attr.adoc[]
 = Agentenbasierte Check-Plugins entwickeln
 :title: Agentenbasierte Check-Plugins entwickeln
 :description: Bei Bedarf können Sie Ihre eigenen agentenbasierten {CMK}-Plugins mit Python entwickeln. Lesen Sie hier, wie Sie ein Plugin selbst erstellen und nutzen.
+:experimental:
 
 {related-start}
 xref:devel_intro#[Erweiterungen für {CMK} entwickeln]
@@ -50,7 +52,7 @@ In der {CMK}-Version {current-major} ist die Check-API V2 die aktuelle Version.
 Wir zeigen Ihnen in diesem Artikel, wie Sie die Check-API Version 2 für die Plugin-Programmierung nutzen können.
 Hinweise zum Umstieg auf die Check-API Version 2 finden Sie am Ende dieses Artikels im Kapitel xref:migration[Migration.]
 
-Über die {CMK}-Benutzeroberfläche haben Sie jederzeit Zugriff auf die Dokumentation der Check-API: [.guihint]#Help > Developer resources > Plugin API references.#
+Über die {CMK}-Benutzeroberfläche haben Sie jederzeit Zugriff auf die Dokumentation der Check-API: [.guihint]#Help > Developer resources > Plugin API references#.
 Wählen Sie im neuen Browserfenster in der linken Navigationsleiste [.guihint]#Agent based ("Check API") > Version 2# aus:
 
 [{image-border}]
@@ -302,7 +304,7 @@ Rufen Sie als `root` den Befehl `check_mk_agent` auf:
 Irgendwo in der sehr langen Ausgabe muss die neue Sektion erscheinen.
 Agentenplugins werden vom Agenten zum Schluss ausgegeben.
 
-Durch Anhängen von `less` können Sie in der Ausgabe blättern (drücken Sie die Leertaste zum Blättern, `/` zum Suchen und `q` zum Beenden):
+Durch Anhängen von `less` können Sie in der Ausgabe blättern (drücken Sie die kbd:[Leertaste] zum Blättern, kbd:[/] zum Suchen und kbd:[Q] zum Beenden):
 
 [{shell}]
 ----
@@ -699,7 +701,7 @@ Validating Nagios configuration...OK
 Restarting monitoring core...OK
 ----
 
-Im Monitoring von {CMK} finden Sie nun beim Host `localhost` den neuen Service [.guihint]#Host group check_mk:#
+Im Monitoring von {CMK} finden Sie nun beim Host `localhost` den neuen Service [.guihint]#Host group check_mk#.
 
 .Da die Host-Gruppe `check_mk` nicht leer ist, ist der Service {CRIT}
 image::devel_cpi_service_simple.png[alt="Der vom Check-Plugin erzeugte neue Service im Monitoring."]
@@ -980,7 +982,7 @@ Diese steht in der Spalte [.guihint]#Summary# -- wie im vorherigen Screenshot zu
 Die Idee ist, dass dieser Text eine Länge von 60 Zeichen nicht überschreitet.
 Das sorgt dann immer für eine übersichtliche Tabellendarstellung ohne störende Zeilenumbrüche.
 
-Daneben gibt es noch das Feld [.guihint]#Details,# in dem alle Details zum Zustand des Services angezeigt werden, wobei alle Informationen des Summary auch in den Details enthalten sind.
+Daneben gibt es noch das Feld [.guihint]#Details#, in dem alle Details zum Zustand des Services angezeigt werden, wobei alle Informationen des Summary auch in den Details enthalten sind.
 Nach Anklicken des Services wird die Service-Seite geöffnet, in der neben vielen anderen auch die beiden Felder [.guihint]#Summary# und [.guihint]#Details# zu sehen sind.
 
 Beim Aufruf von `yield Result(pass:[...])` können Sie bestimmen, welche Informationen so wichtig sind, dass sie im Summary angezeigt werden sollen, und bei welchen es genügt, dass diese in den Details erscheinen.
@@ -1076,7 +1078,7 @@ Auch das bisher einzig existierende Resultat bleibt (fast) unverändert:
     )
 ----
 
-Nur der Zugriff im Python-„F-String“ auf den Ausdruck, der den Wert liefert, ist nun einfacher als xref:#summary_details_yield[zuvor], da das `attr` bereits in den Variablendefinitionen steckt.
+Nur der Zugriff im Python-„F-String“ auf den Ausdruck, der den Wert liefert, ist nun einfacher als xref:summary_details_yield[zuvor], da das `attr` bereits in den Variablendefinitionen steckt.
 
 Nun zum eigentlichen Kern der Erweiterung, der Definition eines Resultats, das die folgende Aussage umsetzt:
 „Der Service der Host-Gruppe ist {WARN}, wenn 90{nbsp}% der Hosts {UP} sind, und {CRIT} bei 80{nbsp}% der Hosts.“
@@ -1302,7 +1304,7 @@ Dazu benötigen Sie einen xref:glossar#rule_set[Regelsatz.]
 
 Mit der Erstellung eines Regelsatzes _für_ ein Check-Plugin verlassen Sie die Check-Plugin-Entwicklung und wechseln Dateiverzeichnis, Datei und API.
 Seit {CMK} {v23} unterstützt Sie die *Rulesets-API* bei der Erstellung solcher Regelsätze für Check-Plugins.
-Die API-Dokumentation für Regelsätze finden Sie in Ihrer {CMK}-Instanz auf der gleichen Seite wie die der xref:check_api_doc[Check-API] unter [.guihint]#Rulesets > Version 1.#
+Die API-Dokumentation für Regelsätze finden Sie in Ihrer {CMK}-Instanz auf der gleichen Seite wie die der xref:check_api_doc[Check-API] unter [.guihint]#Rulesets > Version 1#.
 
 
 [#new_ruleset]
@@ -1415,7 +1417,7 @@ Um bei mehreren neuen Regelsätzen den Überblick zu behalten, empfiehlt es sich
 * `title` legt den Titel des Regelsatzes fest, so wie er auch in der {CMK}-GUI erscheint.
 
 * Das `topic` legt fest, wo im [.guihint]#Setup# der Regelsatz auftauchen soll.
-Mit dem im Beispiel gewählten Wert finden Sie den Regelsatz unter [.guihint]#Setup > Services > Service monitoring rules# im Kasten [.guihint]#Various,# wo er in aller Regel gut aufgehoben ist.
+Mit dem im Beispiel gewählten Wert finden Sie den Regelsatz unter [.guihint]#Setup > Services > Service monitoring rules# im Kasten [.guihint]#Various#, wo er in aller Regel gut aufgehoben ist.
 
 * Als `parameter_form` geben Sie den Namen der zuvor erstellten Funktion ein.
 
@@ -1576,14 +1578,14 @@ check_plugin_myhostgroups_advanced = CheckPlugin(
 ----
 
 Sie sollten Standardwerte immer auf diese Weise übergeben (und den Fall fehlender Parameter nicht im Check-Plugin abfangen), da diese Standardwerte auch in der [.guihint]#Setup#-Oberfläche angezeigt werden können.
-Dazu gibt es zum Beispiel bei der Service-Erkennung eines Hosts, auf der Seite [.guihint]#Services of host#, im Menü [.guihint]#Display# den Schalter [.guihint]#Show check parameters.#
+Dazu gibt es zum Beispiel bei der Service-Erkennung eines Hosts, auf der Seite [.guihint]#Services of host#, im Menü [.guihint]#Display# den Schalter [.guihint]#Show check parameters#.
 
 [TIP]
 ====
 Auf GitHub finden Sie sowohl die Datei mit dem
 link:https://github.com/Checkmk/checkmk-docs/blob/master/examples/devel_check_plugins/ruleset_myhostgroups.py[Regelsatz^]
 als auch das um den Regelsatz erweiterte
-link:https://github.com/Checkmk/checkmk-docs/blob/master/examples/devel_check_plugins/check_plugin_advanced_myhostgroups.py[Check-Plugin.^]
+link:https://github.com/Checkmk/checkmk-docs/blob/master/examples/devel_check_plugins/check_plugin_advanced_myhostgroups.py[Check-Plugin^].
 ====
 
 
@@ -1631,7 +1633,7 @@ Allerdings gibt es dabei ein paar Einschränkungen:
 Um die Darstellung Ihrer Metriken in diesen Belangen zu vervollständigen, benötigen Sie _Metrikdefinitionen._
 
 So wie für xref:rule_set[Regelsätze] gibt es seit {CMK} {v23} mit der *Graphing-API* auch eine eigene API für Metriken, Graphen und Perf-O-Meter.
-Die Dokumentation der Graphing-API finden Sie in Ihrer {CMK}-Instanz auf der gleichen Seite wie die der xref:check_api_doc[Check-API] unter [.guihint]#Graphing > Version 1.#
+Die Dokumentation der Graphing-API finden Sie in Ihrer {CMK}-Instanz auf der gleichen Seite wie die der xref:check_api_doc[Check-API] unter [.guihint]#Graphing > Version 1#.
 
 
 [#new_metricdefinition]
@@ -1684,7 +1686,7 @@ Hier die Erklärung dazu:
 
 * Die verfügbaren Einheiten (`unit`) können Sie in der API-Dokumentation nachlesen, sie enden alle auf `Notation`, z. B. `DecimalNotation`, `EngineeringScientificNotation` oder `TimeNotation`.
 
-* Die in {CMK} verwendeten Farbnamen für die Farbdefinition `color` finden Sie auf link:https://github.com/Checkmk/checkmk/blob/master/packages/cmk-plugin-apis/cmk/graphing/v1/metrics.py[GitHub.^]
+* Die in {CMK} verwendeten Farbnamen für die Farbdefinition `color` finden Sie auf link:https://github.com/Checkmk/checkmk/blob/master/packages/cmk-plugin-apis/cmk/graphing/v1/metrics.py[GitHub^].
 
 Diese Definition in der Graphing-Datei sorgt jetzt dafür, dass Titel, Einheit und Farbe der Metrik angepasst dargestellt werden.
 
@@ -2229,9 +2231,9 @@ Um Ihre Check-Plugins weiter nutzen zu können müssen Sie diese noch unter {v23
 
 Die folgenden Informationen helfen Ihnen bei der Migration von Check-Plugins der Check-API V1 auf die V2:
 
-* Die neue Verzeichnisstruktur und Namenskonvention zur Ablage der Dateien für alle Plugin-APIs finden Sie in der xref:check_api_doc[API-Dokumentation] auf der Hauptseite [.guihint]#Checkmk's Plug-in APIs.#
+* Die neue Verzeichnisstruktur und Namenskonvention zur Ablage der Dateien für alle Plugin-APIs finden Sie in der xref:check_api_doc[API-Dokumentation] auf der Hauptseite [.guihint]#Checkmk's Plug-in APIs#.
 
-* Die Zusammenfassung der Änderungen in der Check-API V2 steht ebenfalls in der API-Dokumentation in [.guihint]#Checkmk's Plug-in APIs > Agent based ("Check API") > Version 2 > New in this version.#
+* Die Zusammenfassung der Änderungen in der Check-API V2 steht ebenfalls in der API-Dokumentation in [.guihint]#Checkmk's Plug-in APIs > Agent based ("Check API") > Version 2 > New in this version#.
 Dort finden Sie auch den Link zu einem GitHub-Commit, der das bestehende Check-Plugin `apt` zur Check-API V2 migriert.
 
 * Auf link:https://github.com/Checkmk/checkmk/tree/master/doc/treasures/migration_helpers/[GitHub^] finden Sie im `treasures`-Verzeichnis von {CMK} Skripte, die Ihnen bei der Migration auf die neuen APIs helfen.

src/onprem/en/devel_check_plugins.asciidoc

@@ -1,9 +1,11 @@
 // -*- coding: utf-8 -*-
 // IGNORE % check_mk lt pre →
+// NONASCII
 include::global_attr.adoc[]
 = Developing agent-based check plug-ins
 :title: Developing agent-based check plug-ins
 :description: If desired, you can create your own agent-based {CMK} plug-ins with Python. Read here how to create and use such a plug-in.
+:experimental:
 
 {related-start}
 xref:devel_intro#[Developing extensions for {CMK}]
@@ -264,23 +266,17 @@ check_mk;localhost
 
 Host groups that do not contain any hosts are not listed here.
 
-// This block is new
-// start translation
-////
 [TIP]
 ====
-Unser Beispiel verwendet ein sehr einfaches Shellskript als Agentenplugin.
-In vielen Fällen werden Sie eine leichter zu wartende Skriptsprache oder Binärdateien verwenden wollen.
-Alles, was auf dem Zielsystem ausführbar ist, ist zugelassen.
-Bei Verwendung von Python ist ein kleines Detail zu beachten:
-Falls kein Suffix `.py` im Dateinamen vorhanden ist, wird wie bei allen anderen Skriptsprachen der „Shebang“ ausgewertet.
-Ist das Suffix `.py` vorhanden, wird der Shebang ignoriert, stattdessen sucht der {CMK}-Agent nach dem Python-Interpreter.
-Dessen absoluten Pfad können Sie auch in der Konfigurationsdatei `$MK_CONFDIR/python_path.cfg` abweichend vom System-Python als Variable `PYTHON3` übergeben.
-Das ist praktisch, wenn ein Plugin auf spezielle Python-Module und als Folge auf ein link:https://docs.python.org/3/library/venv.html[Python Virtual Environment (`venv`)^] angewiesen ist.
+Our example uses a very simple shell script as an agent plug-in.
+In many cases, you will want to use a scripting language or binary files that are easier to maintain.
+Anything that is executable on the target system is permitted.
+When using Python, there is one small detail to note:
+If there is no `.py` suffix in the file name, the 'shebang' is evaluated as with all other scripting languages.
+If the `.py` suffix is present, the shebang is ignored and the {CMK} agent will instead search for the Python interpreter.
+You can also specify its absolute file path in the configuration file `$MK_CONFDIR/python_path.cfg` as the variable `PYTHON3`, which differs from the system Python.
+This is useful if a plug-in requires specific Python modules and, as a result, is dependent on a link:https://docs.python.org/3/library/venv.html[Python Virtual Environment (`venv`)^].
 ====
-////
-// end translation
-
 
 [#test_agent]
 === Testing the agent
@@ -306,7 +302,7 @@ As `root`, call the `check_mk_agent` command:
 The new section must appear somewhere in the very long output.
 Agent plug-ins are output by the agent at the end of processing.
 
-You can scroll through the output by appending `less` (press the space bar to scroll, `/` to search and `q` to exit):
+You can scroll through the output by appending `less` (press the kbd:[Spacebar] to scroll, kbd:[/] to search and kbd:[Q] to exit):
 
 [{shell}]
 ----
@@ -1081,7 +1077,7 @@ The only existing result remains (almost) unchanged:
     )
 ----
 
-Only the access in the Python 'F-String' to the expression that returns the value is now easier than xref:#summary_details_yield[previously], since the `attr` is already in the variable definitions.
+Only the access in the Python 'F-String' to the expression that returns the value is now easier than xref:summary_details_yield[previously], since the `attr` is already in the variable definitions.
 
 Now to the actual core of the extension, the definition of a result that implements the following statement:
 "The service of the host group is {WARN} when 90{nbsp}% of the hosts are {UP}, and {CRIT} when 80{nbsp}% of the hosts are {UP}."
@@ -1684,7 +1680,7 @@ Here is the explanation:
 
 * The available units (`unit`) can be found in the API documentation, these all end in `Notation`, e.g. `DecimalNotation`, `EngineeringScientificNotation` or `TimeNotation`.
 
-* The color names used in {CMK} for the `color` definition can be found at link:https://github.com/Checkmk/checkmk/blob/master/packages/cmk-plugin-apis/cmk/graphing/v1/metrics.py[GitHub.^]
+* The color names used in {CMK} for the `color` definition can be found at link:https://github.com/Checkmk/checkmk/blob/master/packages/cmk-plugin-apis/cmk/graphing/v1/metrics.py[GitHub^].
 
 This definition in the graphing file now ensures that the metric's title, unit and color are displayed appropriately.
 
@@ -2249,5 +2245,4 @@ include::include_treasures_admonition.asciidoc[]
 |`~/local/lib/python3/cmk_addons/plugins/<plug-in_family>/rulesets/` |Storage location for rule set files created according to the Rulesets API.
 |`~/local/lib/python3/cmk_addons/plugins/<plug-in_family>/graphing/` |Storage location for graphing files created according to the Graphing API.
 |`/usr/lib/check_mk_agent/plugins/` |This directory is located on a monitored Linux host. The {CMK} agent for Linux expects extensions of the agent (agent plug-ins) here.
-|===
-
+|===