File: adaptive.html

package info (click to toggle)
icinga 1.0.2-2%2Bsqueeze1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 33,952 kB
  • ctags: 13,294
  • sloc: xml: 154,821; ansic: 99,198; sh: 14,585; sql: 5,852; php: 5,126; perl: 2,838; makefile: 1,268
file content (143 lines) | stat: -rw-r--r-- 6,187 bytes parent folder | download | duplicates (2)
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
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Adaptive Monitoring</title>
<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.0.2 Documentation">
<link rel="up" href="ch06.html" title="Chapter 6. Advanced Topics">
<link rel="prev" href="embeddedperl.html" title="Using The Embedded Perl Interpreter">
<link rel="next" href="dependencychecks.html" title="Predictive Dependency Checks">
</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">Adaptive Monitoring</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="embeddedperl.html">Prev</a> </td>
<th width="60%" align="center">Chapter 6. Advanced Topics</th>
<td width="20%" align="right"> <a accesskey="n" href="dependencychecks.html">Next</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="Adaptive Monitoring">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="adaptive"></a><a name="adaptive_monitoring"></a>Adaptive Monitoring</h2></div></div></div>
  

  <p><span class="bold"><strong>Introduction</strong></span></p>

  <p>Icinga allows you to change certain commands and host and service check attributes during runtime. I'll refer to
  this feature as "adaptive monitoring". Please note that the adaptive monitoring features found in Icinga will probably
  not be of much use to 99% of users, but they do allow you to do some neat things.</p>

  <p><span class="bold"><strong>What Can Be Changed?</strong></span></p>

  <p>The following service check attributes can be changed during runtime:</p>

  <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
      <p>Check command (and command arguments)</p>
    </li>
<li class="listitem">
      <p>Check interval</p>
    </li>
<li class="listitem">
      <p>Max check attempts</p>
    </li>
<li class="listitem">
      <p>Check timeperiod</p>
    </li>
<li class="listitem">
      <p>Event handler command (and command arguments)</p>
    </li>
</ul></div>

  <p>The following host check attributes can be changed during runtime:</p>

  <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
      <p>Check command (and command arguments)</p>
    </li>
<li class="listitem">
      <p>Check interval</p>
    </li>
<li class="listitem">
      <p>Max check attempts</p>
    </li>
<li class="listitem">
      <p>Check timeperiod</p>
    </li>
<li class="listitem">
      <p>Event handler command (and command arguments)</p>
    </li>
</ul></div>

  <p>The following global attributes can be changed during runtime:</p>

  <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
      <p>Global host event handler command (and command arguments)</p>
    </li>
<li class="listitem">
      <p>Global service event handler command (and command arguments)</p>
    </li>
</ul></div>

  <p><span class="bold"><strong>External Commands For Adaptive Monitoring</strong></span></p>

  <p>In order to change global or host- or service-specific attributes during runtime, you must submit the appropriate <a class="link" href="extcommands.html" title="External Commands">external command</a> to Icinga via the <a class="link" href="configmain.html#configmain-command_file">external command
  file</a>. The table below lists the different attributes that may be changed during runtime, along with the external command
  to accomplish the job.</p>

  <p>A full listing of external commands that can be used for adaptive monitoring (along with examples of how to use them) can
  be found online at the following URL: <a class="link" href="http://www.nagios.org/developerinfo/externalcommands/" target="_top">http://www.nagios.org/developerinfo/externalcommands/</a></p>

  <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png"></td>
<th align="left">Note</th>
</tr>
<tr><td align="left" valign="top">
    <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
        <p>When changing check commands, check timeperiods, or event handler commands, it is important to note that the new
        values for these options must have been defined before Icinga was started. Any request to change a command or
        timeperiod to one which had not been defined when Icinga was started is ignored.</p>
      </li>
<li class="listitem">
        <p>You can specify command arguments along with the actual command name - just separate individual arguments from the
        command name (and from each other) using bang (!) characters. More information on how arguments in command definitions are
        processed during runtime can be found in the documentation on <a class="link" href="macros.html" title="Understanding Macros and How They Work">macros</a>.</p>
      </li>
</ul></div>
  </td></tr>
</table></div>
  <a class="indexterm" name="id1998739"></a>
  <a class="indexterm" name="id1998755"></a>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="embeddedperl.html">Prev</a> </td>
<td width="20%" align="center"><a accesskey="u" href="ch06.html">Up</a></td>
<td width="40%" align="right"> <a accesskey="n" href="dependencychecks.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Using The Embedded Perl
  Interpreter </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> Predictive Dependency Checks</td>
</tr>
</table>
</div>
<P class="copyright">© 2009-2010 Icinga Development Team, http://www.icinga.org</P>
</body>
</html>