content-sync - KNW-1663 translation started, pick-25 pick-24

(cherry picked from commit c15e346)

Author: thomaskoslowski

src/onprem/de/datasource_programs.asciidoc

@@ -13,7 +13,6 @@ xref:localchecks#[Lokale Checks]
 xref:piggyback#[Der Piggyback-Mechanismus]
 {related-end}
 
-// ES: Du hast durchgehend "Datenquellenprogramm" geschrieben, sollten wir den Begriff im Dictionary noch mal diskutieren? Habe jetzt erstmal alle Verwendungen an den aktuell bevorzugten Begriff "Datenquellprogramm" angeglichen.
 
 [#intro]
 == Einleitung
@@ -66,6 +65,7 @@ Falls Sie eine reguläre Agentenausgabe einfach auf anderen Wegen übertragen wo
 Und schließlich können Sie jedes Datenquellprogramm -- wenn denn einmal eine bessere Konfigurierbarkeit erforderlich sein sollte -- in einen xref:devel_special_agents#[Spezialagenten umwandeln].
 ====
 
+
 [#writing]
 == Schreiben von Datenquellprogrammen
 

src/onprem/en/datasource_programs.asciidoc

@@ -17,11 +17,12 @@ xref:piggyback#[The piggyback mechanism]
 [#intro]
 == Introduction
 
+// delete from here
 {CMK} usually accesses monitored hosts in the xref:glossar#pull_mode[pull mode] via a TCP connection to port 6556.
 Starting with version {v21}, in most cases the Agent Controller listens on this port, which forwards the agent output over a TLS encrypted connection.
 {CMK} {v22} introduced the alternative option for selecting the transmission direction with the xref:glossar#push_mode[push mode].
 
-There are environments however -- for example, stripped-down containers, legacy or embedded systems -- in which the Agent Controller cannot be used.
+There are environments however--for example, stripped-down containers, legacy or embedded systems--in which the Agent Controller cannot be used.
 In such cases the _legacy mode_ is applied in which `(x)inetd` executes the agent script after establishing a connection, the agent output is transferred as plain text and the connection is closed immediately after.
 
 In many situations security policies could require that actions such as the transmission of data as plain text must be avoided.
@@ -32,11 +33,11 @@ The universal methods for connecting such transfer procedures to {CMK} are the _
 The idea is very simple:
 you pass a command to {CMK}.
 Instead of connecting to port 6556, {CMK} executes this command.
-This produces the agent data on the _standard output_, which is then processed by {CMK} in exactly the same way as if it had come from a ‘normal’ agent.
+This produces the agent data on the _standard output_, which is then processed by {CMK} in exactly the same way as if it had come from a 'normal' agent.
 Since changes to data sources usually only affect transports, it is important that you leave the host to [.guihint]#API integrations if configured, else {CMK} agent# in the xref:hosts_setup#monitoring_agents[Setup GUI].
 
 The modularity of {CMK} helps you to fulfill these requirements by transmitting the plain text agent output over arbitrary means of transport.
-Ultimately, the plain text output of the agent script can be transported by any means -- direct or indirect, pull or push.
+Ultimately, the plain text output of the agent script can be transported by any means--direct or indirect, pull or push.
 Here are a few examples on how to get agent data to the {CMK} server:
 
 * via email
@@ -47,11 +48,60 @@ Here are a few examples on how to get agent data to the {CMK} server:
 
 Another area of application for data source programs are systems that do not allow agent installation but issue status data via REST API or a Telnet interface.
 In such cases, you can write a data source program that queries the existing interface and generates agent output from the data obtained.
+// delete to here
+
+// start translation
+////
+Der {CMK}-Server erreicht Hosts im xref:glossar#pull_mode[Pull-Modus] üblicherweise über eine TCP-Verbindung auf Port 6556.
+Unter Linux und Windows lauscht auf diesem Port in den meisten Fällen der Agent Controller, welcher die Agentenausgabe über eine TLS-verschlüsselte Verbindung weiterleitet.
+In {CE} ist mit dem xref:glossar#push_mode[Push-Modus] die zusätzliche Möglichkeit vorhanden, die Übertragungsrichtung zu wählen.
+
+Es gibt jedoch Umgebungen, in denen der Agent Controller nicht verwendet werden kann.
+Im _Legacy-Modus_ kommt hier ein `inetd` zum Einsatz, der bei jeder Anfrage das Agentenskript ausführt, die Ausgabe im Klartext überträgt und dann die Verbindung wieder schließt.
+In vielen Fällen verlangen Sicherheitsrichtlinien den Verzicht auf eine Übertragung von Daten im Klartext oder die Verwendung vorhandener Kommunikationskanäle.
+So kann ein Angreifer zwar mit den Füllständen von Dateisystemen meist wenig anfangen, aber Prozesstabellen oder Listen von anstehenden Sicherheitsupdates können helfen, Angriffe zielgerichtet vorzubereiten.
+
+Die universelle Methode, um beliebige Transportwege an {CMK} anzudocken, sind die Datenquellprogramme (_data source programs_).
+Die Idee ist sehr einfach:
+Sie übergeben dem {CMK}-Server einen Befehl, mit dem Agentendaten eingeholt werden sollen.
+Statt den zu überwachenden Host auf Port 6556 zu kontaktieren, führt {CMK} diesen Befehl aus.
+{CMK} erwartet bei der Ausführung des Befehls Agentendaten auf der _Standardausgabe_.
+Die weitere Verarbeitung erfolgt, als stammten die Agentendaten von einem „normalen“ Agenten.
+Da Datenquellen wie Agentenaufrufe behandelt werden, ist es wichtig, dass Sie per Datenquellprogramm überwachte Hosts in der xref:hosts_setup#monitoring_agents[Setup-GUI] mit der Einstellung [.guihint]#API integrations if configured, else {CMK} agent# oder [.guihint]#Configured API integrations and {CMK} agent# versehen.
+
+Letztlich kann die Klartextausgabe des Agentenskripts über beliebige Wege transportiert werden -- direkt oder indirekt, per Pull oder Push.
+Hier sind einige Beispiele, mit denen {CMK}-Anwender Daten vom Agenten zum {CMK}-Server bekommen:
+
+* per E-Mail
+* per HTTP-Zugriff vom Server aus
+* per HTTP-Upload vom Host aus
+* per Zugriff auf eine Datei, die per `rsync` oder `scp` vom Host zum Server kopiert wurde
+* per Skript, welches die Daten per HTTP von einem Webdienst abholt
+* per xref:agent_linux_legacy#ssh[Agentenaufruf via SSH-Tunnel]
+
+.Wann sollte ich Datenquellprogramme einsetzen, wann Spezialagenten?
+[%collapsible]
+====
+Datenquellprogramme und xref:special_agents#[Spezialagenten] sind eng miteinander verwandt.
+Letztlich sind Spezialagenten als Evolution von Datenquellprogrammen zu betrachten.
+Spezialagenten wurden zunächst genutzt, um Datenquellprogramme besser konfigurierbar zu machen.
+
+Heute liefern Spezialagenten in der Regel eigene Agentensektionen und werden mit eigenen Check-Plugins kombiniert.
+In der Praxis relevant ist, dass einem Host nur ein Datenquellprogramm zugeordnet sein kann, aber seit {CMK} {v24} beliebig viele Spezialagenten.
+Auch können Spezialagenten die reguläre Agentenausgabe ergänzen, ein Datenquellprogramm ersetzt sie hingegen.
+
+Wenn Sie also beispielsweise über eine REST-API Daten einholen können, die zusätzlich zur regulären Agentenausgabe einen Nutzen im Monitoring haben, müssen Sie einen Spezialagenten verwenden.
+Falls Sie eine reguläre Agentenausgabe einfach auf anderen Wegen übertragen wollen, sind Datenquellprogramme der richtige Weg.
+Und schließlich können Sie jedes Datenquellprogramm -- wenn denn einmal eine bessere Konfigurierbarkeit erforderlich sein sollte -- in einen xref:devel_special_agents#[Spezialagenten umwandeln].
+====
+////
+// end translation
 
 
 [#writing]
 == Writing data source programs
 
+[#minimalexample]
 === The simplest possible program
 
 The writing and installation of a data source program is not difficult.
@@ -81,7 +131,7 @@ Don't forget to make the program executable:
 
 Now create a test host in the Setup – e.g., `myserver125`.
 This does not require an IP address.
-In order to avoid {CMK} attempting to resolve `myserver125` via DNS, enter this name as an explicit ‘IP address’.
+In order to avoid {CMK} attempting to resolve `myserver125` via DNS, set [.guihint]#IP address family# to [.guihint]#No IP#.
 
 Next add a rule in the [.guihint]#Setup > Agents > Other integrations > Individual program call instead of agent access# rule set which applies to this host, and enter `myds` as an executable program:
 
@@ -95,6 +145,7 @@ Add this service into the monitoring, activate the changes, and your first data
 For a test, as soon as you alter the data being generated by the program the `My_Disk` file system's next check will immediately show this.
 
 
+[#diagnosis]
 === Error diagnosis
 
 If something is not functioning correctly, the host's configuration can be checked by entering `cmk -D` in the command line and see if your rule takes effect:
@@ -132,6 +183,7 @@ My_Disk  foobar  100 70 30  70% /my_disk
 ----
 
 
+[#passhostname]
 === Transferring a host's name
 
 The program in our example actually works, but is not very useful as it always produces the same data, regardless of which host it is invoked for.
@@ -183,7 +235,7 @@ If you have a dual-monitoring using IPv4 and IPv6, the following macros may be i
 [#error_handling]
 === Error handling
 
-Regardless of your actual occupation in IT -- much of your time will be spent dealing with errors and problems.
+Regardless of your actual occupation in IT--much of your time will be spent dealing with errors and problems.
 Data source programs are not spared these.
 Especially for programs that provide data over networks it is unrealistic to expect them to be error-free.
 
@@ -231,13 +283,6 @@ As soon as an instruction produces an error (i.e., exit code not `0`), the shell
 You have thus a generic error handling and must not check every single instruction for success.
 
 
-[#specialagents]
-== Special agents
-
-A number of often-required data source programs are delivered with {CMK}.
-These _special agents_ are presented in a xref:special_agents#[separate article].
-
-
 [#files]
 == Files and directories