updating intro to 2.5.0, pick-25

Author: thomaskoslowski

src/common/de/intro_extend.asciidoc

@@ -17,14 +17,16 @@ ifdef::onprem[]
 
 Auch wenn im Monitoring „nur“ geschaut wird, ist das Thema IT-Sicherheit auch hier sehr wichtig, insbesondere bei der Anbindung und Einrichtung ferner Systeme.
 Im xref:security#[Artikel über Sicherheit] finden Sie eine Übersicht von Themen, mit denen Sie die Sicherheit Ihres Systems optimieren können.
+endif::[]
 
 
+ifdef::onprem[]
 [#distributed_monitoring]
 == Sehr große Umgebungen überwachen
 
 Wenn Ihr Monitoring eine Größenordnung erreicht hat, in der Sie Tausende oder noch mehr Hosts überwachen, werden Fragen der Architektur und der Optimierung dringlicher.
 Eines der wichtigsten Themen ist dabei das xref:glossar#distributed_monitoring[verteilte Monitoring].
-Dabei arbeiten Sie mit mehreren {CMK}-Instanzen, die zu einem großen System zusammengeschaltet sind und bei Bedarf im xref:glossar#central_setup[zentralen Setup] zentral konfiguriert sein können.
+Dabei arbeiten Sie mit mehreren {CMK}-Instanzen, die zu einem großen System zusammengeschaltet sind und bei Bedarf für ein xref:glossar#central_setup[zentrales Setup] konfiguriert werden können.
 
 image::distributed_monitoring_overview_de.png[alt="Illustration der Beziehung zwischen mehreren Instanzen und ihrer Komponenten im verteilten Monitoring."]
 endif::[]
@@ -35,6 +37,7 @@ endif::[]
 
 {CMK} kann sehr präzise berechnen, wie hoch die xref:availability#[Verfügbarkeit] (_availability_) von Hosts oder Services in bestimmten Zeiträumen war, wie viele Ausfälle es gegeben hat, wie lang diese waren und vieles mehr.
 
+.Die Verfügbarkeit der Services wird in Prozenten angezeigt
 image::intro_availability.png[alt="Liste von Services mit den Prozentwerten ihrer Verfügbarkeit."]
 
 ifdef::onprem[]
@@ -44,6 +47,7 @@ ifdef::saas[]
 Auf den Verfügbarkeitsdaten aufbauend ermöglicht das xref:sla#[SLA] Software-Modul eine wesentlich detailliertere Auswertung zur Einhaltung von Service Level Agreements, die sogar aktiv überwacht werden können.
 endif::[]
 
+.Das Service Level Agreement eines Services für die letzten 15 Tage
 image::sla_view_example_modern.png[alt="Ein Service und dessen Service Level Agreement für die letzten 15 Tage."]
 
 
@@ -53,6 +57,7 @@ image::sla_view_example_modern.png[alt="Ein Service und dessen Service Level Agr
 Die xref:inventory#[HW-/SW-Inventur] gehört eigentlich nicht mehr zum Monitoring, aber {CMK} kann mit den bereits vorhandenen xref:glossar#agent[Agenten] umfangreiche Informationen zu Hardware und Software Ihrer überwachten Systeme ermitteln.
 Dies ist sehr hilfreich für die Wartung, das Lizenzmanagement oder das automatische Befüllen von Configuration Management Databases.
 
+.Die Inventurdaten eines Hosts werden in einem strukturierten Baum dargestellt
 image::inventory_example.png[alt="Baumdarstellung der HW-/SW-Inventurdaten eines Hosts."]
 
 
@@ -62,17 +67,21 @@ ifdef::onprem[]
 
 Bisher haben wir uns nur mit der Überwachung der aktuellen Zustände von Hosts und Services befasst.
 Ein ganz anderes Thema ist die Auswertung spontaner Meldungen, die z.B. in Log-Dateien auftauchen oder per Syslog oder SNMP-Traps versendet werden.
-{CMK} filtert aus den eingehenden Meldungen die relevanten Ereignisse (_events_) heraus und hat dafür ein komplett integriertes System mit dem Namen xref:ec#[Event Console].
+{CMK} filtert aus den eingehenden Meldungen die relevanten Ereignisse (_events_) heraus und hat dafür ein komplett integriertes System mit dem Namen xref:glossar#ec[Event Console].
 
+.Liste von Ereignissen in der Event Console
 image::ec_open_events.png[alt="Liste von Ereignissen in der Event Console."]
+endif::[]
 
 
+ifdef::onprem[]
 [#nagvis]
 == Auf Karten und Diagrammen visualisieren
 
-Mit dem in {CMK} integrierten Add-on xref:nagvis#[NagVis] können Sie auf beliebigen Karten oder Diagrammen Zustände darstellen.
+Mit dem in {CMK} integrierten Software-Modul xref:nagvis#[NagVis] können Sie auf beliebigen Karten oder Diagrammen Zustände darstellen.
 Dies eignet sich hervorragend, um ansprechende Gesamtübersichten zu erstellen, z.B. auf einem Bildschirm in einem Leitstand.
 
+.Eine mit NagVis erstellte geografische Karte mit Symbolen für den Host-/Service-Zustand
 [{image-border}]
 image::intro_nagvis_map.png[alt="Eine mit NagVis erstellte geografische Karte mit Symbolen für den Host-/Service-Zustand."]
 endif::[]
@@ -83,6 +92,7 @@ endif::[]
 
 Mit dem in {CMK} integrierten Software-Modul xref:glossar#bi[Business Intelligence] können Sie aus den vielen einzelnen Statuswerten den Gesamtzustand von geschäftskritischen Anwendungen ableiten und übersichtlich darstellen.
 
+.Ein aus Einzelzuständen abgeleiteter Gesamtzustand einer Anwendung
 image::intro_bi_downtimes.png[alt="Baumdarstellung in der Business Intelligence mit dem aus Einzelzuständen abgeleiteten Gesamtzustand einer Anwendung."]
 
 
@@ -111,7 +121,7 @@ ifdef::onprem[]
 [#devel]
 == Eigene Plugins entwickeln
 
-Auch wenn {CMK} über 2000 Check-Plugins mit ausliefert, kann es trotzdem vorkommen, dass ein konkretes Plugin fehlt.
+Auch wenn {CMK} über 2000 xref:glossar#check_plugin[Check-Plugins] mit ausliefert, kann es trotzdem vorkommen, dass ein konkretes Plugin fehlt.
 Eine Einführung in die Entwicklung von Erweiterungen für {CMK} erhalten Sie in einem xref:devel_intro#[eigenen Artikel].
 endif::[]
 
@@ -120,7 +130,7 @@ ifdef::saas[]
 [#devel]
 == {CMK} erweitern
 
-Auch wenn {CMK} über 2000 Check-Plugins mit ausliefert, kann es trotzdem vorkommen, dass eine konkrete Funktion fehlt.
+Auch wenn {CMK} über 2000 xref:glossar#check_plugin[Check-Plugins] mit ausliefert, kann es trotzdem vorkommen, dass eine konkrete Funktion fehlt.
 Eine Einführung in die Entwicklung von Erweiterungen für {CMK} erhalten Sie in einem xref:devel_intro#[eigenen Artikel].
 endif::[]
 

src/common/en/intro_extend.asciidoc

@@ -17,14 +17,16 @@ ifdef::onprem[]
 
 Even if monitoring is 'only' observation, the matter of IT security is still very important, especially when connecting and setting up remote systems.
 In the xref:security#[article on security] you will find an overview of topics with which you can optimize the security of your system.
+endif::[]
 
 
+ifdef::onprem[]
 [#distributed_monitoring]
 == Monitoring very large environments
 
 When your monitoring reaches a scale where you are monitoring thousands or even more hosts, questions of architecture and optimization become more urgent.
 One of the most important issues is xref:glossar#distributed_monitoring[distributed monitoring].
-Here you work with several {CMK} sites that are interconnected to form a large system and which can be configured centrally in xref:glossar#central_setup[central setup] if required.
+Here you work with several {CMK} sites that are interconnected to form a large system and which can be configured for a xref:glossar#central_setup[central setup] as needed.
 
 image::distributed_monitoring_overview_en.png[alt="Illustration of the relationship between several sites and their components in distributed monitoring."]
 endif::[]
@@ -35,6 +37,7 @@ endif::[]
 
 {CMK} can calculate very precisely how high the xref:availability#[availability] of hosts or services was within certain time frames, how many outages there were, how long such outages continued, and much more.
 
+.Availability of services is displayed as a percentage
 image::intro_availability.png[alt="List of services with their availability percentages."]
 
 ifdef::onprem[]
@@ -44,6 +47,7 @@ ifdef::saas[]
 Based on the availability data, the xref:sla#[SLA] software module enables a much more detailed evaluation for aid in complying with service level agreements -- and such agreements can even be actively monitored.
 endif::[]
 
+.The service level agreement for a service over the past 15 days
 image::sla_view_example_modern.png[alt="A service and its service level agreement for the last 15 days."]
 
 
@@ -53,6 +57,7 @@ image::sla_view_example_modern.png[alt="A service and its service level agreemen
 The xref:inventory#[HW/SW inventory] is actually no longer a part of monitoring, but {CMK} can use the already existing xref:glossar#agent[agents] to generate extensive information on the hardware and software in your monitored systems.
 This is very helpful for maintenance, license management or the automatic filling of configuration management databases.
 
+.The inventory data for a host is displayed in a structured tree
 image::inventory_example.png[alt="Tree representation of the HW/SW inventory data of a host."]
 
 
@@ -62,17 +67,21 @@ ifdef::onprem[]
 
 So far we have only dealt with monitoring the current states of hosts and services.
 A completely different matter is the evaluation of spontaneous messages that appear for instance in log files or which are sent via the syslog or SNMP traps.
-{CMK} filters relevant events from the incoming messages, and has a completely integrated system called the xref:ec#[Event Console] for this purpose.
+{CMK} filters relevant events from the incoming messages, and has a completely integrated system called the xref:glossar#ec[Event Console] for this purpose.
 
+.List of events in the Event Console
 image::ec_open_events.png[alt="List of events in the Event Console."]
+endif::[]
 
 
+ifdef::onprem[]
 [#nagvis]
 == Visualization using maps and diagrams
 
-With the integrated xref:nagvis#[NagVis] add-on in {CMK}, you can display states on customized maps or diagrams.
+Using the xref:nagvis#[NagVis] software module integrated into {CMK}, you can display states on customized maps or diagrams.
 This is excellent for creating appealing general overviews, such as on a monitor in a control room.
 
+.A geographic map created with NagVis with host/service state icons
 [{image-border}]
 image::intro_nagvis_map.png[alt="A geographic map created with NagVis with host/service state icons."]
 endif::[]
@@ -83,6 +92,7 @@ endif::[]
 
 With the xref:glossar#bi[Business Intelligence] software module integrated in {CMK}, you can derive the overall status of business-critical applications from the many individual status data and display these clearly.
 
+.An overall application state derived from individual states
 image::intro_bi_downtimes.png[alt="Tree representation in Business Intelligence with the overall state of an application derived from individual states."]
 
 
@@ -110,7 +120,7 @@ ifdef::onprem[]
 [#devel]
 == Developing your own plug-ins
 
-Even though {CMK} offers over 2000 check plug-ins, it can still sometimes be that a specific plug-in is missing.
+Even though {CMK} offers over 2000 xref:glossar#check_plugin[check plug-ins], it can still sometimes be that a specific plug-in is missing.
 An introduction to the development of extensions for {CMK} can be found in an xref:devel_intro#[own article].
 endif::[]
 
@@ -119,7 +129,7 @@ ifdef::saas[]
 [#devel]
 == Extending {CMK}
 
-Even though {CMK} offers over 2000 check plug-ins, it can still sometimes be that a specific function is missing.
+Even though {CMK} offers over 2000 xref:glossar#check_plugin[check plug-ins], it can still sometimes be that a specific function is missing.
 An introduction to the development of extensions for {CMK} can be found in an xref:devel_intro#[own article].
 endif::[]