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
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Passive Prüfungen (Passive Checks)</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
<meta name="keywords" content="Supervision, Icinga, Icinga, Linux">
<link rel="home" href="index.html" title="Icinga Version 1.0.2 Dokumentation">
<link rel="up" href="ch05.html" title="Kapitel 5. Die Grundlagen">
<link rel="prev" href="activechecks.html" title="Aktive Prüfungen (Active Checks)">
<link rel="next" href="statetypes.html" title="Statustypen">
</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">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="Passive Prüfungen (Passive Checks)">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="passivechecks"></a>Passive Prüfungen (Passive Checks)</h2></div></div></div>
<p><span class="bold"><strong>Einführung</strong></span></p>
<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="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>
<p><span class="bold"><strong>Einsatzmöglichkeiten für passive Prüfungen</strong></span></p>
<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="Verteilte Überwachung">verteilte</a> oder <a class="link" href="redundancy.html" title="Redundante und Failover-Netzwerk-Überwachung">redundante</a> Überwachungsinstallationen zu konfigurieren.</p>
<p><span class="bold"><strong>Wie passive Prüfungen arbeiten</strong></span></p>
<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>
<p><span class="bold"><strong>Passive Prüfungen aktivieren</strong></span></p>
<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>
<p><span class="bold"><strong>Übermitteln von passiven Service-Prüfungsergebnissen</strong></span></p>
<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="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="sprunghafte Services">sprunghaften Services</a>.</p>
<p><span class="bold"><strong>Übermitteln von passiven Host-Prüfungsergebnissen</strong></span></p>
<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="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>
<p><span class="bold"><strong>Passive Prüfungen und Host-Zustände</strong></span></p>
<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="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="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="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="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>
<p><span class="bold"><strong>Übermitteln von passiven Prüfungsergebnissen von entfernten Hosts</strong></span></p>
<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="id5588947"></a>
</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">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"> Statustypen</td>
</tr>
</table>
</div>
<P class="copyright">© 2009-2010 Icinga Development Team, http://www.icinga.org</P>
</body>
</html>
|
