Project

General

Profile

MonitorIcingaEtAl » History » Version 10

Simone Piccardi, 04/19/2013 03:41 PM

1 1 Simone Piccardi
h1. Monitoraggio sistemi con Icinga & C.
2 1 Simone Piccardi
3 5 Simone Piccardi
h2. Installazione base
4 5 Simone Piccardi
5 5 Simone Piccardi
_Icinga_ (http://www.icinga.org) è un fork di Nagios sviluppato in maniera aperta, che presenta numerosi miglioramenti e soprattutto una interfaccia utente nettamente più elaborata. Le presenti istruzioni fanno riferimento all'installazione su una Debian Squeeze utilizzando le versione più recenti disponibili nel repository di @backports@ pertanto il primo passo da fare sarà quello di abilitare questi ultimi, aggiungendo a @/etc/apt/sources.list@ la riga:
6 5 Simone Piccardi
7 1 Simone Piccardi
<pre>
8 1 Simone Piccardi
deb http://backports.debian.org/debian-backports squeeze-backports main
9 1 Simone Piccardi
</pre>
10 1 Simone Piccardi
11 1 Simone Piccardi
il pacchetto è suddiviso in due parti, il _"core"_ che reimplementa le funzionalità di Nagios, e la nuova interfaccia web, pertanto installeremo entrambe con:
12 1 Simone Piccardi
13 1 Simone Piccardi
<pre>
14 1 Simone Piccardi
apt-get install -t squeeze-backports icinga icinga-web
15 1 Simone Piccardi
</pre>
16 1 Simone Piccardi
17 5 Simone Piccardi
Il sistema di @debconf@ chiederà se abilitare o meno l'uso di comandi esterni con _Icinga_, questo consente, attraverso l'accesso in scrittura della _pipe_ di controllo posta in @/var/lib/icinga/rw/@ di dare al web server la possibilità di utilizzare l'interfaccia dei comandi CGI, e servirà anche per l'accesso alla stessa da parte di altri programmi di ausilio, pertanto è opportuno attivarla rispetto alla scelta di default. 
18 1 Simone Piccardi
19 10 Simone Piccardi
Oltre a questo è però necessario che ci siano i permessi di accesso corretti per @/var/lib/icinga/rw/@, il cui default non consente l'accesso, per questo si raccomanda di modificarne i permessi di accesso in maniera permanente con:
20 10 Simone Piccardi
21 10 Simone Piccardi
<pre>
22 10 Simone Piccardi
dpkg-statoverride --update --add nagios www-data 2710 /var/lib/icinga/rw
23 10 Simone Piccardi
dpkg-statoverride --update --add nagios nagios 751 /var/lib/icinga
24 10 Simone Piccardi
</pre>
25 10 Simone Piccardi
26 10 Simone Piccardi
da eseguire a processo fermo.
27 10 Simone Piccardi
28 5 Simone Piccardi
L'interfaccia di @debconf@ chiede anche (qualora si usino diverse alternative) per quale web server generare la configurazione (si lasci il default di apache2), di configurare l'accesso e la creazione di vari database per i quali occorre, usando @dbconfig-common@, la password di root del database (si assume l'uso di MySQL su localhost) e le password per gli utenti di amministrazione, @icingaadmin@ per _Icinga_ e @root@ per l'interfaccia Web.  Viene altresì richiesta la configurazione del database di appoggio per lo storico dei dati (@icinga-idoutils@), per il quale di nuovo occorre la password di root del database.
29 2 Simone Piccardi
30 2 Simone Piccardi
Qualora la configurazione di @icinga-web@ fallisca in fase di configurazione come capitato a me, occorrerà impostare a mano la password dell'utente root nel relativo database, per questo si dovranno eseguire i seguenti comandi (estratti dallo script di post-installazione):
31 2 Simone Piccardi
32 2 Simone Piccardi
<pre>
33 2 Simone Piccardi
salt=$(php5 -r 'echo hash("sha256", uniqid("root_", mt_rand()));')
34 2 Simone Piccardi
export SALT="$salt"
35 2 Simone Piccardi
export PW="passwordlungaecomplicata"
36 2 Simone Piccardi
pwhash=$(php5 -r 'echo hash_hmac("sha256", getenv("PW"), getenv("SALT"));')
37 2 Simone Piccardi
salt_e=${salt/\'/\\\'}
38 2 Simone Piccardi
pwhash_e=${pwhash/\'/\\\'}
39 2 Simone Piccardi
query="UPDATE nsm_user SET user_password='""$pwhash_e""', user_salt = '""$salt_e""', user_modified = NOW() WHERE user_name = 'root';"
40 2 Simone Piccardi
echo $query | mysql -u icinga_web -p icinga_web
41 2 Simone Piccardi
</pre>
42 2 Simone Piccardi
43 2 Simone Piccardi
fornendo dopo l'ultimo comando la password impostata per il database di @icinga-web@.
44 4 Simone Piccardi
45 3 Simone Piccardi
Una delle caratteristiche di @icinga@ è la possibilità di utilizzare un database per lo stoccaggio dei dati, le estensioni per l'utilizzo di questa modalità di gestione dei dati sono fornite dal pacchetto @icinga-idoutils@ (necessario nel caso si voglia utilizzare la nuova interfaccia di @icinga-web@, che lo richiede come dipendenza e fa configurare il relativo accesso al database). Per poterlo utilizzare deve essere esplicitamente abilitato l'avvio del demone @ido2db@ modificando la seguente riga in @/etc/default/icinga@:
46 3 Simone Piccardi
47 3 Simone Piccardi
<pre>
48 1 Simone Piccardi
# start ido2db daemon (no/yes)
49 3 Simone Piccardi
IDO2DB=yes
50 3 Simone Piccardi
</pre>
51 3 Simone Piccardi
52 5 Simone Piccardi
inoltre deve essere attivato il modulo di gestione da parte di _Icinga_, questo deve essere fatto attraverso l'uso del file di configurazione distribuito con @icinga-idoutils@, pertanto occorrerà copiare:
53 1 Simone Piccardi
54 1 Simone Piccardi
<pre>
55 4 Simone Piccardi
cp /usr/share/doc/icinga-idoutils/examples/idoutils.cfg-sample /etc/icinga/modules/idoutils.cfg
56 4 Simone Piccardi
</pre>
57 4 Simone Piccardi
58 4 Simone Piccardi
una volta fatto questo si riavviino i relativi servizi con:
59 4 Simone Piccardi
60 1 Simone Piccardi
<pre>
61 1 Simone Piccardi
service ido2db restart
62 1 Simone Piccardi
service icinga restart
63 1 Simone Piccardi
</pre>
64 5 Simone Piccardi
65 5 Simone Piccardi
e si potrà verificare il funzionamento anche della nuova interfaccia web (dando per scontato di aver creato un opportuno virtual host sotto SSL),  andando sull'indirizzo @https://icinga.miosito.it/icinga-web/@. 
66 5 Simone Piccardi
67 5 Simone Piccardi
Qualora i dati di monitoraggio siano presenti, ma risulti marcata come "_DOWN_" l'instanza di @icinga@ nel quadro riassuntivo, si verifichi che la _timezone_ di sistema in @/etc/timezone@, quella di PHP nella variabile @date.timezone@ in @/etc/php5/apache2/php.ini@ siano coerenti, nel caso si provveda anche al riavvio di MySQL per fargli vedere i valori corretti.
68 5 Simone Piccardi
69 5 Simone Piccardi
70 5 Simone Piccardi
h2. Grafici delle risorse con _PNP4Nagios_
71 5 Simone Piccardi
72 5 Simone Piccardi
Uno degli aspetti più rilevanti di un sistema di monitoraggio è quello che consente di mantenere uno storico del consumo delle risorse che consente di tenerne sotto controllo l'evoluzione. A questo scopo è disponibile _PHP4Nagios_, che supporta anche una opportuna integrazione con @icinga@; per installarlo è sufficiente eseguire il comando:
73 5 Simone Piccardi
74 5 Simone Piccardi
<pre>
75 5 Simone Piccardi
apt-get install -t squeeze-backports icinga-web-pnp
76 5 Simone Piccardi
</pre>
77 5 Simone Piccardi
78 5 Simone Piccardi
che installa tutto il necessario nelle dipendenze, una volta fatto questo però vanno fatte alcune correzioni alle configurazioni del pacchetto che sono fatte per Nagios, in particolare occorre modificare @/etc/apache2/conf.d/pnp4nagios.conf@ correggendo le modalità di autenticazione con:
79 5 Simone Piccardi
80 5 Simone Piccardi
<pre>
81 5 Simone Piccardi
AuthName "Iconga Access"
82 5 Simone Piccardi
AuthUserFile /etc/icinga/htpasswd.users
83 5 Simone Piccardi
</pre>
84 5 Simone Piccardi
85 5 Simone Piccardi
in modo che corrispondano a quanto presente anche in @/etc/apache2/conf.d/icinga.conf@, e ci si ricordi di eseguire un reload di apache. 
86 5 Simone Piccardi
87 5 Simone Piccardi
Occorre poi correggere @/etc/pnp4nagios/config.php@ di nuovo per fagli usare i valori opportuni relativi ad _Icinga_, in particolare si dovranno modificare le seguenti linee:
88 5 Simone Piccardi
89 5 Simone Piccardi
<pre>
90 5 Simone Piccardi
...
91 5 Simone Piccardi
$conf['nagios_base'] = "/icinga/cgi-bin";
92 5 Simone Piccardi
...
93 5 Simone Piccardi
$conf['livestatus_socket'] = "unix:/var/lib/icinga/rw/live";
94 5 Simone Piccardi
...
95 9 Simone Piccardi
$conf['template_dirs'][] = '/usr/share/check_mk/pnp-templates';
96 9 Simone Piccardi
...
97 5 Simone Piccardi
</pre>
98 1 Simone Piccardi
99 9 Simone Piccardi
Dove le ultime righe attengono all'uso di funzionalità fornite con _Check_MK_, su cui torneremo più avanti.
100 1 Simone Piccardi
101 7 Simone Piccardi
Per la generazione dei grafici occorre che _Icinga_ generi i relativi dati, _PHP4Nagios_ prevede diverse modalità per l'accesso agli stessi, la più efficiente è quella dell'uso di un apposito demone, @npcd@ che si appoggia ad un modulo di _Icinga_. In realtà il demone può essere anche usato da solo, facendo generare i dati ad _Icinga_ nelle opportune directory. 
102 7 Simone Piccardi
103 7 Simone Piccardi
Anzitutto occorre attivare il demone @npcd@ in @/etc/default/npcd@ inserendo la riga:
104 7 Simone Piccardi
105 1 Simone Piccardi
<pre>
106 7 Simone Piccardi
# Should NPCD be started? ("yes" to enable)
107 7 Simone Piccardi
RUN="yes"
108 7 Simone Piccardi
</pre>
109 7 Simone Piccardi
110 7 Simone Piccardi
Il secondo passo è configurare _Icinga_, cosa che varia a seconda delle modalità scelte per generare i dati. Se si sceglie di usare quella consigliata attraverso il modulo @npcdmod.o@ occorrono due passaggi; il primo è quello di indicare ad _Icinga_ di generare i dati, inserendo in @/etc/icinga/icinga.cfg@ la riga:
111 7 Simone Piccardi
112 7 Simone Piccardi
<pre>
113 7 Simone Piccardi
process_performance_data=1
114 7 Simone Piccardi
</pre>
115 7 Simone Piccardi
116 7 Simone Piccardi
occorrerà poi abilitare il modulo inserendo in un file di configurazione (nel nostro caso @npcdmod.cfg@) nella directory @/etc/icinga/modules/@ con contenuto:
117 7 Simone Piccardi
118 7 Simone Piccardi
<pre>
119 7 Simone Piccardi
define module{
120 7 Simone Piccardi
        module_name    npcdmod
121 7 Simone Piccardi
        path           /usr/lib/pnp4nagios/npcdmod.o 
122 7 Simone Piccardi
        module_type    neb
123 7 Simone Piccardi
        args           config_file=/etc/pnp4nagios/npcd.cfg
124 7 Simone Piccardi
        }
125 7 Simone Piccardi
</pre>
126 7 Simone Piccardi
127 7 Simone Piccardi
128 8 Simone Piccardi
h2. Controllo con _Check_MK_
129 1 Simone Piccardi
130 1 Simone Piccardi
_Check_MK_ è programma che consente di gestire il monitoraggio centralizzato di diversi parametri da parte di _Icinga_ con una singola connessione ad un opportuno _agent_ da installare sulle singole macchine da porre sotto controllo. Il programma inoltre fornisce anche una serie di funzionalità di controllo ed autodiscovery dei servizi ed una interfaccia di controllo alternativa.  Per l'integrazione con _Icinga_ il primo passo è installare tutto il necessario sul server:
131 1 Simone Piccardi
132 8 Simone Piccardi
<pre>
133 9 Simone Piccardi
apt-get install -t squeeze-backports check-mk-server check-mk-config-icinga 
134 1 Simone Piccardi
</pre>
135 9 Simone Piccardi
136 9 Simone Piccardi
dove in particolare il secondo pacchetto installa tutti i file necessari ad integrare _Check_MK_ con _Icinga_.
137 9 Simone Piccardi
138 9 Simone Piccardi
La configurazione di base prevede che si inserisca la lista delle macchine da sottoporre a controllo nel file @/etc/check_mk/main.mk@, inizialmente ad esempio con qualcosa del tipo (la configurazione è l'assegnazione di una lista in python):
139 9 Simone Piccardi
140 9 Simone Piccardi
<pre>
141 9 Simone Piccardi
# Put your host names here
142 9 Simone Piccardi
# all_hosts = [ 'localhost' ]
143 9 Simone Piccardi
all_hosts = [  'localhost', 'www.fountainpen.it', ... ]
144 9 Simone Piccardi
</pre>
145 9 Simone Piccardi
146 9 Simone Piccardi
Si tenga presente che la semplice installazione _Check_MK_ di default non comporta nessun controllo, il programma infatti si collega agli _agent_ sulle macchine indicate nel precedente file di configurazione, e raccoglie gli eventuali dati disponibili, ma questi sono normalmente utilizzati soltanto all'interno del programma stesso, se si vogliono poter inserire i controlli dentro _Icinga_ occorre richiedere al programma la generazione degli opportuni file di configurazione. 
147 9 Simone Piccardi
148 9 Simone Piccardi
Le operazioni di controllo di _Check_MK_ vengono eseguite tramite il comando @check_mk@, questo consente di gestire le configurazioni di tutte le macchine controllate con _Check_MK_ creando un opportuno file di configurazione per _Icinga_ sotto @/etc/icinga/objects/check_mk/check_mk_objects.cfg@. Si può visualizzare l'elenco dei possibili controlli con  @check_mk -L@, mentre con @check_mk -I@, eventualmente seguito dall'indicazione di una macchina si può attivare la scoperta dei servizi disponibili per il controllo (il comando mostra solo quelli nuovi, se invece si usa @check_mk -II@ vengono cancellati quelli vecchi e ricreati solo quelli presenti).
149 9 Simone Piccardi
150 9 Simone Piccardi
In generale quello che server è lanciare @check_mk -R@ che esegue la generazione dei file di configurazione (nel caso @/etc/icinga/objects/check_mk/check_mk_objects.cfg@) e poi riavviare il servizio:
151 9 Simone Piccardi
152 9 Simone Piccardi
<pre>
153 9 Simone Piccardi
check_mk -R
154 9 Simone Piccardi
service icinga restart
155 9 Simone Piccardi
</pre>
156 9 Simone Piccardi
157 9 Simone Piccardi
158 10 Simone Piccardi
Si tenga presente però che in dato che _Check_MK_ utilizza il plugin @check_icmp@ di _Nagios_ per controllare lo stato di tutti gli host configurati, se non si fa altro questi risulteranno disattivi (anche se controlli disponibili grazie all'_agent_ risulteranno a posto) in quanto detto plugin deve essere eseguito da @root@. Esso allora deve essere reso _suid_ in modo da poter funzionare correttamente anche quando invocato da _Icinga_, di nuovo questo si può fare con il comando:
159 10 Simone Piccardi
160 10 Simone Piccardi
<pre>
161 10 Simone Piccardi
dpkg-statoverride --update --add root root 4755 /usr/lib/nagios/plugins/check_icmp
162 10 Simone Piccardi
</pre>
163 10 Simone Piccardi
164 10 Simone Piccardi
che rende la modifica permanente anche nell'aggiornamento dei pacchetti.
165 10 Simone Piccardi
166 9 Simone Piccardi
Per poter utilizzare le fuzionalità di _Check_MK_ è però necessario installare sulle macchine da mettere sotto controllo (compresa in genere quella su cui si è installato il server), lo script che esegue il compito di _agent_. Si tratta di un semplice script di shell che deve essere eseguito con @xinetd@, quest'ultimo però non viene installato automaticamente e deve essere esplicitamente installato:
167 9 Simone Piccardi
168 9 Simone Piccardi
<pre>
169 9 Simone Piccardi
apt-get install -t squeeze-backports check-mk-agent xinetd
170 9 Simone Piccardi
</pre>
171 9 Simone Piccardi
172 9 Simone Piccardi
inoltre dato che l'agent installa un file di configurazione per @xinetd@ in cui il servizio è disabilitato, è necessario modificare @/etc/xinetd.d/check_mk@ impostando: 
173 9 Simone Piccardi
174 9 Simone Piccardi
<pre>
175 9 Simone Piccardi
disable        = no
176 9 Simone Piccardi
</pre>
177 1 Simone Piccardi
178 10 Simone Piccardi
ed eventualmente aggiungere ulteriori direttive di controllo per bloccare gli accessi solo ai server autorizzati; ad esempio nel caso di installazione locale sul server stesso si potrà indicare:
179 9 Simone Piccardi
180 9 Simone Piccardi
<pre>
181 9 Simone Piccardi
only_from      = 127.0.0.1
182 9 Simone Piccardi
</pre>
183 1 Simone Piccardi
184 10 Simone Piccardi
oppure mettere il programma in ascolto solo su @localhost@ con:
185 10 Simone Piccardi
186 10 Simone Piccardi
<pre>
187 10 Simone Piccardi
bind           = 127.0.0.1
188 10 Simone Piccardi
</pre>
189 10 Simone Piccardi
190 9 Simone Piccardi
e si provveda a riavviare il servizio con:
191 9 Simone Piccardi
192 9 Simone Piccardi
<pre>
193 1 Simone Piccardi
service xinetd restart
194 9 Simone Piccardi
</pre>
195 9 Simone Piccardi
196 10 Simone Piccardi
Si tenga presente che se si installa l'agent sulla macchina stessa su cui gira _Icinga_, la configurazione di default di quest'ultimo già prevede un controllo eseguito su @localhost@ definito nel file @/etc/icinga/objects/localhost_icinga.cfg@, che andrà a confliggere con la configurazione creata da @check_mk -R@, pertanto si abbia cura di rimuovere detto file o di usare con _Check_MK_ un nome diverso per indicare il localhost (ad esempio "127.0.0.1"). 
197 1 Simone Piccardi
198 8 Simone Piccardi
L'uso dell'interfaccia web di _Check_MK_ si basa sull'utilizzo di ''livestatus'', una modalità di presentazione dei dati che consente una lettura più veloce ed efficente, cui abbiamo già accennato in precedenta. Questa comporta l'installazione del pacchetto relativo con:
199 8 Simone Piccardi
200 7 Simone Piccardi
<pre>
201 5 Simone Piccardi
apt-get install -t squeeze-backports check-mk-livestatus
202 5 Simone Piccardi
</pre>
203 5 Simone Piccardi
204 5 Simone Piccardi
ed una ulteriore configurazione di _Icinga_; questa può essere fatta usando la nuova funzionalità dei moduli (evitando quindi la direttiva @broker_module@) inserendo in un file (nel nostro caso @livestatus.cfg@) nella directory @/etc/icinga/modules/@ con contenuto:
205 5 Simone Piccardi
206 1 Simone Piccardi
<pre>
207 5 Simone Piccardi
define module{
208 5 Simone Piccardi
        module_name    mklivestatus
209 5 Simone Piccardi
        path           /usr/lib/check_mk/livestatus.o
210 5 Simone Piccardi
        module_type    neb
211 1 Simone Piccardi
        args           /var/lib/icinga/rw/live
212 5 Simone Piccardi
        }
213 5 Simone Piccardi
</pre>
214 8 Simone Piccardi
dove @/var/lib/icinga/rw/live@ che è il default usato da _Check_MK_.