File: embeddedperl.html

package info (click to toggle)
icinga 1.14.2%2Bds-3
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 49,264 kB
  • sloc: ansic: 108,564; sql: 9,656; sh: 4,945; perl: 3,439; makefile: 1,213; php: 581; xml: 104
file content (260 lines) | stat: -rw-r--r-- 15,179 bytes parent folder | download
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
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>7.18. Benutzen des Embedded Perl Interpreters</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="ch07.html" title="Kapitel 7. Fortgeschrittene Themen">
<link rel="prev" href="recurring_downtimes.html" title="7.17. Wiederkehrende Ausfallzeiten">
<link rel="next" href="adaptive.html" title="7.19. Adaptive Überwachung">
<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">7.18. Benutzen des Embedded Perl Interpreters</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="recurring_downtimes.html">Zurück</a> </td>
<th width="60%" align="center">Kapitel 7. Fortgeschrittene Themen</th>
<td width="20%" align="right"> <a accesskey="n" href="adaptive.html">Weiter</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="7.18. Benutzen des Embedded Perl Interpreters">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="embeddedperl"></a>7.18. Benutzen des Embedded Perl Interpreters</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="section">7.18.1. <a href="embeddedperl.html#pros">Vorteile</a></span></dt>
<dt><span class="section">7.18.2. <a href="embeddedperl.html#cons">Nachteile</a></span></dt>
<dt><span class="section">7.18.3. <a href="embeddedperl.html#interpreter">Benutzung des eingebetteten Perl-Interpreters</a></span></dt>
<dt><span class="section">7.18.4. <a href="embeddedperl.html#compileicinga">Icinga mit eingebettetem Perl kompilieren</a></span></dt>
<dt><span class="section">7.18.5. <a href="embeddedperl.html#idm139734665224016">Plugin-spezifische Benutzung des Perl-Interpreters</a></span></dt>
<dt><span class="section">7.18.6. <a href="embeddedperl.html#plugspecs">Plugins für die Nutzung mit Embedded Perl entwickeln</a></span></dt>
</dl></div>
  

  <div class="informaltable">
    <table border="0">
<colgroup>
<col>
<col>
</colgroup>
<tbody><tr>
<td align="left" valign="top">
<p>
               

              <span class="bold"><strong>Einführung</strong></span>

               
            </p> <p>Icinga kann für die Unterstützung eines eingebetteten Perl-Interpreters (embedded perl interpreter)
          kompiliert werden. Dies erlaubt es Icinga, Perl-Plugins effizienter als sonst auszuführen, also mag es interessant sein,
          wenn Sie sich viel auf Plugins verlassen, die in Perl geschrieben sind.</p> <p>Ohne den eingebetteten Perl-Interpreter führt
          Icinga Perl- (und andere) Plugins durch "forking" und ausführen als einen externen Befehl aus. Wenn der eingebettete
          Perl-Interpreter benutzt wird, kann Icinga Perl-Plugins durch einen einfachen Library-Call ausführen.</p>
          <p><span class="inlinemediaobject"><img src="../images/tip.gif"></span> Hinweis: Der Perl-Interpreter arbeitet mit allen Perl-Scripten, die Icinga ausführt - nicht nur
          Plugins. Diese Dokumentation behandelt den eingebetteten Perl-Interpreter in Verbindung mit Plugins für Host- und
          Service-Prüfungen, aber sie trifft genauso auf andere Arten von Perl-Scripten zu, die Sie vielleicht für andere Arten von Befehlen
          benutzen (z.B. Benachrichtigungs-Scripte, Eventhandler-Scripte usw.).</p> <p>Stephen Davis hat den originalen eingebetteten
          Perl-Interpreter-Code vor einigen Jahren beigetragen. Stanley Hopcroft war die erste Person, die geholfen hat, den eingebetteten
          Perl-Interpreter-Code zu verbessern und die die Vor- und Nachteile bei der Benutzung kommentiert hat. Er hat auch verschiedene
          hilfreiche Hinweise zur Erstellung von Perl-Plugins gegeben, die sauber mit dem eingebetteten Interpreter arbeiten.</p>
          <p>Es sollte angemerkt werden, dass sich "ePN" - wie in dieser Dokumentation benutzt - auf "embedded Perl Icinga"
          bezieht, oder wenn Sie das bevorzugen, Icinga mit eingebettetem Perl-Interpreter.</p>
