formal changes, pick-24

Author: thomaskoslowski

src/common/de/devel_intro.asciidoc

@@ -1,9 +1,8 @@
 // -*- coding: utf-8 -*-
 // IGNORE
-// SKIPCOMMITS 2025-07-23
+// NONASCII
 include::global_attr.adoc[]
 = Erweiterungen für {CMK} entwickeln
-:revdate: 2023-10-10
 :title: Erweiterungen für {CMK} entwickeln
 :description: Für unterschiedlich komplexe Anwendungsszenarien können Sie {CMK} um diverse Arten von Komponenten selbst erweitern, die hier vorgestellt werden.
 
@@ -39,14 +38,11 @@ endif::[]
 Dennoch kommt es immer wieder vor, dass eine Hardware zu neu ist, eine Software zu exotisch oder eine firmeninterne Eigenentwicklung zu individuell, als dass schon jemand Bedarf für die Integration in {CMK} gesehen hätte.
 Sind Sie an diesem Punkt angelangt, ist es an der Zeit, sich mit der Programmierung eigener Erweiterungen zu befassen.
 
-Dieser Artikel zeigt eine Übersicht der
-ifdef::saas[]
-in {CE} (SaaS)
-endif::[]
-zur Verfügung stehenden Möglichkeiten.
+Dieser Artikel zeigt eine Übersicht der zur Verfügung stehenden Möglichkeiten.
 
-// TK: Den folgenden Satz würde ich rausnehmen in der saas. Vielfältig ist anders ;-)
+ifdef::onprem[]
 Und die sind vielfältig: 
+endif::[]
 In manchen Fällen genügt es beispielsweise, ein Backup-Skript um wenige Zeilen zu erweitern, um Erfolg oder Misserfolg in einer gut in {CMK} darstellbaren Form auszugeben – damit ist die „Eigenentwicklung“ mitunter in wenigen Minuten abgeschlossen.
 ifdef::onprem[]
 In anderen Fällen werden Sie darauf angewiesen sein, mit umfangreichen Graphen Lastsituationen zu visualisieren – dann lohnt es sich auch, einige Stunden mehr zu investieren.
@@ -55,22 +51,25 @@ endif::[]
 ifdef::saas[]
 [TIP]
 ====
-Beachten Sie, dass {CE} (SaaS) derzeit _nicht_ mit selbst erstellten oder aus der link:https://exchange.checkmk.com/[{CMK} Exchange^] bezogenen Paketen erweitert werden kann.
+Beachten Sie, dass {CE} derzeit _nicht_ mit selbst erstellten oder aus der link:https://exchange.checkmk.com/[{CMK} Exchange^] bezogenen Paketen erweitert werden kann.
 ====
 endif::[]
 
