You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/common/de/hosts_autoregister.asciidoc
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
// -*- coding: utf-8 -*-
2
+
// IGNORE
3
+
// NONASCII
2
4
include::global_attr.adoc[]
3
5
= Automatisch Hosts erstellen
4
-
:revdate: draft
5
6
:title: Automatisch Hosts erstellen
6
7
:description: Der {CMK}-Agent kann Objekte automatisch als zu überwachende Hosts in einer Instanz registrieren. Lesen Sie hier, wie Sie die Autoregistrierung umsetzen.
7
8
8
-
9
9
{related-start}
10
10
xref:wato_monitoringagents#[Monitoring-Agenten]
11
11
xref:agent_linux#[Linux überwachen]
@@ -87,10 +87,10 @@ Es bietet sich an, für die Autoregistrierung diesen Automationsbenutzer zu verw
87
87
Die automatisch erstellten Hosts sollen in einem neuen Ordner angelegt werden.
88
88
Sie können alternativ auch einen bestehenden Ordner verwenden, wenn Sie ihn so konfigurieren, wie es im Folgenden beschrieben ist.
89
89
90
-
Starten Sie die Erstellung eines Ordners mit [.guihint]#Setup > Hosts > Hosts > Add folder.#
90
+
Starten Sie die Erstellung eines Ordners mit [.guihint]#Setup > Hosts > Hosts > Add folder#.
91
91
Geben Sie dem Ordner im Kasten [.guihint]#Basic settings# einen Namen.
92
92
93
-
Im Kasten [.guihint]#Network address# geht es um die Option [.guihint]#IP address family.#
93
+
Im Kasten [.guihint]#Network address# geht es um die Option [.guihint]#IP address family#.
94
94
ifdef::onprem[]
95
95
Sollen die {CMK}-Agenten der zu erstellenden Hosts den xref:glossar#pull_mode[Pull-Modus] verwenden, können Sie den Standardwert [.guihint]#IPv4 only# unverändert lassen.
96
96
endif::[]
@@ -107,7 +107,7 @@ endif::[]
107
107
ifdef::saas[]
108
108
Mit [.guihint]#{CMK} agent connection mode# entscheiden Sie, dass der {CMK}-Agent im xref:glossar#push_mode[Push-Modus] arbeiten soll.
109
109
endif::[]
110
-
Aktivieren Sie schließlich bei [.guihint]#Bake agent packages# die Checkbox [.guihint]#Bake a generic agent package for this folder.#
110
+
Aktivieren Sie schließlich bei [.guihint]#Bake agent packages# die Checkbox [.guihint]#Bake a generic agent package for this folder#.
111
111
Damit nutzen Sie die Möglichkeit der xref:glossar#agent_bakery[Agentenbäckerei],
112
112
eine xref:wato_monitoringagents#agent_configurations[Agentenkonfiguration] für einen Ordner und alle darin enthaltenen *und* hinzukommenden Hosts zu erstellen.
113
113
@@ -134,7 +134,7 @@ ifdef::onprem[]
134
134
Den Regelsatz [.guihint]#Agent registration# gibt es nur ab {CE}.
135
135
endif::[]
136
136
Sie finden [.guihint]#Agent registration# unter [.guihint]#Setup > Agents# (sofern der xref:intro_gui#show_less_more[Show-more-Modus] aktiv ist) oder über die Suche im [.guihint]#Setup#-Menü.
137
-
Starten Sie mit [.guihint]#Add rule# die Erstellung einer neuen Regel und vergeben Sie im ersten Kasten [.guihint]#Properties,# wie bei {CMK} gewohnt, zuerst eine ID und einen Titel.
137
+
Starten Sie mit [.guihint]#Add rule# die Erstellung einer neuen Regel und vergeben Sie im ersten Kasten [.guihint]#Properties#, wie bei {CMK} gewohnt, zuerst eine ID und einen Titel.
138
138
139
139
Im folgenden Kasten [.guihint]#Matching criteria# bestimmen Sie, welche Labels akzeptiert werden, wenn der {CMK}-Server eine Anfrage zur Registrierung von einem Agenten erhält.
140
140
Diese _Agenten-Labels_ werden ausschließlich für die Autoregistrierung verwendet und sind andere als die xref:glossar#label[Labels], die sonst in {CMK} zur Kennzeichnung von Hosts und Services verwendet werden.
@@ -172,14 +172,14 @@ Hier können Sie per Makro auf die Werte derjenigen Agenten-Labels zugreifen, di
172
172
z.{nbsp}B. mit `$cmk/hostname-simple$` auf den vom {CMK}-Agenten gelieferten einfachen Host-Namen.
173
173
Die Vorlage können Sie dann, wenn gewünscht, verändern durch Umwandlung in Klein- oder Großbuchstaben sowie Ersetzungen mit regulären Ausdrücken und mit expliziten Host-Namen.
174
174
Dies sind übrigens die gleichen Optionen, die es bei der xref:piggyback.html#renamehosts[Anpassung der Namen von Piggyback Hosts] gibt.
175
-
Mehr Informationen finden Sie auch in der xref:user_interface#inline_help[Inline-Hilfe.]
175
+
Mehr Informationen finden Sie auch in der xref:user_interface#inline_help[Inline-Hilfe].
176
176
177
177
.Übernahme des einfachen Host-Namens, ergänzt um den Prefix `push-`
178
178
image::hosts_autoregister_rule_hostname_computation.png[alt="Regel zur Autoregistrierung mit Festlegung des Host-Namens."]
179
179
180
180
Zum Schluss wählen Sie dann noch im Kasten [.guihint]#Host creation# den xref:new_folder[vorbereiteten Ordner] aus, in dem die neuen Hosts landen sollen.
181
181
Zusätzlich können Sie noch Attribute bestimmen, die dem Host mitgegeben werden sollen.
182
-
Mehr zu diesen Attributen erfahren Sie im Artikel zur xref:hosts_setup#create_hosts[Verwaltung der Hosts.]
182
+
Mehr zu diesen Attributen erfahren Sie im Artikel zur xref:hosts_setup#create_hosts[Verwaltung der Hosts].
183
183
184
184
.Die neuen Hosts sollen im vorbereiteten Ordner `Autoregistered` erstellt werden
185
185
image::hosts_autoregister_rule_host_creation.png[alt="Regel zur Autoregistrierung mit Festlegung des Zielordners und der Host-Attribute."]
@@ -233,7 +233,7 @@ Im letzten Kasten [.guihint]#Conditions# dieser Regel wählen Sie als [.guihint]
233
233
[#bake]
234
234
=== Agentenpaket backen
235
235
236
-
Nun geht es weiter in der Agentenbäckerei mit [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX.#
236
+
Nun geht es weiter in der Agentenbäckerei mit [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX#.
237
237
Klicken Sie auf icon:button_bake_agents[alt="Symbol zum Backen der Agenten."] und backen Sie sich einen neuen Agenten.
238
238
ifdef::onprem[]
239
239
Als Ergebnis erhalten Sie zusätzlich zur Agentenkonfiguration [.guihint]#Vanilla (factory settings)# eine neue Zeile für die Konfiguration,
@@ -254,7 +254,7 @@ Das Agentenpaket muss nun auf jedem Host installiert werden, der eine Autoregist
254
254
Laden Sie das für das Betriebssystem des Hosts passende Agentenpaket herunter und installieren Sie es auf dem Host.
255
255
Das Vorgehen ist genauso, wie in der Agentenbäckerei üblich.
256
256
Mehr dazu finden Sie in den Artikeln zu den xref:wato_monitoringagents#bakery_download[Monitoring-Agenten],
257
-
dem xref:agent_linux#install[Linux-Agenten] und dem xref:agent_windows#install[Windows-Agenten.]
257
+
dem xref:agent_linux#install[Linux-Agenten] und dem xref:agent_windows#install[Windows-Agenten].
258
258
259
259
260
260
[#success]
@@ -298,7 +298,7 @@ Connection: myserver/mysite
298
298
Host name: push-myhost
299
299
----
300
300
301
-
Automatisch erstellte Hosts können Sie auch wieder xref:hosts_setup#hosts_autoremove[automatisch entfernen lassen.]
301
+
Automatisch erstellte Hosts können Sie auch wieder xref:hosts_setup#hosts_autoremove[automatisch entfernen lassen].
302
302
Ab {CE} bietet {CMK} damit die beiden wichtigsten Komponenten für das _Lifecycle Management_ von Hosts.
303
303
ifdef::onprem[]
304
304
Übrigens funktioniert die automatische Entfernung auch für manuell erstellte Hosts -- und das in allen Editionen.
@@ -360,7 +360,7 @@ ifdef::onprem[]
360
360
|Pfad |Bedeutung
361
361
|`~/var/agent-receiver/received-outputs/` |Enthält für jede Verbindung deren UUID als Softlink, der auf den Ordner mit der Agentenausgabe zeigt.
362
362
|`~/var/log/agent-registration.log` |Log-Datei für die Agentenregistrierung.
363
-
Sie können die Ausführlichkeit der Meldungen in 6 Stufen steuern über [.guihint]#Setup > General > Global settings > User interface > Logging > Agent registration.#
363
+
Sie können die Ausführlichkeit der Meldungen in 6 Stufen steuern über [.guihint]#Setup > General > Global settings > User interface > Logging > Agent registration#.
364
364
|`~/var/log/agent-receiver/` |Enthält die Log-Dateien des Agent Receivers.
Copy file name to clipboardExpand all lines: src/common/en/hosts_autoregister.asciidoc
+14-6Lines changed: 14 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,6 @@
1
1
// -*- coding: utf-8 -*-
2
-
// IGNORE pre
2
+
// IGNORE
3
+
// NONASCII
3
4
include::global_attr.adoc[]
4
5
= Automated host creation
5
6
:title: Automated host creation
@@ -40,7 +41,11 @@ ifdef::onprem[]
40
41
By the way, when configuring the folder, you can specify whether the agents for the hosts to be created there should work in xref:glossar#pull_mode[pull mode] or xref:glossar#push_mode[push mode].
41
42
endif::[]
42
43
43
-
Then comes the {CMK} agent: Here, the information for a registration request is specified by an agent rule and then packed (baked) into an agent package by the Agent Bakery.
44
+
Then comes the {CMK} agent:
45
+
Here, the information for a registration request is specified by an agent rule and then packed (baked) into an agent package by the Agent Bakery.
46
+
ifdef::onprem[]
47
+
This includes selecting the {CMK} site that will monitor the host, which in a xref:glossar.html#distributed_monitoring[distributed monitoring] will usually be a remote site.
48
+
endif::[]
44
49
This agent package configured for auto-registration is then installed on the hosts that are to be able to perform auto-registration.
45
50
46
51
How all of this actually works is explained in the following chapters.
@@ -82,7 +87,7 @@ It makes sense to use this automation user for auto-registration, which is not a
82
87
The automatically created hosts are to be created in a new folder.
83
88
Alternatively, you can use an existing folder if you configure that folder as described below.
84
89
85
-
Start the creation of a folder with [.guihint]#Setup > Hosts > Hosts > Add folder.#
90
+
Start the creation of a folder with [.guihint]#Setup > Hosts > Hosts > Add folder#.
86
91
Give the new folder a name in the [.guihint]#Basic settings# box.
87
92
88
93
The [.guihint]#Network address# box includes the [.guihint]#IP address family# option.
@@ -201,8 +206,11 @@ Create a new rule.
201
206
In the [.guihint]#Agent controller auto-registration# box, provide the Agent Controller with all of the information it needs to make a registration request to the Agent Receiver:
202
207
the {CMK} server ([.guihint]#Monitoring server address#),
203
208
if applicable, the port number for the Agent Receiver ([.guihint]#Agent receiver port#),
204
-
the {CMK} site ([.guihint]#Site to register with#) and
205
-
the xref:user[automation user] for auto-registration.
209
+
the xref:user[automation user] for auto-registration ([.guihint]#Authorization#)
210
+
and the {CMK} site ([.guihint]#Site to register with#) that is to monitor the host.
211
+
ifdef::onprem[]
212
+
In a xref:glossar.html#distributed_monitoring[distributed monitoring], this will usually be a remote site.
213
+
endif::[]
206
214
207
215
You can also define your own labels here at the [.guihint]#Additional agent labels to send during registration# option.
208
216
For the auto-registration to work, these labels must match the ones
@@ -351,7 +359,7 @@ ifdef::onprem[]
351
359
|File path |Description
352
360
|`~/var/agent-receiver/received-outputs/` |Contains for each connection its UUID as a soft link pointing to the folder containing the agent output.
353
361
|`~/var/log/agent-registration.log` |Log file for the agent registration.
354
-
You can control the verbosity of the messages in 6 levels via [.guihint]#Setup > General > Global settings > User interface > Logging > Agent registration.#
362
+
You can control the verbosity of the messages in 6 levels via [.guihint]#Setup > General > Global settings > User interface > Logging > Agent registration#.
355
363
|`~/var/log/agent-receiver/` |Contains the log files for the Agent Receiver.
0 commit comments