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
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>11.1. Nagios Plugin API</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="ch11.html" title="Kapitel 11. Entwicklung">
<link rel="prev" href="ch11.html" title="Kapitel 11. Entwicklung">
<link rel="next" href="epnplugins.html" title="11.2. Entwickeln von Plugins für die Nutzung mit Embedded Perl">
<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">11.1. Nagios Plugin API</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="ch11.html">Zurück</a> </td>
<th width="60%" align="center">Kapitel 11. Entwicklung</th>
<td width="20%" align="right"> <a accesskey="n" href="epnplugins.html">Weiter</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="11.1. Nagios Plugin API">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="pluginapi"></a>11.1. Nagios Plugin API</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="section">11.1.1. <a href="pluginapi.html#otherresources">Andere Ressourcen</a></span></dt>
<dt><span class="section">11.1.2. <a href="pluginapi.html#overview">Plugin-Überblick</a></span></dt>
<dt><span class="section">11.1.3. <a href="pluginapi.html#returncode">Return-Code</a></span></dt>
<dt><span class="section">11.1.4. <a href="pluginapi.html#outputspec">Spezifikation der Plugin-Ausgabe(n)</a></span></dt>
<dt><span class="section">11.1.5. <a href="pluginapi.html#outputexamples">Plugin-Beispielausgaben</a></span></dt>
<dt><span class="section">11.1.6. <a href="pluginapi.html#outputlengthrestrictions">Längenbeschränkungen von Plugin-Ausgaben</a></span></dt>
<dt><span class="section">11.1.7. <a href="pluginapi.html#examples">Beispiele</a></span></dt>
<dt><span class="section">11.1.8. <a href="pluginapi.html#perlplugins">Perl-Plugins</a></span></dt>
</dl></div>
<div class="section" title="11.1.1. Andere Ressourcen">
<div class="titlepage"><div><div><h3 class="title">
<a name="otherresources"></a>11.1.1. Andere Ressourcen</h3></div></div></div>
<p>Wenn Sie planen, Ihren eigenen Plugins für Icinga zu schreiben, dann besuchen Sie folgende Ressourcen:</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>Die offizielle <a class="link" href="https://www.monitoring-plugins.org" target="_top">Monitoring Plugins Projekt-Website</a></p>
</li>
<li class="listitem">
<p>Die offiziellen <a class="link" href="https://www.monitoring-plugins.org/doc/guidelines.html" target="_top">Monitoring Plugins
Entwicklungsrichtlinien</a></p>
</li>
</ul></div>
</div>
<div class="section" title="11.1.2. Plugin-Überblick">
<div class="titlepage"><div><div><h3 class="title">
<a name="overview"></a>11.1.2. Plugin-Überblick</h3></div></div></div>
<p>Scripts und ausführbare Programme müssen (mindestens) zwei Dinge tun, um als Icinga-Plugins zu funktionieren:</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>mit einem von verschiedenen möglichen Return-Codes enden</p>
</li>
<li class="listitem">
<p>mindestens eine Zeile Textausgabe an STDOUT zurückliefern</p>
</li>
</ul></div>
<p>Die inneren Abläufe Ihres Plugins sind für Icinga unwichtig. Ihr Plugin könnte den Zustand eines TCP-Ports prüfen, eine
Datenbankabfrage durchführen, den freien Plattenplatz ermitteln oder was immer benötigt wird, um etwas zu prüfen. Die Einzelheiten
hängen davon ab, was zu prüfen ist - das liegt an Ihnen.</p>
</div>
<div class="section" title="11.1.3. Return-Code">
<div class="titlepage"><div><div><h3 class="title">
<a name="returncode"></a>11.1.3. Return-Code</h3></div></div></div>
<p>Icinga ermittelt den Zustand eines Hosts oder Service über die Auswertung des Return-Codes des Plugins. Die folgenden
Tabellen zeigen eine Liste von gültigen Return-Codes zusammen mit ihren entsprechenden Service- oder Host-Zuständen.</p>
<div class="informaltable">
<table border="1">
<colgroup>
<col>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><p> <span class="bold"><strong>Plugin Return-Code</strong></span> </p></td>
<td><p> <span class="bold"><strong>Service-Zustand</strong></span> </p></td>
<td><p> <span class="bold"><strong>Host-Zustand</strong></span> </p></td>
</tr>
<tr>
<td><p>0</p></td>
<td><p>OK</p></td>
<td><p>UP</p></td>
</tr>
<tr>
<td><p>1</p></td>
<td><p>WARNING</p></td>
<td><p>UP oder DOWN/UNREACHABLE*</p></td>
</tr>
<tr>
<td><p>2</p></td>
<td><p>CRITICAL</p></td>
<td><p>DOWN/UNREACHABLE</p></td>
</tr>
<tr>
<td><p>3</p></td>
<td><p>UNKNOWN</p></td>
<td><p>DOWN/UNREACHABLE</p></td>
</tr>
</tbody>
</table>
</div>
<p><span class="inlinemediaobject"><img src="../images/note.gif"></span> Anmerkung: Wenn die <a class="link" href="configmain.html#configmain-use_aggressive_host_checking">use_aggressive_host_checking</a>-Option aktiviert ist, dann ergibt ein Return-Code
von 1 einen Host-Zustand "DOWN" oder "UNREACHABLE". Andernfalls ergibt ein Return-Code von 1 einen Host-Zustand "UP". Der Prozess, durch
den Icinga ermittelt, ob ein Host DOWN oder UNREACHABLE ist, wird <a class="link" href="networkreachability.html" title="5.10. Ermitteln des Zustands und der Erreichbarkeit von Netzwerk-Hosts">hier</a> erklärt.</p>
</div>
<div class="section" title="11.1.4. Spezifikation der Plugin-Ausgabe(n)">
<div class="titlepage"><div><div><h3 class="title">
<a name="outputspec"></a>11.1.4. Spezifikation der Plugin-Ausgabe(n)</h3></div></div></div>
<p>Als Minimum sollten Plugins mindestens eine Zeile Textausgabe zurückliefern, es können aber auch mehrere Zeilen Ausgaben sein.
Plugins können zusätzlich Performance-Daten zurückliefern, die von externen Applikationen verarbeitet werden können. Das grundlegende
Format für Plugin-Ausgaben ist wie folgt:</p>
<p><span class="color"><font color="red">TEXT OUTPUT</font></span> | <span class="color"><font color="#FFA500">OPTIONAL
PERFDATA</font></span></p>
<p><span class="color"><font color="blue">LONG TEXT LINE 1</font></span></p>
<p><span class="color"><font color="blue">LONG TEXT LINE 2</font></span></p>
<p><span class="color"><font color="blue">...</font></span></p>
<p><span class="color"><font color="blue">LONG TEXT LINE N</font></span> | <span class="color"><font color="#FFA500">PERFDATA LINE
2</font></span></p>
<p><span class="color"><font color="#FFA500">PERFDATA LINE 3</font></span></p>
<p><span class="color"><font color="#FFA500">...</font></span></p>
<p><span class="color"><font color="#FFA500">PERFDATA LINE N</font></span></p>
<p>Die Performance-Daten (in <span class="color"><font color="#FFA500">orange</font></span> dargestellt) sind optional. Wenn ein Plugin
Performance-Daten in der Ausgabe zurückliefert, dann müssen die Performance-Daten von den anderen Textausgaben mit einem Pipe-Symbol (|)
getrennt werden. Zusätzliche Zeilen von langen Textausgaben (in <span class="color"><font color="blue">blau</font></span> dargestellt)
sind ebenso optional.</p>
</div>
<div class="section" title="11.1.5. Plugin-Beispielausgaben">
<div class="titlepage"><div><div><h3 class="title">
<a name="outputexamples"></a>11.1.5. Plugin-Beispielausgaben</h3></div></div></div>
<p>Nun ein paar Beispiele von möglichen Plugin-Ausgaben...</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p><span class="bold"><strong>Fall 1: Eine Zeile Ausgabe (nur Text)</strong></span></p>
<p>Angenommen, wir haben ein Plugin, das eine Zeile ausgibt, dann sieht das wie folgt aus:</p>
<p>DISK OK - free space: / 3326 MB (56%); Wenn dieses Plugin benutzt wurde, um eine Service-Prüfung durchzuführen, wird die
gesamte Zeile der Ausgabe im <a class="link" href="macrolist.html#macrolist-serviceoutput">$SERVICEOUTPUT$</a>-Makro gespeichert.</p>
</li>
<li class="listitem">
<p><span class="bold"><strong>Fall 2: Eine Zeile Ausgabe (Text und Performance-Daten)</strong></span></p>
<p>Ein Plugin kann optionale Performance-Daten zurückliefern, die von externen Applikationen benutzt werden. Um dies zu tun,
müssen die Performance-Daten von der Textausgabe durch ein Pipe-Symbol (|) wie folgt getrennt werden:</p>
<p><span class="color"><font color="red">DISK OK - free space: / 3326 MB (56%);</font></span> | <span class="color"><font color="#FFA500">/=2643MB;5948;5958;0;5968</font></span>. Wenn dieses Plugin benutzt wurde, um eine Service-Prüfung durchzuführen, wird
der <span class="color"><font color="red">rote</font></span> Teil der Ausgabe (links vom Pipe-Symbol) im <a class="link" href="macrolist.html#macrolist-serviceoutput">$SERVICEOUTPUT$</a>-Makro und der <span class="color"><font color="#FFA500">orange</font></span>
Teil der Ausgabe (rechts vom Pipe-Symbol) im <a class="link" href="macrolist.html#macrolist-serviceperfdata">$SERVICEPERFDATA$</a>-Makro
gespeichert.</p>
</li>
<li class="listitem">
<p><span class="bold"><strong>Fall 3: Mehrere Zeilen Ausgaben (Text und Performance-Daten)</strong></span></p>
<p>Ein Plugin kann optional mehrere Zeilen von Text und Performance-Daten wie folgt zurückliefern:</p>
<p class="simpara"><span class="color"><font color="red">DISK OK - free space: / 3326 MB (56%);</font></span></p>
<p> | <span class="color"><font color="#FFA500">/=2643MB;5948;5958;0;5968</font></span></p>
<p><span class="color"><font color="blue">/ 15272 MB (77%);</font></span></p>
<p><span class="color"><font color="blue">/boot 68 MB (69%);</font></span></p>
<p><span class="color"><font color="blue">/home 69357 MB (27%);</font></span></p>
<p><span class="color"><font color="blue">/var/log 819 MB (84%);</font></span> | <span class="color"><font color="#FFA500">/boot=68MB;88;93;0;98</font></span></p>
<p><span class="color"><font color="#FFA500">/home=69357MB;253404;253409;0;253414</font></span></p>
<p><span class="color"><font color="#FFA500">/var/log=818MB;970;975;0;980</font></span></p>
<p>Wenn dieses Plugin benutzt wurde, um eine Service-Prüfung durchzuführen, wird der <span class="color"><font color="red">rote</font></span> Teil der ersten Zeile der Ausgabe (links vom Pipe-Symbol) im <a class="link" href="macrolist.html#macrolist-serviceoutput">$SERVICEOUTPUT$</a>-Makro gespeichert. Der <span class="color"><font color="#FFA500">orange</font></span> Teil der ersten und folgender Zeilen wird (durch Leerzeichen verbunden) im <a class="link" href="macrolist.html#macrolist-serviceperfdata">$SERVICEPERFDATA$</a>-Makro gespeichert. Der <span class="color"><font color="blue">blaue</font></span> Teil der zweiten bis fünften Zeile der Ausgabe wird (mit maskierten Newlines) verkettet und im <a class="link" href="macrolist.html#macrolist-longserviceoutput">$LONGSERVICEOUTPUT$</a>-Makro gespeichert.</p>
<p>Der endgültige Inhalt jedes Makros ist wie folgt:</p>
<div class="informaltable">
<table border="1">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td><p> <span class="bold"><strong>Makro</strong></span> </p></td>
<td><p> <span class="bold"><strong>Wert</strong></span> </p></td>
</tr>
<tr>
<td><p>$SERVICEOUTPUT$</p></td>
<td><p> <span class="color"><font color="red">DISK OK - free space: / 3326 MB (56%);</font></span> </p></td>
</tr>
<tr>
<td><p>$SERVICEPERFDATA$</p></td>
<td><p> <span class="color"><font color="#FFA500">/=2643MB;5948;5958;0;5968 /boot=68MB;88;93;0;98 /home=69357MB;253404;253409;0;253414 /var/log=818MB;970;975;0;980</font></span>
</p></td>
</tr>
<tr>
<td><p>$LONGSERVICEOUTPUT$</p></td>
<td><p> <span class="color"><font color="blue">/ 15272 MB (77%);\n/boot 68 MB (69%);\n/var/log 819 MB
(84%);</font></span> </p></td>
</tr>
</tbody>
</table>
</div>
</li>
</ul></div>
<p>Mit Blick auf mehrere Zeilen Ausgaben haben Sie die folgenden Möglichkeiten, Performance-Daten zurückzuliefern:</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>Sie können keinerlei Performance-Daten zurückliefern</p>
</li>
<li class="listitem">
<p>Sie können nur in der ersten Zeile Performance-Daten zurückliefern</p>
</li>
<li class="listitem">
<p>Sie können Performance-Daten in nachfolgenden Zeilen zurückliefern (nach der ersten)</p>
</li>
<li class="listitem">
<p>Sie können Performance-Daten in der ersten und folgenden Zeilen zurückliefern (wie oben gezeigt)</p>
</li>
</ul></div>
</div>
<div class="section" title="11.1.6. Längenbeschränkungen von Plugin-Ausgaben">
<div class="titlepage"><div><div><h3 class="title">
<a name="outputlengthrestrictions"></a>11.1.6. Längenbeschränkungen von Plugin-Ausgaben</h3></div></div></div>
<p>Icinga wird nur die ersten acht KB an Daten lesen, die ein Plugin zurückliefert. Dies wird getan, um durchgedrehte Plugins
davon abzuhalten, Megabyte oder Gigabyte an Daten an Icinga zurückzuliefern. Diese Beschränkung von acht KB kann einfach geändert
werden, wenn Sie das brauchen. Ändern Sie einfach den Wert der MAX_PLUGIN_OUTPUT_LENGTH-Definition in der
<span class="emphasis"><em>include/nagios.h.in</em></span>-Datei der Source-Code-Distribution und rekompilieren Sie Icinga. Wenn Sie die Kapazität
von acht KB durch Anpassung dieses Wertes ändern, dann stellen Sie sicht, dass Sie vor dem Kompilieren auch den Wert von
MAX_EXTERNAL_COMMAND_LENGTH in include/common.h erhöhen, damit Resultate von passiven Prüfungen in dieser Länge durch das External
Command File empfangen werden können.</p>
</div>
<div class="section" title="11.1.7. Beispiele">
<div class="titlepage"><div><div><h3 class="title">
<a name="examples"></a>11.1.7. Beispiele</h3></div></div></div>
<p>Wenn Sie nach Beispiel-Plugins suchen, um sie zu studieren, würden wir empfehlen, dass Sie die offiziellen Icinga-Plugins
herunterladen und den Code von verschiedenen C-, Perl- und Shell-Script-Plugins ansehen. Informationen, wie Sie die offiziellen Plugins
besorgen können, finden Sie <a class="link" href="plugins.html" title="5.1. Icinga Plugins">hier</a>.</p>
</div>
<div class="section" title="11.1.8. Perl-Plugins">
<div class="titlepage"><div><div><h3 class="title">
<a name="perlplugins"></a>11.1.8. Perl-Plugins</h3></div></div></div>
<p>Icinga bietet einen optionalen <a class="link" href="embeddedperl.html" title="7.18. Benutzen des Embedded Perl Interpreters">eingebauten Perl-Interpreter</a> (embedded Perl
interpreter), der die Ausführung von Perl-Plugins beschleunigen kann. Mehr Informationen zur Entwicklung von Perl-Plugins zur Nutzung
mit dem eingebauten Perl-Interpreter finden Sie <a class="link" href="embeddedperl.html" title="7.18. Benutzen des Embedded Perl Interpreters">hier</a>.</p>
<a class="indexterm" name="idm139734663397328"></a>
</div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="ch11.html">Zurück</a> </td>
<td width="20%" align="center"><a accesskey="u" href="ch11.html">Nach oben</a></td>
<td width="40%" align="right"> <a accesskey="n" href="epnplugins.html">Weiter</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Kapitel 11. Entwicklung </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td>
<td width="40%" align="right" valign="top"> 11.2. Entwickeln von Plugins für die Nutzung mit Embedded Perl</td>
</tr>
</table>
</div>
<P class="copyright">© 1999-2009 Ethan Galstad, 2009-2017 Icinga Development Team, https://www.icinga.com</P>
</body>
</html>
|
