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

Author: thomaskoslowski

src/onprem/de/devel_check_plugins_snmp.asciidoc

@@ -3,7 +3,6 @@
 // NONASCII 
 include::global_attr.adoc[]
 = SNMP-basierte Check-Plugins entwickeln
-:revdate: 2024-09-02
 :title: SNMP-basierte Check-Plugins entwickeln
 :description: Relevante Monitoring-Daten für SNMP-Hosts muss {CMK} explizit anfordern und dann auswerten. Lesen Sie hier, wie Sie Check-Plugins für SNMP entwickeln.
 
@@ -19,7 +18,7 @@ xref:cmk_commandline#[{CMK} auf der Befehlszeile]
 [#intro]
 == Einleitung
 
-Check-Plugins, die mit SNMP arbeiten, werden auf ähnliche Weise entwickelt wie ihre xref:devel_check_plugins#[agentenbasierten Verwandten.]
+Check-Plugins, die mit SNMP arbeiten, werden auf ähnliche Weise entwickelt wie ihre xref:devel_check_plugins#[agentenbasierten Verwandten].
 Der Unterschied liegt sowohl im Ablauf der xref:glossar#service_discovery[Service-Erkennung] (_Discovery_) als auch des Checks selbst.
 Bei den agentenbasierten Check-Plugins wird mit dem xref:glossar#agent_plugin[Agentenplugin] festgelegt, welche Daten an die {CMK}-Instanz _gesendet_ werden, zudem findet auf dem Host oft bereits eine Vorfilterung (aber keine Auswertung) statt.
 Im Gegensatz dazu müssen Sie bei SNMP selbst genau festlegen, welche Datenbereiche Sie benötigen und diese explizit _anfordern._
@@ -31,7 +30,7 @@ Daher scheidet dies bereits bei der Discovery und erst recht beim Check selbst a
 {CMK} geht hier zielgerichteter vor.
 Für das Debugging vorhandener und die Entwicklung eigener Checks stehen in {CMK} dennoch SNMP-Walks zur Verfügung.
 
-Falls Sie noch keine Erfahrung mit SNMP haben, empfehlen wir Ihnen als vorbereitende Lektüre den Artikel über das xref:snmp#[Überwachen via SNMP.]
+Falls Sie noch keine Erfahrung mit SNMP haben, empfehlen wir Ihnen als vorbereitende Lektüre den Artikel über das xref:snmp#[Überwachen via SNMP].
 
 
 [#snmp_special]
@@ -56,7 +55,7 @@ Hier werden per SNMP-Walks die für das Plugin benötigten aktuellen Monitoring-
 
 Was müssen Sie also bei einem Check-Plugin für SNMP anders machen als bei einem agentenbasierten?
 
-. Sie benötigen _kein_ xref:glossar#agent_plugin[Agentenplugin.]
+. Sie benötigen _kein_ xref:glossar#agent_plugin[Agentenplugin].
 
 . Sie legen die für die SNMP-Detection nötigen OIDs fest und die Texte, die diese enthalten sollen.
 
@@ -110,7 +109,7 @@ Ist gerade kein Gerät zur Hand, finden Sie im Kapitel zur xref:simulation[Fehle
 Der erste Schritt dahin ist, einen kompletten SNMP-Walk auszuführen.
 Dabei werden _alle_ per SNMP verfügbaren Daten abgerufen.
 {CMK} kann das sehr einfach für Sie erledigen.
-Nehmen Sie dazu zunächst das Gerät, für das Sie ein Check-Plugin entwickeln wollen, xref:snmp#add_device[in das Monitoring auf.]
+Nehmen Sie dazu zunächst das Gerät, für das Sie ein Check-Plugin entwickeln wollen, xref:snmp#add_device[in das Monitoring auf].
 Stellen Sie sicher, dass es xref:snmp#services[in den Grundfunktionen] überwacht werden kann.
 Zumindest müssen die Services [.guihint]#SNMP Info# und [.guihint]#Uptime# gefunden werden und wahrscheinlich auch noch mindestens ein [.guihint]#Interface#.
 So stellen Sie sicher, dass der SNMP-Zugriff sauber funktioniert.
@@ -190,14 +189,14 @@ Für das vorgestellte Beispiel genügen die OIDs `1.3.6.1.2.1.1.4.0` bis `1.3.6.
 Nun haben Sie die Vorarbeit erledigt:
 Sie haben jetzt eine Liste der OIDs, die Sie auslesen und auswerten wollen.
 Jetzt geht es darum, anhand dieser Notizen {CMK} beizubringen, welche Services erzeugt werden, und wann diese auf {WARN} oder {CRIT} gehen sollen.
-Die dafür angewandte Programmierung eines Check-Plugins in Python hat viele Parallelen zum xref:devel_check_plugins#write_check_plugin[agentenbasierten Check-Plugin.]
+Die dafür angewandte Programmierung eines Check-Plugins in Python hat viele Parallelen zum xref:devel_check_plugins#write_check_plugin[agentenbasierten Check-Plugin].
 Da einige Feinheiten zu beachten sind, zeigen wir den vollständigen Aufbau mit allen verwendeten Funktionen.
 
 
 [#scaffold]
 === Die Datei vorbereiten
 
-Für Ihre eigenen Check-Plugins finden Sie das Basisverzeichnis vorbereitet in der `local`-Hierarchie des xref:cmk_commandline#sitedir[Instanzverzeichnisses.]
+Für Ihre eigenen Check-Plugins finden Sie das Basisverzeichnis vorbereitet in der `local`-Hierarchie des xref:cmk_commandline#sitedir[Instanzverzeichnisses].
 Dieses lautet `~/local/lib/python3/cmk_addons/plugins/`.
 Das Verzeichnis gehört dem Instanzbenutzer und ist daher für Sie schreibbar.
 
@@ -266,7 +265,6 @@ check_plugin_flintstone_setup = CheckPlugin(
 Als erstes müssen Sie die für die Check-Plugins nötigen Funktionen und Klassen aus Python-Modulen importieren.
 Vom gelegentlich gesehenen `import pass:[*]`, raten wir ab, da es zum einen unnötig viel Speicher nutzt und zum anderen verschleiert, welche Namespaces tatsächlich verfügbar gemacht werden.
 Für unser Beispiel wird nur importiert, was im weiteren Verlauf des Artikels genutzt wird oder nützlich sein kann.
-// TK: CheckResult, DiscoveryResult, StringTable werden aber gar nicht genutzt? MFS: Doch, implizit, also importieren wir sie.
 
 .~/local/lib/python3/cmk_addons/plugins/flintstone/agent_based/flintstone_setup_check.py
 [{python}]
@@ -534,7 +532,7 @@ check_plugin_flintstone_setup = CheckPlugin(
 [#discovery_function]
 === Die Discovery-Funktion schreiben
 
-Auch die Discovery-Funktion entspricht dem Beispiel des xref:devel_check_plugins#discovery_function[agentenbasierten Check-Plugins.]
+Auch die Discovery-Funktion entspricht dem Beispiel des xref:devel_check_plugins#discovery_function[agentenbasierten Check-Plugins].
 Bei Check-Plugins, die pro Host nur einen Service erzeugen, genügt ein einziges `yield()`:
 
 .~/local/lib/python3/cmk_addons/plugins/flintstone/agent_based/flintstone_setup_check.py
@@ -574,7 +572,7 @@ Das komplette Check-Plugin haben wir auf link:https://github.com/Checkmk/checkmk
 [#test]
 === Das Check-Plugin testen und aktivieren
 
-Test und Aktivierung erfolgen wie beim xref:devel_check_plugins#test[agentenbasierten Check-Plugin.]
+Test und Aktivierung erfolgen wie beim xref:devel_check_plugins#test[agentenbasierten Check-Plugin].
 
 Als erstes ist die Service-Erkennung des Plugins an der Reihe:
 
@@ -657,7 +655,7 @@ Ein Hilfsmittel bei der Programmierung eines solchen kann das link:https://pypi.
 === Unkooperative Hardware
 
 Bevor ein Gerät mit einem neuen SNMP-basierten Check-Plugin überwacht werden kann, muss es zuerst einmal grundsätzlich über SNMP überwacht werden können.
-Die Übersicht bekannter Probleme mit Lösungsvorschlägen finden Sie daher im Artikel zur xref:snmp#cursedhardware[Überwachung via SNMP.]
+Die Übersicht bekannter Probleme mit Lösungsvorschlägen finden Sie daher im Artikel zur xref:snmp#cursedhardware[Überwachung via SNMP].
 
 
 [#files]

src/onprem/en/devel_check_plugins_snmp.asciidoc

@@ -3,7 +3,6 @@
 // NONASCII 
 include::global_attr.adoc[]
 = Developing SNMP-based check plug-ins
-:revdate: 2024-10-09
 :title: Developing SNMP-based check plug-ins
 :description: Relevant monitoring data about SNMP hosts must be explicitly requested and then evaluated by {CMK}. Read here how to develop check plug-ins for SNMP.