</td>
<td align="left" valign="top"><p> <span class="inlinemediaobject"><img src="../images/epn.png"></span> </p></td>
</tr></tbody>
</table>
  </div>

  <div class="section" title="7.18.1. Vorteile">
<div class="titlepage"><div><div><h3 class="title">
<a name="pros"></a>7.18.1. Vorteile</h3></div></div></div>
    

    <p>Einige Vorteile von ePN (embedded Perl Icinga) umfassen:</p>

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>Icinga wird viel weniger Zeit bei der Ausführung Ihrer Perl-Plugins verbringen, weil es nicht länger "fork"t, um das
        Plugin auszuführen (das Laden des Perl-Interpreters entfällt). Statt dessen führt es das Plugin durch einen Library-Call
        durch.</p>
      </li>
<li class="listitem">
        <p>es reduziert die Systembelastung durch Perl-Plugins und/oder erlaubt es Ihnen, mehr Prüfungen mit Perl-Plugins durchzuführen,
        als Ihnen das sonst möglich wäre. Mit anderen Worten haben Sie weniger Anreiz, Plugins in anderen Sprachen wie z.B. C/C++, oder
        Expect/TCL zu schreiben, die bei den Entwicklungszeiten eine Zehnerpotenz langsamer angesehen werden als Perl (wobei sie auch
        zehnmal schneller ablaufen, von TCL mal abgesehen).</p>
      </li>
<li class="listitem">
        <p>Wenn Sie kein C-Programmierer sind, dann können Sie trotzdem eine Menge mit Perl erledigen, ohne dass es Icinga viel
        langsamer macht. Beachten Sie, dass ePN Ihre Plugins nicht schneller macht (außer, dass es die Ladezeit eliminiert). Wenn Sie
        schnelle Plugins wollen, dann berücksichtigen Sie Perl XSUBs (XS) oder C, <span class="emphasis"><em>nachdem</em></span> Sie sicher sind, dass Sie Ihr
        Perl getuned haben und dass Sie einen angemessenen Algorithmus haben (Benchmark.pm is <span class="emphasis"><em>unbezahlbar</em></span> für den
        Vergleich von Perl-Sprachelementen).</p>
      </li>
<li class="listitem">
        <p>ePN zu benutzen ist eine exzellente Gelegenheit, mehr über Perl zu lernen.</p>
      </li>
</ul></div>
  </div>

  <div class="section" title="7.18.2. Nachteile">
<div class="titlepage"><div><div><h3 class="title">
<a name="cons"></a>7.18.2. Nachteile</h3></div></div></div>
    

    <p>Die Nachteile von ePN (embedded Perl Icinga) sind ziemlich die gleichen wie bei Apache mod_perl (d.h. Apache
    mit einem eingebetteten Interpreter) verglichen mit einem schlichten Apache:</p>

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>Ein Perl-Programm, das <span class="emphasis"><em>wunderbar</em></span> mit schlichtem Icinga arbeitet, muss <span class="emphasis"><em>nicht</em></span>
        mit ePN funktionieren. Möglicherweise müssen Sie Ihre Plugins modifizieren, damit sie funktionieren.</p>

        <div class="important" title="Wichtig" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Wichtig]" src="../images/important.png"></td>
<th align="left">Wichtig</th>
</tr>
<tr><td align="left" valign="top">
          <p>Bitte beachten Sie, dass Ihr Plugin ggf. "Memory-Leaks" enthält, so dass es wichtig ist, dass Sie es mit
          <code class="filename">new_mini_epn</code> testen/verifizieren (das Sie im contrib-Verzeichnis finden).</p>
        </td></tr>
</table></div>
      </li>