+
+[#own_programs]
 == Erweiterungsmöglichkeiten mit eigenen Programmen
 
-// TK: Den folgenden Satz würde ich auch einfach rausnehmen in der saas. Datenerhebung und Auswertung fehlen ja auch in Kap. 2.2
+ifdef::onprem[]
 Die folgenden Abschnitte zeigen, welche Verfahren in {CMK} möglich sind, eigene Erweiterungen zu integrieren, und wo dabei jeweils die Datenerhebung und die Auswertung erfolgt.
+endif::[]
 
 
 [#local_checks]
 === Lokale Checks
 
-Die wahrscheinlich einfachste Art und Weise, {CMK} zu erweitern, sind xref:localchecks#[lokale Checks.]
+Die wahrscheinlich einfachste Art und Weise, {CMK} zu erweitern, sind xref:localchecks#[lokale Checks].
 Ein Programm, welches vom Agentenskript des überwachten Hosts ausgeführt wird, gibt in einer Zeile Namen, Zustand und weitere Informationen aus.
-Für lokale Checks unterstützt {CMK} die automatische xref:glossar#service_discovery[Service-Erkennung.]
+Für lokale Checks unterstützt {CMK} die automatische xref:glossar#service_discovery[Service-Erkennung].
 Die Programmierung ist in beliebigen Sprachen möglich, ohne eine API erlernen zu müssen.
 
 * *Ausführung:* Vollständig auf dem überwachten Host. Sie müssen selbst sicherstellen, dass gegebenenfalls auf allen Hosts, die einen lokalen Check erhalten, der passende Interpreter verfügbar ist.
@@ -92,7 +91,7 @@ Die Ermittlung des Zustands kann dabei sehr flexibel erfolgen.
 So ist die Verwendung unterer und oberer Schwellwerte möglich.
 Zudem können mehrere Services erzeugt und der Status eines Services durch mehrere Überprüfungen bestimmt werden.
 Des Weiteren ist die Ermittlung von Trends und Einbeziehung älterer Werte möglich.
-Native Check-Plugins unterstützen die automatische Erstellung von xref:glossar#label[Labels] und die xref:inventory#[HW-/SW-Inventur.]
+Native Check-Plugins unterstützen die automatische Erstellung von xref:glossar#label[Labels] und die xref:inventory#[HW-/SW-Inventur].
 
 * *Ausführung:* Agentenplugin zur Datensammlung in beliebiger Programmiersprache auf dem überwachten Host, weitere Auswertung durch Check-Plugin auf dem {CMK}-Server unter Verwendung der Check-API.
 * *Schwellwerte:* Beliebige Kombination von Schwellwerten für jeden Service.
@@ -106,7 +105,7 @@ ifdef::onprem[]
 Eine Erweiterung der agentenbasierten Check-Plugins sind xref:devel_special_agents#[Spezialagenten:]
 Hier sammelt kein Agentenplugin die Rohdaten ein, sondern ein Programm, das auf dem {CMK}-Server läuft und Daten aus einer anderen Quelle abfragt und in das Agentenformat von {CMK} umwandelt.
 Spezialagenten kommen beispielsweise zum Einsatz, wenn ein zu überwachendes Gerät fürs Monitoring relevante Daten als JSON oder XML über eine REST-API bereitstellt.
-Beispiele für den Einsatz von bei {CMK} mitgelieferten Spezialagenten finden Sie in der Überwachung von xref:monitoring_aws#[AWS], xref:monitoring_azure#[Azure] oder xref:monitoring_vmware#[VMware.]
+Beispiele für den Einsatz von bei {CMK} mitgelieferten Spezialagenten finden Sie in der Überwachung von xref:monitoring_aws#[AWS], xref:monitoring_azure#[Azure] oder xref:monitoring_vmware#[VMware].
 
 Bei der Programmierung greifen Sie auf zwei APIs zu: Für die Konfiguration von Ports oder ähnlichem stellt {CMK} eine API bereit, die erlaubt, solche Einstellungen im Setup zu bestimmen.
 Für die Datenabfrage selbst verwenden Sie die REST-API der externen Quelle. 
@@ -121,7 +120,7 @@ ifdef::onprem[]
 [#check_plugins_snmp]
 === Native SNMP-basierte Check-Plugins
 
-Eine Variante der agentenbasierten Check-Plugins sind die xref:devel_check_plugins_snmp#[Check-Plugins für SNMP.]
+Eine Variante der agentenbasierten Check-Plugins sind die xref:devel_check_plugins_snmp#[Check-Plugins für SNMP].
 Der Unterschied besteht hier darin, dass keine Agentensektion angefordert und ausgewertet wird, sondern bestimmte SNMP-OIDs, die explizit vom SNMP-Agenten angefordert werden.
 
 * *Ausführung:* Datensammlung und weitere Auswertung durch Check-Plugin auf dem {CMK}-Server unter Verwendung der Check-API.

src/common/en/devel_intro.asciidoc

@@ -1,9 +1,8 @@
 // -*- coding: utf-8 -*-
 // IGNORE pre
-// SKIPCOMMITS 2025-07-23
+// NONASCII
 include::global_attr.adoc[]
 = Developing extensions for {CMK}
-:revdate: 2023-11-07
 :title: Developing extensions for {CMK}
 :description: You can extend {CMK} with a range of types of components to cover scenarios of varying complexity. The development of such extensions is described here.
 
@@ -32,19 +31,18 @@ ifdef::saas[]
 xref:monitoring_logfiles#[evaluation of log messages]
 endif::[]
 and the xref:monitoring_jobs#[monitoring of recurring tasks], {CMK} is the ideal out-of-the-box solution for a wealth of monitoring tasks.
+ifdef::onprem[]
 Should a plug-in for a very specialized use not be available, the {CMK} community will be happy to help with custom developments provided via the link:https://exchange.checkmk.com/[{CMK} Exchange^].
+endif::[]
 
 Nevertheless, there are always situations where a piece of hardware is too new, a piece of software is too exotic, or an organization's own development is too individual for anyone to have already recognized the need for its integration into {CMK}.
 If you have reached this point, it is time to start programming your own extensions.
 
-ifdef::onprem[]
 This article provides an overview of the options available.
-endif::[]
-ifdef::saas[]
-This article provides an overview of the options available in {CE} (SaaS).
-endif::[]
 
-These options are manifold: 
+ifdef::onprem[]
+These options are manifold:
+endif::[]
 In some cases, for example, it is sufficient to extend a backup script by a few lines in order to output success or failure in a form that can be easily displayed in {CMK} -- this means that the 'in-house development' can sometimes be completed in just a few minutes.
 ifdef::onprem[]
 In other cases you will need to visualize load situations with extensive graphs -- in such a situation it is worth investing a few hours more.
@@ -53,13 +51,18 @@ endif::[]
 ifdef::saas[]
 [TIP]
 ====
-Please note that {CE} (SaaS) currently can _not_ be extended with self-made packages or packages obtained from the link:https://exchange.checkmk.com/[{CMK} Exchange^].
+Please note that {CE} currently can _not_ be extended with self-made packages or packages obtained from the link:https://exchange.checkmk.com/[{CMK} Exchange^].
 ====
 endif::[]
 
+
+[#own_programs]
 == Extension possibilities using own programs
 
+ifdef::onprem[]
 The following sections show which procedures for integrating your own extensions into {CMK} are possible, and where the data collection and evaluation takes place in each case.
+endif::[]
+
 
 [#local_checks]
 === Local checks