1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>5.7. Passive Prüfungen (Passive Checks)</title>
<link rel="stylesheet" href="../stylesheets/icinga-docs.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
<meta name="keywords" content="Supervision, Icinga, Nagios, Linux">
<link rel="home" href="index.html" title="Icinga Version 1.14 Dokumentation">
<link rel="up" href="ch05.html" title="Kapitel 5. Die Grundlagen">
<link rel="prev" href="activechecks.html" title="5.6. Aktive Prüfungen (Active Checks)">
<link rel="next" href="statetypes.html" title="5.8. Statustypen">
<script src="../js/jquery-min.js" type="text/javascript"></script><script src="../js/icinga-docs.js" type="text/javascript"></script>
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<CENTER><IMG src="../images/logofullsize.png" border="0" alt="Icinga" title="Icinga"></CENTER>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">5.7. Passive Prüfungen (Passive Checks)</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="activechecks.html">Zurück</a> </td>
<th width="60%" align="center">Kapitel 5. Die Grundlagen</th>
<td width="20%" align="right"> <a accesskey="n" href="statetypes.html">Weiter</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="5.7. Passive Prüfungen (Passive Checks)">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="passivechecks"></a>5.7. Passive Prüfungen (Passive Checks)</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="section">5.7.1. <a href="passivechecks.html#introduction">Einführung</a></span></dt>
<dt><span class="section">5.7.2. <a href="passivechecks.html#usecases">Einsatzmöglichkeiten für passive Prüfungen</a></span></dt>
<dt><span class="section">5.7.3. <a href="passivechecks.html#howitworks">Wie passive Prüfungen arbeiten</a></span></dt>
<dt><span class="section">5.7.4. <a href="passivechecks.html#enable">Passive Prüfungen aktivieren</a></span></dt>
<dt><span class="section">5.7.5. <a href="passivechecks.html#servicecheckresults">Übermitteln von passiven Service-Prüfungsergebnissen</a></span></dt>
<dt><span class="section">5.7.6. <a href="passivechecks.html#hostcheckresults">Übermitteln von passiven Host-Prüfungsergebnissen</a></span></dt>
<dt><span class="section">5.7.7. <a href="passivechecks.html#hoststates">Passive Prüfungen und Host-Zustände</a></span></dt>
<dt><span class="section">5.7.8. <a href="passivechecks.html#checkresultsfromremotehosts">Übermitteln von passiven Prüfungsergebnissen von entfernten Hosts</a></span></dt>
</dl></div>
<div class="section" title="5.7.1. Einführung">
<div class="titlepage"><div><div><h3 class="title">
<a name="introduction"></a>5.7.1. Einführung</h3></div></div></div>
<p>In den meisten Fällen werden Sie Icinga nutzen, um Ihre Hosts und Services mit Hilfe von regelmäßig geplanten <a class="link" href="activechecks.html" title="5.6. Aktive Prüfungen (Active Checks)">aktiven Prüfungen</a> zu überwachen. Aktive Prüfungen können genutzt werden, um ein Gerät oder Service
gelegentlich "abzufragen". Icinga unterstützt auch einen Weg, Hosts und Services passiv zu überwachen statt aktiv. Die
Hauptmerkmale von passiven Prüfungen sind wie folgt:</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>passive Prüfungen werden von externen Anwendungen/Prozessen veranlasst und ausgeführt</p>
</li>
<li class="listitem">
<p>Ergebnisse von passiven Prüfungen werden an Icinga zur Verarbeitung übermittelt</p>
</li>
</ul></div>
<p>Der Hauptunterschied zwischen aktiven und passiven Prüfungen ist, dass aktive Prüfungen von Icinga veranlasst und
ausgeführt werden, während passive Prüfungen von externen Applikationen durchgeführt werden.</p>
</div>
<div class="section" title="5.7.2. Einsatzmöglichkeiten für passive Prüfungen">
<div class="titlepage"><div><div><h3 class="title">
<a name="usecases"></a>5.7.2. Einsatzmöglichkeiten für passive Prüfungen</h3></div></div></div>
<p>passive Prüfungen sind nützlich, um Services zu überwachen, die</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>von Natur aus asynchron sind und nicht effektiv durch Abfrage ihres Zustands auf einer regelmäßig geplanten Basis überwacht
werden können</p>
</li>
<li class="listitem">
<p>sich hinter einer Firewall befinden und nicht aktiv vom überwachenden Host aus geprüft werden können</p>
</li>
</ul></div>
<p>Beispiele für asynchrone Services, bei denen sich eine passive Überwachung lohnt, sind u.a. SNMP-Traps und Sicherheits-Alarme. Sie
wissen nie, wie viele (falls überhaupt) Traps oder Alarme Sie innerhalb eines vorgegebenen Zeitfensters erhalten, so dass es nicht
sinnvoll ist, ihren Status alle paar Minuten zu überwachen.</p>
<p>Passive Prüfungen werden auch genutzt, um <a class="link" href="distributed.html" title="7.6. Verteilte Überwachung">verteilte</a> oder <a class="link" href="redundancy.html" title="7.7. Redundante und Failover-Netzwerk-Überwachung">redundante</a> Überwachungsinstallationen zu konfigurieren.</p>
</div>
<div class="section" title="5.7.3. Wie passive Prüfungen arbeiten">
<div class="titlepage"><div><div><h3 class="title">
<a name="howitworks"></a>5.7.3. Wie passive Prüfungen arbeiten</h3></div></div></div>
<div class="mediaobject"><img src="../images/passivechecks.png"></div>
<p>Hier nun mehr Details, wie passive Prüfungen arbeiten...</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
<p>eine externe Applikation prüft den Status eines Hosts oder Service.</p>
</li>
<li class="listitem">
<p>die externe Applikation schreibt die Ergebnisse der Prüfung in das <a class="link" href="configmain.html#configmain-command_file">external command
file</a>.</p>
</li>
<li class="listitem">
<p>das nächste Mal, wenn Icinga das "external command file" liest, wird es die Ergebnisse aller passiven Prüfungen zur
späteren Verarbeitung in eine Queue stellen. Dieselbe Queue, die für die Speicherung von Ergebnissen von aktiven Prüfungen genutzt
wird, wird auch für die Speicherung von Ergebnissen von aktiven Prüfungen verwendet.</p>
</li>
<li class="listitem">
<p>Icinga wird periodisch ein <a class="link" href="configmain.html#configmain-check_result_reaper_frequency">check result reaper event</a>
ausführen und die Ergebnis-Queue abfragen. Jedes Service-Prüfungs-Ergebnis, das in der Queue gefunden wird, wird in der gleichen
Weise bearbeitet - unabhängig davon, ob die Prüfung aktiv oder passiv war. Icinga kann abhängig vom Prüfergebnis
Benachrichtigungen senden, Alarme protokollieren, usw.</p>
</li>
</ol></div>
<p>Die Verarbeitung von aktiven und passiven Prüfungsergebnissen ist tatsächlich identisch. Dies erlaubt eine nahtlose Integration
von externen Applikationen mit Icinga.</p>
</div>
<div class="section" title="5.7.4. Passive Prüfungen aktivieren">
<div class="titlepage"><div><div><h3 class="title">
<a name="enable"></a>5.7.4. Passive Prüfungen aktivieren</h3></div></div></div>
<p>Um passive Prüfungen in Icinga zu aktivieren, müssen Sie folgendes tun:</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>setzen Sie die <a class="link" href="configmain.html#configmain-accept_passive_service_checks">accept_passive_service_checks</a>-Direktive auf
1.</p>
</li>
<li class="listitem">
<p>setzen Sie die <span class="emphasis"><em>passive_checks_enabled</em></span>-Direktive in Ihren Host- und Service-Definitionen auf 1.</p>
</li>
</ul></div>
<p>Wenn Sie die Verarbeitung von passiven Prüfungen global deaktivieren wollen, setzen Sie die <a class="link" href="configmain.html#configmain-accept_passive_service_checks">accept_passive_service_checks</a>-Direktive auf 0.</p>
<p>Wenn Sie die Verarbeitung von passiven Prüfungen nur für ein paar Hosts oder Services deaktivieren wollen, nutzen Sie die
<span class="emphasis"><em>passive_checks_enabled</em></span>-Direktive in den Host- und/oder Service-Definitionen.</p>
</div>
<div class="section" title="5.7.5. Übermitteln von passiven Service-Prüfungsergebnissen">
<div class="titlepage"><div><div><h3 class="title">
<a name="servicecheckresults"></a>5.7.5. Übermitteln von passiven Service-Prüfungsergebnissen</h3></div></div></div>
<p>Externe Applikationen können passive Prüfungsergebisse an Icinga übermitteln, indem sie ein PROCESS_SERVICE_CHECK_RESULT
<a class="link" href="extcommands.html" title="7.1. Externe Befehle">external command</a> in das "external command file" schreiben.</p>
<p>Das Format des Befehls lautet wie folgt:</p>
<pre class="screen"> [<Zeitstempel>] PROCESS_SERVICE_CHECK_RESULT;<host_name>;<svc_description>;<return_code>;<plugin_output></pre>
<p>wobei...</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p><span class="emphasis"><em>timestamp</em></span> ist die Zeit im time_t-Format (Sekunden seit der UNIX-Epoche), zu der die Service-Prüfung
durchgeführt (oder übermittelt) wurde. Bitte beachten Sie das einzelne Leerzeichen nach der rechten Klammer.</p>
</li>
<li class="listitem">
<p><span class="emphasis"><em>host_name</em></span> ist der Kurzname des Hosts, der mit dem Service in der Service-Definition verbunden ist</p>
</li>
<li class="listitem">
<p><span class="emphasis"><em>svc_description</em></span> ist die Beschreibung des Service wie in der Service-Definition angegeben</p>
</li>
<li class="listitem">
<p><span class="emphasis"><em>return_code</em></span> ist der Return-Code der Prüfung (0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN)</p>
</li>
<li class="listitem">
<p><span class="emphasis"><em>plugin_output</em></span> ist die Textausgabe der Service-Prüfung (also die Ausgabe des Plugins)</p>
</li>
</ul></div>
<p><span class="inlinemediaobject"><img src="../images/note.gif"></span> Anmerkung: ein Service muss in Icinga definiert sein, bevor Sie passive Prüfungen für ihn abliefern
können! Icinga wird alle Prüfergebnisse für Services ignorieren, die nicht konfiguriert waren, bevor es das letzte Mal (neu)
gestartet wurde.</p>
<p><span class="inlinemediaobject"><img src="../images/tip.gif"></span> Ein Beispiel-Shell-Script, wie man passive Service-Prüfungsergebnisse an Icinga übermittelt, finden Sie in
der Dokumentation zu <a class="link" href="volatileservices.html" title="7.4. sprunghafte Services">sprunghaften Services</a>.</p>
</div>
<div class="section" title="5.7.6. Übermitteln von passiven Host-Prüfungsergebnissen">
<div class="titlepage"><div><div><h3 class="title">
<a name="hostcheckresults"></a>5.7.6. Übermitteln von passiven Host-Prüfungsergebnissen</h3></div></div></div>
<p>Externe Applikationen können passive Host-Prüfungsergebisse an Icinga übermitteln, indem sie ein PROCESS_HOST_CHECK_RESULT
<a class="link" href="extcommands.html" title="7.1. Externe Befehle">external command</a> in das "external command file" schreiben.</p>
<p>Das Format des Befehls lautet wie folgt:</p>
<pre class="screen"> [<timestamp>] PROCESS_HOST_CHECK_RESULT;<host_name>;<host_status>;<plugin_output></pre>
<p>wobei...</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p><span class="emphasis"><em>timestamp</em></span> ist die Zeit im time_t-Format (Sekunden seit der UNIX-Epoche), zu der die Host-Prüfung
durchgeführt (oder übermittelt) wurde. Bitte beachten Sie das einzelne Leerzeichen nach der rechten Klammer.</p>
</li>
<li class="listitem">
<p><span class="emphasis"><em>host_name</em></span> ist der Kurzname des Hosts (wie in der Host-Definition angegeben)</p>
</li>
<li class="listitem">
<p><span class="emphasis"><em>host_status</em></span> ist der Status des Hosts (0=UP, 1=DOWN, 2=UNREACHABLE)</p>
</li>
<li class="listitem">
<p><span class="emphasis"><em>plugin_output</em></span> ist die Textausgabe der Host-Prüfung (also die Ausgabe des Plugins)</p>
</li>
</ul></div>
<p><span class="inlinemediaobject"><img src="../images/note.gif"></span> Anmerkung: ein Host muss in Icinga definiert sein, bevor Sie passive Prüfungen für ihn abliefern können!
Icinga wird alle Prüfergebnisse für Hosts ignorieren, die nicht konfiguriert waren, bevor es das letzte Mal (neu) gestartet
wurde.</p>
</div>
<div class="section" title="5.7.7. Passive Prüfungen und Host-Zustände">
<div class="titlepage"><div><div><h3 class="title">
<a name="hoststates"></a>5.7.7. Passive Prüfungen und Host-Zustände</h3></div></div></div>
<p>Icinga versucht bei passiven Prüfungen - anders bei aktiven Prüfungen - nicht festzustellen, ob der Host DOWN oder
UNREACHABLE ist. Statt dessen nimmt Icinga das passive Prüfergebnis als den wahren Status des Hosts und versucht nicht, den
wahren Host-Status mit Hilfe der <a class="link" href="networkreachability.html" title="5.10. Ermitteln des Zustands und der Erreichbarkeit von Netzwerk-Hosts">Erreichbarkeitslogik</a> zu ermitteln. Dies kann Probleme
verursachen, wenn Sie passive Prüfungen von einem entfernten Host übermitteln oder Sie ein <a class="link" href="distributed.html" title="7.6. Verteilte Überwachung">verteiltes
Überwachungs-Setup</a> haben, in dem Eltern/Kind-Verhältnisse unterschiedlich sind.</p>
<p>Sie können Icinga anweisen, die passiven Prüfergebnisse DOWN/UNREACHABLE-Zustände mit Hilfe der <a class="link" href="configmain.html#configmain-translate_passive_host_checks">translate_passive_host_checks</a>-Variable in ihre "sauberen" Zustände zu
übersetzen. Mehr Informationen wie dies funktioniert, finden Sie <a class="link" href="passivestatetranslation.html" title="7.22. Passive Host-Zustandsübersetzung">hier</a>.</p>
<p><span class="inlinemediaobject"><img src="../images/note.gif"></span> Anmerkung: Passive Host-Prüfungen werden normalerweise als <a class="link" href="statetypes.html" title="5.8. Statustypen">HARD-Zustände</a>
behandelt, falls nicht die <a class="link" href="configmain.html#configmain-passive_host_checks_are_soft">passive_host_checks_are_soft</a>-Option aktiviert
ist.</p>
</div>
<div class="section" title="5.7.8. Übermitteln von passiven Prüfungsergebnissen von entfernten Hosts">
<div class="titlepage"><div><div><h3 class="title">
<a name="checkresultsfromremotehosts"></a>5.7.8. Übermitteln von passiven Prüfungsergebnissen von entfernten Hosts</h3></div></div></div>
<div class="mediaobject"><img src="../images/nsca.png"></div>
<p>Wenn eine Applikation, die sich auf dem gleichen Host wie Icinga befindet, passive Host- oder Service-Prüfungsergebnisse
sendet, kann es die Ergebisse einfach direkt in das "external command file" schreiben wie oben skizziert. Allerdings können entfernte
Hosts das nicht so einfach tun.</p>
<p>Um es entfernten Hosts zu erlauben, passive Prüfungsergebnisse an den überwachenden Host zu senden, hat Ethan Galstad das <a class="link" href="addons.html#addons-nsca">NSCA</a>-Addon entwickelt. Das NSCA-Addon besteht aus einem Daemon, der auf dem
Icinga-Host läuft und einem Client, der auf entfernten Hosts ausgeführt wird. Der Daemon lauscht auf Verbindungen von entfernten
Hosts, führt mit den Ergebnissen einige grundlegende Gültigkeitsprüfungen durch und schreibt die Prüfergebnisse direkt in das "external
command file" (wie oben beschrieben). Mehr Informationen über das NSCA-Addon finden Sie <a class="link" href="addons.html#addons-nsca">hier</a>.</p>
<a class="indexterm" name="idm139734669952464"></a>
</div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="activechecks.html">Zurück</a> </td>
<td width="20%" align="center"><a accesskey="u" href="ch05.html">Nach oben</a></td>
<td width="40%" align="right"> <a accesskey="n" href="statetypes.html">Weiter</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">5.6. Aktive Prüfungen (Active Checks) </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td>
<td width="40%" align="right" valign="top"> 5.8. Statustypen</td>
</tr>
</table>
</div>
<P class="copyright">© 1999-2009 Ethan Galstad, 2009-2017 Icinga Development Team, https://www.icinga.com</P>
</body>
</html>
|
