Skip to content

Commit b2fd6e1

Browse files
KNW-2103 done, pick-25
1 parent d9c772f commit b2fd6e1

2 files changed

Lines changed: 26 additions & 57 deletions

File tree

src/common/de/glossar.asciidoc

Lines changed: 14 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -14,12 +14,7 @@ include::global_attr.adoc[]
1414
[#agent]
1515
==== Agent
1616
Ein Agent sammelt die für das Monitoring relevanten Daten von einem Host ein.
17-
ifdef::onprem[]
1817
Das kann ein kleines, auf dem Host installiertes Programm sein (der {CMK}-Agent), ein unabhängig von {CMK} auf dem Host laufender SNMP-Agent, ein Spezialagent, der sich die Informationen über eine vom Zielsystem bereitgestellte API besorgt -- oder ein aktiver Check, der netzwerkbasierte Dienste abfragt.
19-
endif::[]
20-
ifdef::saas[]
21-
Das kann ein kleines, auf dem Host installiertes Programm sein (der {CMK}-Agent), ein Spezialagent, der sich die Informationen über eine vom Zielsystem bereitgestellte API besorgt -- oder ein aktiver Check, der netzwerkbasierte Dienste abfragt.
22-
endif::[]
2318

2419
Mehr unter xref:wato_monitoringagents#[Monitoring-Agenten.]
2520

@@ -52,6 +47,7 @@ Mehr unter xref:wato_monitoringagents#bakery[Die Agentenbäckerei.]
5247
==== Agentenplugin
5348
Ein Agentenplugin erweitert die Funktionen des standardmäßig ausgelieferten {CMK}-Agenten.
5449
Es ist ein kleines Programm oder Skript, das vom {CMK}-Agenten aufgerufen wird und die Ausgabe des Agenten um weitere Sektionen mit zusätzlichen Monitoring-Daten anreichert.
50+
Diese Daten werden auf dem {CMK}-Server von einem passenden Check-Plugin ausgewertet.
5551
Ein Beispiel für ein Agentenplugin ist der Agent Updater.
5652

5753
Mehr unter xref:agent_linux#plugins[Agent um Plugins erweitern.]
@@ -116,7 +112,7 @@ Das kann die abstrakte Gruppierung einzelner Komponenten oder eine geschäftskri
116112
So lässt sich etwa der Zustand einer Anwendung _E-Mail,_ bestehend aus diversen Hosts, Switches und Diensten wie SMTP und IMAP, über eine einzige Visualisierung erfassen.
117113
Auch die Formulierung gänzlich ungreifbarer und nicht-technischer Belange ist hier möglich, zum Beispiel die termingerechte Verfügbarkeit eines auszuliefernden Produkts:
118114
Dieses Ziel liegt in der Zukunft und hängt von vielen Aspekten ab, der Supply Chain, einem funktionierenden Maschinenpark, verfügbarem Personal etc.
119-
Etwaige Gefährdungen für dieses abstrakte Ziel ließen sich über das BI-Modul erfassen.
115+
Etwaige Gefährdungen für dieses abstrakte Ziel lassen sich über das BI-Modul erfassen.
120116

121117
Mehr unter xref:bi#[Business Intelligence (BI).]
122118

@@ -134,7 +130,7 @@ Mehr unter xref:monitoring_basics#checks[Checks.]
134130
==== Check-Plugin
135131
Check-Plugins sind in Python geschriebene Module, die auf der {CMK}-Instanz ausgeführt werden und die Services eines Hosts erstellen und auswerten.
136132
ifdef::onprem[]
137-
Ein Beispiel: Das Check-Plugin _df_, zu finden innerhalb einer Instanz unter `~/local/lib/python3/cmk_addons/plugins/<plug-in_family>/agent_based/` (bei Nutzung der Check-API V2) oder `~/local/lib/check_mk/base/plugins/agent_based/` (bei Nutzung der Check-API V1), erstellt aus den Daten eines Agenten in der Instanz Services für die vorhandenen eingebundenen Dateisysteme eines Hosts und überprüft diese Services anhand der Daten, also etwa wie viel freien Speicherplatz es noch gibt.
133+
Ein Beispiel: Das Check-Plugin _df_, zu finden innerhalb einer Instanz unter `~/local/lib/python3/cmk_addons/plugins/<plug-in_family>/agent_based/` (bei Nutzung der Check-API V2), erstellt aus den Daten eines Agenten in der Instanz Services für die vorhandenen eingebundenen Dateisysteme eines Hosts und überprüft diese Services anhand der Daten, also etwa wie viel freien Speicherplatz es noch gibt.
138134
endif::[]
139135
ifdef::saas[]
140136
Ein Beispiel: Das Check-Plugin _df_ erstellt aus den Daten eines Agenten in der Instanz Services für die vorhandenen eingebundenen Dateisysteme eines Hosts und überprüft diese Services anhand der Daten, also etwa wie viel freien Speicherplatz es noch gibt.
@@ -207,12 +203,7 @@ Siehe xref:flapping[Unstetig.]
207203
[#host]
208204
==== Host
209205
Ein Host im Sinne von {CMK} ist jedes eigenständige, physische oder virtuelle System, das von {CMK} überwacht wird.
210-
ifdef::onprem[]
211206
In der Regel handelt es sich um Dinge mit eigener IP-Adresse (Server, Switches, SNMP-Geräte, virtuelle Maschinen), aber auch um beispielsweise Docker Container oder andere logische Objekte ohne eine solche Adresse.
212-
endif::[]
213-
ifdef::saas[]
214-
In der Regel handelt es sich um Dinge mit eigener IP-Adresse (Server, virtuelle Maschinen), aber auch um beispielsweise Docker Container oder andere logische Objekte ohne eine solche Adresse.
215-
endif::[]
216207
Jeder Host hat immer einen der Zustände {UP}, {DOWN}, {UNREACH} oder {PEND} und immer mindestens einen Service.
217208

218209
Noch weiter heruntergebrochen:
@@ -318,7 +309,7 @@ Mehr unter xref:localchecks#[Lokale Checks.]
318309

319310
[#metric]
320311
==== Metrik
321-
Mess- und berechenbare Werte zu Hosts und Services in ihrem zeitlichen Verlauf, etwa Temperatur, Auslastung oder Verfügbarkeit, die beispielsweise für Graphen herangezogen werden können.
312+
Mess- und berechenbare Werte zu Services in ihrem zeitlichen Verlauf, etwa Temperatur, Auslastung oder Verfügbarkeit, die beispielsweise für Graphen herangezogen werden können.
322313
ifdef::onprem[]
323314
Vergangene Werte werden in RRDs (Round-Robin-Datenbank) gespeichert und halten diese in der Standardeinstellung bis zu 4 Jahre vor.
324315
endif::[]
@@ -370,16 +361,16 @@ Mehr unter xref:piggyback#[Der Piggyback-Mechanismus.]
370361
Im Pull-Modus lauscht der {CMK}-Agent am TCP-Port 6556 auf eingehende Verbindungen vom {CMK}-Server.
371362
Sobald der Agent eine Aufforderung erhält, schickt er die Monitoring-Daten an den Server.
372363
Hier geht die Initiative zur Datenübertragung vom Server aus, der die Daten vom Agenten quasi heran__zieht__.
373-
ifdef::saas[]
374-
// ES: This sentence may need attention for KNW-2113
375-
Der Pull-Modus ist der Standardweg zur Datenübertragung vom {CMK}-Agenten in den On-Premises-Editionen von {CMK}.
376-
Er steht in {CE} nicht zur Verfügung.
377-
endif::[]
378364
ifdef::onprem[]
379365
Der Pull-Modus ist der Standardweg zur Datenübertragung vom {CMK}-Agenten -- und funktioniert in allen {CMK}-Editionen.
380366

381367
Mehr unter xref:wato_monitoringagents#agents[Der {CMK}-Agent.]
382368
endif::[]
369+
ifdef::saas[]
370+
// ES: This sentence may need attention for KNW-2113
371+
Der Pull-Modus ist der Standardweg zur Datenübertragung vom {CMK}-Agenten in den On-Premises-Editionen von {CMK}.
372+
Er steht in {CE} nicht zur Verfügung.
373+
endif::[]
383374

384375

385376
[#push_mode]
@@ -388,7 +379,7 @@ Im Push-Modus sendet der {CMK}-Agent minütlich die Monitoring-Daten an den {CMK
388379
Der Agent _stößt_ also die Datenübertragung von sich aus an und wartet nicht auf eine Aufforderung des Servers.
389380
Der Push-Modus ist immer dann erforderlich, wenn der {CMK}-Server nicht auf das Netzwerk zugreifen kann, in dem sich der zu überwachende Host mit seinem Agenten befindet, also z.B. in einer Cloud-basierten Konfiguration.
390381
ifdef::onprem[]
391-
Daher gibt es den Push-Modus nur für {CCE}.
382+
Daher gibt es den Push-Modus nur in {CCE}.
392383
endif::[]
393384

394385
Mehr unter xref:wato_monitoringagents#agents[Der {CMK}-Agent.]
@@ -439,7 +430,7 @@ Mehr unter xref:wato_services#[Services verstehen und konfigurieren.]
439430

440431
[#service_discovery]
441432
==== Service-Erkennung
442-
Sobald ein Host dem Monitoring hinzugefügt wird, erkennt {CMK} automatisch alle verfügbaren Services, die ins Monitoring aufgenommen werden können -- und hält diese Liste auch im laufenden Betrieb stets aktuell.
433+
Sobald ein Host hinzugefügt wird, erkennt {CMK} automatisch alle verfügbaren Services, die ins Monitoring aufgenommen werden können -- und hält diese Liste auch im laufenden Betrieb stets aktuell.
443434
Die Service-Erkennung (englisch: _service discovery_) lässt sich aber auch jederzeit manuell über die Konfiguration eines Hosts starten.
444435

445436
Mehr unter xref:wato_services#[Services verstehen und konfigurieren.]
@@ -485,12 +476,7 @@ Mehr unter xref:snmp#[SNMP.]
485476

486477
[#special_agent]
487478
==== Spezialagent
488-
ifdef::onprem[]
489479
Auf einigen Systemen lässt sich der reguläre {CMK}-Agent nicht installieren und SNMP steht nicht (befriedigend) zur Verfügung.
490-
endif::[]
491-
ifdef::saas[]
492-
Auf einigen Systemen lässt sich der reguläre {CMK}-Agent nicht installieren.
493-
endif::[]
494480
Stattdessen bieten diese Systeme Management-APIs, die auf Telnet, SSH oder HTTP/XML basieren.
495481
Über einen Spezialagenten, der auf dem {CMK}-Server läuft, fragt {CMK} diese Schnittstellen ab, womit der Host per API in {CMK} integriert wird.
496482

@@ -531,6 +517,7 @@ ifdef::saas[]
531517
Ein verteiltes Monitoring gibt es nur in den On-Premises-Editionen von {CMK} und nicht in {CE}.
532518
endif::[]
533519

520+
534521
ifdef::onprem[]
535522
[#central_setup]
536523
==== Verteiltes Monitoring mit zentralem Setup
@@ -545,7 +532,7 @@ endif::[]
545532
ifdef::onprem[]
546533
[#virtual_appliance]
547534
==== Virtuelle Appliance
548-
Die virtuelle Appliance ist ein für VirtualBox oder VMware ESXi erstelltes System mit einer vorinstallierten, für {CMK} vorbereiteten Firmware.
535+
Die virtuelle Appliance ist ein für VMware ESXi, Microsoft Hyper-V oder Proxmox erstelltes System mit einer vorinstallierten, für {CMK} vorbereiteten Firmware.
549536
Sie beinhaltet eine grafischen Konfigurationsoberfläche, die jegliche Linux-Kenntnisse überflüssig macht.
550537

551538
Mehr unter xref:intro_setup#virtual_appliance[Virtuelle Appliance.]
@@ -574,9 +561,7 @@ endif::[]
574561
==== Werk
575562
Die Software-Entwicklung von {CMK} ist in sogenannten Werks organisiert.
576563
Jede Änderung, Fehlerbehebung oder Neuerung, die einen Einfluss auf die Erfahrung des Benutzers hat, wird in einem eigenen Werk erfasst, samt Hinweisen zu Auswirkungen und etwaigen Inkompatibilitäten.
577-
Die Liste der Werks gibt es direkt in {CMK} über das [.guihint]#Help#-Menü in der Navigationsleiste und auf der {CMK}-Homepage.
578-
579-
Mehr unter link:https://checkmk.com/de/werks[Werks.^]
564+
Die Liste der Werks gibt es direkt in {CMK} über das [.guihint]#Help#-Menü in der Navigationsleiste und auf der link:https://checkmk.com/werks[{CMK}-Website^].
580565

581566

582567
[#time_period]

src/common/en/glossar.asciidoc

Lines changed: 12 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -32,12 +32,7 @@ More under xref:active_checks#[Monitoring network services (Active checks)].
3232
[#agent]
3333
==== Agent
3434
An agent on a host collects data relevant for the monitoring.
35-
ifdef::onprem[]
3635
The agent can be a small program installed on the host (the {CMK} agent), or an SNMP agent running independently of {CMK} on the host, or a special agent that obtains the information through an API provided by the target system -- or an active check that queries network-based services.
37-
endif::[]
38-
ifdef::saas[]
39-
The agent can be a small program installed on the host (the {CMK} agent), a special agent that obtains the information through an API provided by the target system -- or an active check that queries network-based services.
40-
endif::[]
4136

4237
More under xref:wato_monitoringagents#[Monitoring agents].
4338

@@ -58,6 +53,7 @@ More under xref:wato_monitoringagents#bakery[The Agent Bakery].
5853
==== Agent plug-in
5954
An agent plug-in extends the functions of the standard agent supplied with {CMK}.
6055
It is a small program or script that is called by the {CMK} agent which enhances the agent's output with additional sections of monitoring data.
56+
This data is processed on the {CMK} server by a compatible check plug-in.
6157
An example of an agent plug-in is the Agent Updater.
6258

6359
More under xref:agent_linux#plugins[Extending agents with plug-ins].
@@ -107,7 +103,7 @@ This superordinate level can be an abstract grouping of individual components or
107103
For example, the status of an application _email,_ consisting of various hosts, switches and services such as SMTP and IMAP, can be combined into a single display.
108104
The formulation of completely intangible and non-technical considerations is also possible here, for example the on-time availability of a product to be delivered:
109105
This goal lies in the future and depends on many factors, such as the supply chain, reliably functioning production, available personnel, etc.
110-
Any threats to this abstract goal could be identified and captured via the BI module.
106+
Any threats to this abstract goal can be identified and captured via the BI module.
111107

112108
More under xref:bi#[Business Intelligence (BI)].
113109

@@ -125,7 +121,7 @@ More under xref:monitoring_basics#checks[Checks].
125121
==== Check plug-in
126122
Check plug-ins are modules written in Python that run on the {CMK} site and which create and evaluate the services of a host.
127123
ifdef::onprem[]
128-
For example, the check plug-in _df_, found within a site at `~/local/lib/python3/cmk_addons/plugins/<plug-in_family>/agent_based/` (when using the Check API V2) or `~/local/lib/check_mk/base/plugins/agent_based/` (when using the Check API V1), creates services for a host's existing mounted file systems based on data from an agent on the site, and checks those services against that data, such as how much free space is left.
124+
For example, the check plug-in _df_, found within a site at `~/local/lib/python3/cmk_addons/plugins/<plug-in_family>/agent_based/` (when using the Check API V2), creates services for a host's existing mounted file systems based on data from an agent on the site, and checks those services against that data, such as how much free space is left.
129125
endif::[]
130126
ifdef::saas[]
131127
For example, the check plug-in _df_ creates services for a host's existing mounted file systems based on data from an agent on the site, and checks those services against that data, such as how much free space is left.
@@ -246,12 +242,7 @@ More under xref:notifications#flapping[Flapping hosts and services].
246242
[#host]
247243
==== Host
248244
Under {CMK}, a host is any stand alone, physical or virtual system that is monitored by {CMK}.
249-
ifdef::onprem[]
250245
These are usually components with their own IP address (servers, switches, SNMP devices, virtual machines), but also, for example, Docker containers or other logical objects which do not have such an IP address.
251-
endif::[]
252-
ifdef::saas[]
253-
These are usually components with their own IP address (servers, virtual machines), but also, for example, Docker containers or other logical objects which do not have such an IP address.
254-
endif::[]
255246
Each host always has one of the states {UP}, {DOWN}, {UNREACH} or {PEND}, and always has at least one service.
256247

257248
Broken down even further:
@@ -325,7 +316,7 @@ More under xref:localchecks#[Local checks].
325316

326317
[#metric]
327318
==== Metric
328-
Measurable and calculable values for hosts and services over time, such as temperature, utilization or availability, which can be used for graphs, for example.
319+
Measurable and calculable values for services over time, such as temperature, utilization or availability, which can be used for graphs, for example.
329320
ifdef::onprem[]
330321
Past values are stored in RRDs (Round Robin Database) and by default retained for up to 4 years.
331322
endif::[]
@@ -386,15 +377,15 @@ More under xref:piggyback#[The piggyback mechanism].
386377
In the pull mode, the {CMK} agent listens for incoming connections from the {CMK} server on TCP port 6556.
387378
As soon as the agent receives a request, it sends the monitoring data to the server.
388379
Here, the initiative for data transmission comes from the server, which basically _pulls_ the data from the agent.
389-
ifdef::saas[]
390-
The pull mode is the default way to transmit data from the {CMK} agent in the on-premises editions of {CMK}.
391-
It is not available in {CE}.
392-
endif::[]
393380
ifdef::onprem[]
394381
The pull mode is the default way to transmit data from the {CMK} agent -- and works in all {CMK} editions.
395382

396383
See more at xref:wato_monitoringagents#agents[The {CMK} agent].
397384
endif::[]
385+
ifdef::saas[]
386+
The pull mode is the default way to transmit data from the {CMK} agent in the on-premises editions of {CMK}.
387+
It is not available in {CE}.
388+
endif::[]
398389

399390

400391
[#push_mode]
@@ -403,7 +394,7 @@ In the push mode, the {CMK} agent sends the monitoring data to the {CMK} server
403394
The agent _pushes_ the data transmission on its own and does not wait for a request from the server.
404395
The push mode is always required if the {CMK} server cannot access the network in which the host to be monitored and its agent are located, for example, in a cloud-based configuration.
405396
ifdef::onprem[]
406-
For this reason, the push mode is only available for {CCE}.
397+
For this reason, the push mode is only available in {CCE}.
407398
endif::[]
408399

409400
More at xref:wato_monitoringagents#agents[The {CMK} agent].
@@ -454,7 +445,7 @@ More under xref:wato_services#[Understanding and configuring services].
454445

455446
[#service_discovery]
456447
==== Service discovery
457-
As soon as a host has been added to the monitoring, {CMK} automatically detects all available services that can be included in the monitoring -- and keeps this list up to date even during operation.
448+
As soon as a host has been added, {CMK} automatically detects all available services that can be included in the monitoring -- and keeps this list up to date even during operation.
458449
A service discovery can also be started manually at any time via the configuration of a host function.
459450

460451
More under xref:wato_services#[Understanding and configuring services].
@@ -522,12 +513,7 @@ More under xref:snmp#[SNMP].
522513

523514
[#special_agent]
524515
==== Special agent
525-
ifdef::onprem[]
526516
On some systems, the regular {CMK} agent cannot be installed and SNMP is not (satisfactorily) available.
527-
endif::[]
528-
ifdef::saas[]
529-
On some systems, the regular {CMK} agent cannot be installed.
530-
endif::[]
531517
Instead, these systems provide management APIs based on Telnet, SSH or HTTP/XML.
532518
Via a special agent running on the {CMK} server, {CMK} queries these interfaces, integrating the host into {CMK} via API.
533519

@@ -556,7 +542,7 @@ More under xref:views#[Host and service views].
556542
ifdef::onprem[]
557543
[#virtual_appliance]
558544
==== Virtual appliance
559-
The virtual appliance is a system created for VirtualBox or VMware ESXi with pre-installed firmware prepared for {CMK}.
545+
The virtual appliance is a system created for VMware ESXi, Microsoft Hyper-V, or Proxmox with pre-installed firmware prepared for {CMK}.
560546
It includes a graphical configuration interface that eliminates the need for any Linux knowledge.
561547

562548
More under xref:intro_setup#virtual_appliance[Virtual appliance].
@@ -578,6 +564,4 @@ endif::[]
578564
==== Werk
579565
The {CMK} software development is organized in so-called 'Werks'.
580566
Each change, bug fix or new feature that will have an impact on the user's experience is recorded in a separate Werk, along with notes on impacts and any possible incompatibilities.
581-
The list of Werks is available directly in {CMK} via the [.guihint]#Help# menu in the navigation bar and on the {CMK} home page.
582-
583-
More under link:https://checkmk.com/werks[Werks^].
567+
The list of Werks is available directly in {CMK} via the [.guihint]#Help# menu in the navigation bar and on the link:https://checkmk.com/werks[{CMK} website^].

0 commit comments

Comments
 (0)