<li class="listitem">
        <p>Perl-Plugins sind unter ePN schwieriger zu debuggen als unter schlichtem Icinga.</p>
      </li>
<li class="listitem">
        <p>Ihr ePN wird eine größere SIZE (Speichernutzung) haben als ein schlichtes Icinga.</p>
      </li>
<li class="listitem">
        <p>Einige Perl-Konstrukte können nicht genutzt werden oder mögen sich anders verhalten als Sie das erwarten würden.</p>
      </li>
<li class="listitem">
        <p>Sie sollte sich bewusst sein, dass es 'mehr als einen Weg gibt, es zu tun' und ggf. einen Weg wählen, der weniger attraktiv
        oder offensichtlich ist.</p>
      </li>
<li class="listitem">
        <p>Sie werden mehr Perl-Know-How benötigen (aber nichts sehr esoterisches oder Zeug über Perl-Interna - außer, wenn Ihre Plugins
        XSUBS benutzen).</p>
      </li>
</ul></div>
  </div>

  <div class="section" title="7.18.3. Benutzung des eingebetteten Perl-Interpreters">
<div class="titlepage"><div><div><h3 class="title">
<a name="interpreter"></a>7.18.3. Benutzung des eingebetteten Perl-Interpreters</h3></div></div></div>
    

    <p>Wenn Sie den eingebetteten Perl-Interpreter benutzen wollen, um Ihre Perl-Plugins und Scripts auszuführen, dann lesen Sie hier,
    was Sie tun müssen:</p>

    <div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
        <p>Kompilieren Sie Icinga mit Unterstützung für den eingebetteten Perl-Interpreter (Anweisungen s.u.).</p>
      </li>
<li class="listitem">
        <p>aktivieren Sie die <a class="link" href="configmain.html#configmain-enable_embedded_perl">enable_embedded_perl</a>-Option in der
        Hauptkonfigurationsdatei.</p>
      </li>
<li class="listitem">
        <p>setzen Sie die <a class="link" href="configmain.html#configmain-use_embedded_perl_implicitly">use_embedded_perl_implicitly</a>-Option entsprechend
        Ihren Anforderungen. Diese Option legt fest, ob der Perl-Interpreter per Default für einzelne Perl-Plugins und Scripts benutzt
        werden sollte.</p>
      </li>
<li class="listitem">
        <p>Optional sollten Sie bei verschiedenen Perl-Plugins und Scripts die Ausführung durch den eingebetteten Perl-Interpreter
        aktivieren oder deaktivieren. Das kann nützlich sein, wenn bestimmte Perl-Scripte Probleme bei der Ausführung mit dem
        Perl-Interpreter haben. Beachten Sie die Anweisungen weiter unten für mehr Informationen, wie das zu tun ist.</p>
      </li>
</ol></div>
  </div>

  <div class="section" title="7.18.4. Icinga mit eingebettetem Perl kompilieren">
<div class="titlepage"><div><div><h3 class="title">
<a name="compileicinga"></a>7.18.4. Icinga mit eingebettetem Perl kompilieren</h3></div></div></div>
    

    <p>Wenn Sie den eingebetteten Perl-Interpreter benutzen möchten, müssen Sie zuerst Icinga mit der Unterstützung dafür
    kompilieren. Um dies zu tun, starten Sie einfach das configure-Script zusätzlich mit der <span class="color"><font color="red">
    <span class="emphasis"><em>--enable-embedded-perl</em></span> </font></span> -Option. Wenn Sie aktivieren wollen, dass der Perl-Interpreter intern
    kompilierte Scripts in einem Cache ablegen soll, dann nutzen Sie die <span class="color"><font color="red">
    <span class="emphasis"><em>--with-perlcache</em></span> </font></span> -Option. Beispiel:</p>

    <pre class="screen"> ./configure --enable-embedded-perl --with-perlcache <span class="emphasis"><em> otheroptions...</em></span> </pre>

    <p>Sobald Sie das configure-Script mit den neuen Optionen ausgeführt haben, müssen Sie Icinga erneut kompilieren.</p>

    <p>Paket-Bauer können eine andere Option nutzen, um das Verzeichnis der <code class="filename">p1.pl</code> Datei anzugeben:</p>

    <pre class="screen"> ./configure --with-p1-file-dir=&lt;path&gt;</pre>
  </div>

  <div class="section" title="7.18.5. Plugin-spezifische Benutzung des Perl-Interpreters">
