File: extcommands.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 (150 lines) | stat: -rw-r--r-- 8,099 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
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>7.1. Externe Befehle</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="ch07.html" title="Kapitel 7. Fortgeschrittene Themen">
<link rel="next" href="extcommands2.html" title="7.2. Liste der externen Befehle">
<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.1. Externe Befehle</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="ch07.html">Zurück</a> </td>
<th width="60%" align="center">Kapitel 7. Fortgeschrittene Themen</th>
<td width="20%" align="right"> <a accesskey="n" href="extcommands2.html">Weiter</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="7.1. Externe Befehle">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="extcommands"></a>7.1. Externe Befehle</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="section">7.1.1. <a href="extcommands.html#introduction">Einführung</a></span></dt>
<dt><span class="section">7.1.2. <a href="extcommands.html#enable">Externe Befehle aktivieren</a></span></dt>
<dt><span class="section">7.1.3. <a href="extcommands.html#whenchecked">Wann prüft Icinga auf externe Befehle?</a></span></dt>
<dt><span class="section">7.1.4. <a href="extcommands.html#usage">Externe Befehle benutzen</a></span></dt>
<dt><span class="section">7.1.5. <a href="extcommands.html#format">Befehlsformat</a></span></dt>
</dl></div>
  

  <a class="indexterm" name="idm139734803538448"></a>

  <div class="section" title="7.1.1. Einführung">
<div class="titlepage"><div><div><h3 class="title">
<a name="introduction"></a>7.1.1. Einführung</h3></div></div></div>
    

    <p>Icinga kann Befehle aus externen Applikationen verarbeiten (einschließlich der CGIs) und verschiedene Aspekte seiner
    Überwachungsfunktionen aufgrund der Befehle verändern, die es erhält. Externe Applikationen können Befehle "einreichen", indem sie in
    das <a class="link" href="configmain.html#configmain-command_file">command file</a> schreiben, das regelmäßig vom Icinga-Daemon verarbeitet
    wird.</p>

    <div class="mediaobject" align="right"><img src="../images/externalcommands.png" align="right"></div>
  </div>

  <div class="section" title="7.1.2. Externe Befehle aktivieren">
<div class="titlepage"><div><div><h3 class="title">
<a name="enable"></a>7.1.2. Externe Befehle aktivieren</h3></div></div></div>
    

    <p>Damit Icinga externe Befehle verarbeitet, müssen Sie folgendes tun:</p>

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>aktivieren Sie die Prüfung auf externe Befehle mit der <a class="link" href="configmain.html#configmain-check_external_commands">check_external_commands</a>-Option.</p>
      </li>
<li class="listitem">
        <p>setzen Sie die Wiederholrate von Befehlsprüfungen mit der <a class="link" href="configmain.html#configmain-command_check_interval">command_check_interval</a>-Option.</p>
      </li>
<li class="listitem">
        <p>definieren Sie den Ort des Command-File mit der <a class="link" href="configmain.html#configmain-command_file">command_file</a>-Option.</p>
      </li>
<li class="listitem">
        <p>setzen Sie korrekte Berechtigungen für das Verzeichnis, welches das External-Command-File enthält, wie in der <a class="link" href="quickstart.html" title="2.3. Schnellstart-Installationsanleitungen">Schnellstartanleitung</a> beschrieben.</p>
      </li>
</ul></div>
  </div>

  <div class="section" title="7.1.3. Wann prüft Icinga auf externe Befehle?">
<div class="titlepage"><div><div><h3 class="title">
<a name="whenchecked"></a>7.1.3. Wann prüft Icinga auf externe Befehle?</h3></div></div></div>
    

    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>in regelmäßigen Intervallen, wie sie durch die Option <a class="link" href="configmain.html#configmain-command_check_interval">command_check_interval</a> in der Hauptkonfigurationsdatei angegeben sind</p>
      </li>
<li class="listitem">
        <p>direkt nachdem <a class="link" href="eventhandlers.html" title="7.3. Eventhandler">Eventhandler</a> ausgeführt werden. Das passiert zusätzlich zum regelmäßigen
        Zyklus von externen Befehlsprüfungen und wird getan, um unverzügliche Aktivitäten zu ermöglichen, falls ein Eventhandler Befehle an
        Icinga schickt.</p>
      </li>
</ul></div>
  </div>

  <div class="section" title="7.1.4. Externe Befehle benutzen">
<div class="titlepage"><div><div><h3 class="title">
<a name="usage"></a>7.1.4. Externe Befehle benutzen</h3></div></div></div>
    

    <p>Externe Befehle können benutzt werden, um eine Reihe von Dingen zu erreichen, während Icinga läuft. Beispiele dafür, was
    getan werden kann, umfassen u.a. vorübergehend Benachrichtigungen für Services und Hosts zu deaktivieren, vorübergehend
    Service-Prüfungen zu deaktivieren, sofortige Service-Prüfungen zu erzwingen, Kommentare für Hosts und Services hinzuzufügen usw.</p>
  </div>

  <div class="section" title="7.1.5. Befehlsformat">
<div class="titlepage"><div><div><h3 class="title">
<a name="format"></a>7.1.5. Befehlsformat</h3></div></div></div>
<div class="toc"><dl><dt><span class="section">7.1.5.1. <a href="extcommands.html#externalcommandslist">External Commands Liste</a></span></dt></dl></div>
    

    <p>Externe Befehle, die in das <a class="link" href="configmain.html#configmain-command_file">command file</a> geschrieben werden, haben das folgende
    Format...</p>

    <pre class="screen"> [<span class="emphasis"><em> Zeit</em></span>] <span class="emphasis"><em> Befehls-ID</em></span>;<span class="emphasis"><em> Befehlsargumente</em></span> </pre>

    <p>...wobei <span class="emphasis"><em>Zeit</em></span> die Zeit (im <span class="emphasis"><em>time_t</em></span>-Format) ist, zu der die externe Applikation den
    externen Befehl an das Command-File geschickt hat. Die Werte für die <span class="emphasis"><em>Befehls-ID</em></span> und die
    <span class="emphasis"><em>Befehlsargumente</em></span> hängen davon ab, welcher Befehl an Icinga geschickt wird.</p>

    <div class="section" title="7.1.5.1. External Commands Liste">
<div class="titlepage"><div><div><h4 class="title">
<a name="externalcommandslist"></a>7.1.5.1. External Commands Liste</h4></div></div></div>
      

      <p>Eine komplette Liste der Befehle, die benutzt werden können, finden Sie in der <a class="link" href="extcommands2.html" title="7.2. Liste der externen Befehle">Liste der externen
      Befehle</a>.</p>
    </div>
  </div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="ch07.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="extcommands2.html">Weiter</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Kapitel 7. Fortgeschrittene Themen </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td>
<td width="40%" align="right" valign="top"> 7.2. Liste der externen Befehle</td>
</tr>
</table>
</div>
<P class="copyright">© 1999-2009 Ethan Galstad, 2009-2017 Icinga Development Team, https://www.icinga.com</P>
</body>
</html>