<div class="titlepage"><div><div><h3 class="title">
<a name="idm139734665224016"></a>7.18.5. Plugin-spezifische Benutzung des Perl-Interpreters</h3></div></div></div>
    

    <p>Sie können angeben, welche Perl-Plugins oder Scripts mit dem eingebetteten Perl-Interpreter ablaufen sollen und welche nicht. Das
    ist besonders dann nützlich, wenn Sie Perl-Scripte haben, die nicht sauber mit dem Perl-Interpreter laufen.</p>

    <p>Um Icinga <span class="emphasis"><em>explizit</em></span> mitzuteilen, ob der Perl-Interpreter benutzt werden soll oder nicht, fügen Sie
    Ihrem Perl-Script/Plugin einen der folgenden Einträge hinzu...</p>

    <p>Um Icinga mitzuteilen, den Perl-Interpreter für ein bestimmtes Script zu nutzen, fügen Sie dem Perl-Script diese Zeile
    hinzu:</p>

    <pre class="screen"> # icinga: +epn</pre>

    <p>Um Icinga mitzuteilen, den Perl-Interpreter für ein bestimmtes Script NICHT zu nutzen, fügen Sie dem Perl-Script diese
    Zeile hinzu:</p>

    <pre class="screen"> # icinga: -epn</pre>

    <p>Eine der beiden Zeilen muss innerhalb der ersten zehn Zeilen stehen, damit sie von Icinga erkannt wird.</p>

    <p><span class="inlinemediaobject"><img src="../images/tip.gif"></span> Hinweis: Wenn Sie nicht <span class="emphasis"><em>explizit</em></span> die oben genannte Methode nutzen, um Icinga
    mitzuteilen, den Perl-Interpreter für ein einzelnes Plugin zu nutzen, wird Icinga eine Entscheidung für Sie treffen. Dieser
    Entscheidungsprozess wird von der <a class="link" href="configmain.html#configmain-use_embedded_perl_implicitly">use_embedded_perl_implicitly</a>-Variable
    kontrolliert. Wenn der Wert auf 1 gesetzt ist, werden alle Perl-Plugins/Scripts (bei denen nicht explizit der ePN aktiviert/deaktiviert
    ist) mit dem Perl-Interpreter ausgeführt. Wenn der Wert auf 0 gesetzt ist, werden sie NICHT mit dem Perl-Interpreter ausgeführt.</p>
  </div>

  <div class="section" title="7.18.6. Plugins für die Nutzung mit Embedded Perl entwickeln">
<div class="titlepage"><div><div><h3 class="title">
<a name="plugspecs"></a>7.18.6. Plugins für die Nutzung mit Embedded Perl entwickeln</h3></div></div></div>
    

    <p>Informationen über die Entwicklung von Plugins zur Nutzung mit dem eingebetteten Perl-Interpreter finden Sie <a class="link" href="epnplugins.html" title="11.2. Entwickeln von Plugins für die Nutzung mit Embedded Perl">hier</a>.</p>

    <a class="indexterm" name="idm139734665212816"></a>
  </div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="recurring_downtimes.html">Zurück</a> </td>
<td width="20%" align="center"><a accesskey="u" href="ch07.html">Nach oben</a></td>
<td width="40%" align="right"> <a accesskey="n" href="adaptive.html">Weiter</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">7.17. Wiederkehrende Ausfallzeiten </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td>
<td width="40%" align="right" valign="top"> 7.19. Adaptive Überwachung</td>
</tr>
</table>
</div>
<P class="copyright">© 1999-2009 Ethan Galstad, 2009-2017 Icinga Development Team, https://www.icinga.com</P>
</body>
</html>