MiJack – Cuadernos técnicos

1 – Nagios – Introducción.
2 – Instalación y configuración de Nagios en Debian 6.
3 – Interfaz web
4 – Nagios. Ficheros de Configuracion inicial: nagios.cfg
5 – Nagios. Ficheros commands.cfg, Macros en resources.cfg y sobre nagios-plugin
6 – Contacts, templates y timeperiods
7 – Alta de nueva máquina
8 – Alta de nuevos servicios
9 – servicegroups y hostgroups

10 – Creacion de un tipo de chequeo personalizado
11 – Creación de un tipo de notificacion personalizada

Nagios Graph
Nagios mysql

Anexo:

Nagios. Comandos útiles.

Como dijimos anteriormente, el fichero commands.cfg define todos los comandos que mas tarde serán utilizados por Nagios, tanto para chequear los servicios como para envíar alertas. Si necesitaramos crear un script personalizado, tendríamos que definirlo aquí.

Notificaciones:

Tomemos como ejemplo la definición del command ‘notify-host-by-email’:

Dicho comando, se encarga de notficar el cambio de estado de un host.

define command{
        command_name    notify-host-by-email
        command_line    /usr/bin/printf "%b" "***** Nagios *****\n\nNotification Type: $NOTIFICATIONTYPE$\nHost: $HOS
TNAME$\nState: $HOSTSTATE$\nAddress: $HOSTADDRESS$\nInfo: $HOSTOUTPUT$\n\nDate/Time: $LONGDATETIME$\n" | /usr/bin/mai
l -s "** $NOTIFICATIONTYPE$ Host Alert: $HOSTNAME$ is $HOSTSTATE$ **" $CONTACTEMAIL$
        }

Como vemos, solamente se define un nombre de comando y una linea de comando.

Cuando el estado de un host cambie, tal como estará definido en las plantillas, que posteriormente veamos, Nagios llamará a este comando, que mediante unas variables denominadas macros, definidas en el nucleo de Nagios, recogerá datos como el nombre de la máquina, ip de la misma, estado, email del contacto asociado a esa máquina, etc.

Las variables que se pueden utilizar en este apartado están perfectamente documentadas en este enlace

Si se diera el caso que necesitamos crear una alerta personalizada (para envío de alertas via SMS, twitter o lo que se nos ocurra), podemos definir una nueva. Este sería un ejemplo:

define command{
        command_name    notify-host-by-email
        command_line    /scripts/notify-by-twitter.pl $HOSTNAME$ $NOTIFICATIONTYPE$ $HOSTSTATE$ $HOSTADDRESS $HOSTOUTPUT$ $LONGDATETIME$ $CONTACTEMAIL$
       }

En este caso, tendríamos un script en /scripts/notify-by-twitter.pl, al que, pasandole por parametro los datos(nombre de la maquina, tipo de notificacion, estado, direccion ip, salida del chequeo que ha provocado el cambio de estado, fecha actual y email de contacto), haría ‘lo-que-sea’ en twitter, notificando la caída.

Chequeos:

Con los chequeos el funcionamiento es similar.

Cada host o servicio definido, estará ligado a una plantilla, donde se define el tipo de chequeo.

Para realizar los chequeos, disponemos de una colección de plugins, llamada nagios-plugins, ya instalados si hemos seguido este manual. Son, en su mayoría, binarios compilados de un código fuente escrita en C.

En dicha colección de chequeos está check_ping. Podemos ejecutar dicho binario en linea de comando para comprobar su comportamiento.

ej:

vmNagios:/etc/nagios/objects# /usr/local/nagios/libexec/check_ping -H google.es -w 80,80% -c 90,90%
PING OK - Packet loss = 0%, RTA = 10.73 ms|rta=10.725000ms;80.000000;90.000000;0.000000 pl=0%;80;90;0

El comando recibe vía macros tantos valores como necesite para llevar a cabo el chequeo, en este caso, solamente la variable $HOSTADDRESS$, que contiene la ip a chequear:

# 'check-host-alive' command definition
define command{
        command_name    check-host-alive
        command_line    $USER1$/check_ping -H $HOSTADDRESS$ -w 3000.0,80% -c 5000.0,100% -p 5
        }

al igual que con las notificaciones, podríamos crear comandos de chequeo personalizados:

supongamos que queremos chequear la disponibilidad de un servidor IRC remoto. Preparaíamos un script llamado check_irc.pl al que, pasando por parámetro la ip del servidor (-h ), chequearía si dicho servicio (puerto 6667) está disponible.

Así lo definiríamos en el fichero de configuración:

# 'check-irc command definition
define command{
        command_name    check-irc
        command_line    $USER1$/check_irc.pl -H $HOSTADDRESS$ 
        }

Macros en resources.cfg:

Vereis una variable llamada $USER1$. Paso a explicar qué es.

Como hemos comentado, existen una serie de variables denominadas Macros. Esas variables se incluyen en el nucleo de Nagios (documentadas aquí).

Además de las ya existentes, podemos definir nuevas macros, para ello, tendremos que editar el fichero
/etc/nagios/resource.cfg.

Existe ya una macro definida en dicho fichero, que define el directorio donde estarán instalados los scripts o binario sde nagios-plugins:

$USER1$=/usr/local/nagios/libexec

De esta forma, tendría sentido crear una Macro más, que indique donde se encuentran los scripts creados por nosotros para chequeos y notificaciones:

$USERSCRIPTS$=/scripts

Ahora, si quisieramos referirnos al script notify-by-twitter, localizado en esa ubicación, podríamos hacerlo así: $USERSCRIPTS$/notify-by-twitter.pl

Otro ejemplo claro, sería definir aquí el teléfono al que se envíaran las notificaciones via SMS.

$TELEFONO_ALERTAS_SMS$=618888888

Recuerdo que Nagios dispone de una muy buena (pero en ocasiones demasiado extensa como para sentarse un ratito a leerla) documentación. Todos los parametros que aquí incluyo están disponibles en dicha documentación.

Para evitar que el fichero de configuracion principal sea algo interminable, eliminamos comentarios y lineas en blanco y dejamos el fichero asi:

# Ficheros de configuracion
cfg_file=/usr/local/nagios/etc/objects/commands.cfg
cfg_file=/usr/local/nagios/etc/objects/contacts.cfg
cfg_file=/usr/local/nagios/etc/objects/timeperiods.cfg
cfg_file=/usr/local/nagios/etc/objects/templates.cfg

# Directorio de hosts
cfg_dir=/usr/local/nagios/etc/objects/hosts

# Parametros auxiliares de configuracion
log_file=/usr/local/nagios/var/nagios.log
object_cache_file=/usr/local/nagios/var/objects.cache
precached_object_file=/usr/local/nagios/var/objects.precache
resource_file=/usr/local/nagios/etc/resource.cfg
status_file=/usr/local/nagios/var/status.dat
status_update_interval=10
nagios_user=nagios
nagios_group=nagios
check_external_commands=1
command_check_interval=-1
command_file=/usr/local/nagios/var/rw/nagios.cmd
external_command_buffer_slots=4096
lock_file=/usr/local/nagios/var/nagios.lock
temp_file=/usr/local/nagios/var/nagios.tmp
temp_path=/tmp
event_broker_options=-1
log_rotation_method=d
log_archive_path=/usr/local/nagios/var/archives
use_syslog=1
log_notifications=1
log_service_retries=1
log_host_retries=1
log_event_handlers=1
log_initial_states=0
log_external_commands=1
log_passive_checks=1
service_inter_check_delay_method=s
max_service_check_spread=30
service_interleave_factor=s
host_inter_check_delay_method=s
max_host_check_spread=30
max_concurrent_checks=0
check_result_reaper_frequency=10
max_check_result_reaper_time=30
check_result_path=/usr/local/nagios/var/spool/checkresults
max_check_result_file_age=3600
cached_host_check_horizon=15
cached_service_check_horizon=15
enable_predictive_host_dependency_checks=1
enable_predictive_service_dependency_checks=1
soft_state_dependencies=0
auto_reschedule_checks=0
auto_rescheduling_interval=30
auto_rescheduling_window=180
sleep_time=0.25
service_check_timeout=60
host_check_timeout=30
event_handler_timeout=30
notification_timeout=30
ocsp_timeout=5
perfdata_timeout=5
retain_state_information=1
state_retention_file=/usr/local/nagios/var/retention.dat
retention_update_interval=60
use_retained_program_state=1
use_retained_scheduling_info=1
retained_host_attribute_mask=0
retained_service_attribute_mask=0
retained_process_host_attribute_mask=0
retained_process_service_attribute_mask=0
retained_contact_host_attribute_mask=0
retained_contact_service_attribute_mask=0
interval_length=60
check_for_updates=1
bare_update_check=0
use_aggressive_host_checking=0
execute_service_checks=1
accept_passive_service_checks=1
execute_host_checks=1
accept_passive_host_checks=1
enable_notifications=1
enable_event_handlers=1
process_performance_data=0
obsess_over_services=0
obsess_over_hosts=0
translate_passive_host_checks=0
passive_host_checks_are_soft=0
check_for_orphaned_services=1
check_for_orphaned_hosts=1
check_service_freshness=1
service_freshness_check_interval=60
check_host_freshness=0
host_freshness_check_interval=60
additional_freshness_latency=15
enable_flap_detection=1
low_service_flap_threshold=5.0
high_service_flap_threshold=20.0
low_host_flap_threshold=5.0
high_host_flap_threshold=20.0
date_format=us
p1_file=/usr/local/nagios/bin/p1.pl
enable_embedded_perl=1
use_embedded_perl_implicitly=1
illegal_object_name_chars=`~!$%^&*|'"<>?,()=
illegal_macro_output_chars=`~$&|'"<>
use_regexp_matching=0
use_true_regexp_matching=0
admin_email=nagios@localhost
admin_pager=pagenagios@localhost
daemon_dumps_core=0
use_large_installation_tweaks=0
enable_environment_macros=1
debug_level=0
debug_verbosity=1
debug_file=/usr/local/nagios/var/nagios.debug
max_debug_file_size=1000000

Nos centramos en las primeras lineas, donde se definen los parametros mas funcionales de Nagios. Paso a describirlos:

# Ficheros de configuracion
cfg_file=/usr/local/nagios/etc/objects/commands.cfg
cfg_file=/usr/local/nagios/etc/objects/contacts.cfg
cfg_file=/usr/local/nagios/etc/objects/timeperiods.cfg
cfg_file=/usr/local/nagios/etc/objects/templates.cfg

# Directorio de hosts
cfg_dir=/usr/local/nagios/etc/objects/hosts

Fichero objects/commands.cfg:

Define todos los comandos que mas tarde serán utilizados por Nagios, tanto para chequear los servicios como para envíar alertas. Si necesitaramos crear un script personalizado, tendríamos que definirlo aquí.

Fichero contacts.cfg:

Define los contactos y grupos de contactos de Nagios. Se podría definir un contacto como una persona. Alguien a quien hacer llegar una alerta. Los usuarios se agrupan como ‘contact groups’ para facilitar la gestión de la configuración.

Fichero timeperiods.cfg:

Define los periodos de tiempo de Nagios. Dichos periodos son aplicables tanto a los chequeos como a las alertas, permitiendo establecer diferentes periodos para diferentes casos. El ejemplo más claro sería, en caso de las alertas, la definición de una alerta que sólo se envíara en un horario concreto, por ejemplo, fuera de horario de oficina. En caso de los chequeos, se podrian definir diferentes timeperiods, por ejemplo, un chequeo que se realizara sólo en horario de oficina, para, fuera de ese horario, hacer un chequeo diferente, más o menos exhaustivo.

Fichero templates.cfg:

Define las plantillas de Nagios. Una plantilla es una forma de simplificiar la configuración de los diferentes elementos. En caso de elementos repetitivos, como por ejemplo, máquinas con un mismo perfil de chequeo, en lugar de establecer todos los parámetros (tipo de chequeo, hora de chequeo, a quién avisar en caso de caída, etc) cada vez que definimos un chequeo, se crearía una plantilla con dicho perfil, de forma que se indicaría que el nuevo chequeo, utilizaría esa plantilla en la que definimos los parámetros.

# Chequear la configuración de nagios:
# Esto nos será util tras un cambio de configuración.

/usr/local/nagios/bin/nagios -v /etc/nagios/nagios.cfg

#Si el resultado de las últimas lineas, es el mostrado debajo, podemos reiniciar sin miedo a que no arranque por fallo de la configuración:

Total Warnings: 0
Total Errors: 0

Parte I: Instalación del servidor Nagios.

Escenario: Partimos de un sistema Debian 6 con apache instalado.

# Creamos el usuario nagios, bajo el que correrá el demonio

adduser nagios

# instalamos las Dependencias:

apt-get install build-essential

Instalación y configuración de Nagios Sobre Debian 6

Partimos de un sistema Debian con httpd instalado.

# Dependencias:

apt-get install build-essential

# Nos bajamos la última versión de Nagios y de los plugins de http://www.nagios.org/download/

wget http://prdownloads.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.15.tar.gz
wget http://prdownloads.sourceforge.net/sourceforge/nagios/nagios-3.3.1.tar.gz

3 Compilamos ‘As Usual’. primero los plugins y luego nagios.

tar xvzf nagios-plugins-1.4.15.tar.gz
cd nagios-plugins-1.4.15
./configure && make && make install
tar xvzf nagios-3.3.1.tar.gz
cd nagios
./configure && make all
make modules install-base   install-cgis install-config install-init

#copiamos un sample de configuracion (se copiara a /usr/local/nagios/etc/)

make install-config

# comprobamos los errores que pueda haber en la configuracion (ficheros de log a crear, directorios que faltan, etc)

/usr/local/nagios/bin/nagios /usr/local/nagios/etc/ -v

# en mi caso, vemos: Error: Cannot open main configuration file ‘/usr/local/nagios/etc/’ for reading!
# cambiamos los permisos:

chown nagios:nagios /usr/local/nagios/etc/

# ahora nos dice: Warning: Cannot open log file ‘/usr/local/nagios/var/nagios.log’ for writing
#creamos el fichero:

mkdir /usr/local/nagios/var -p; touch /usr/local/nagios/var/nagios.log ; chown nagios /usr/local/nagios/var/nagios.log

# por ultimo, instalamos el init script, la configuracion de apache y la configuracion inicial de nagios:

make install-init && make install-config && make install-webconf

# Creamos el fichero htpasswd de apache para el acceso web

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin

Resumen de lo instalado:

General Options:
-------------------------
       Nagios executable:  nagios
       Nagios user/group:  nagios,nagios
      Command user/group:  nagios,nagios
           Embedded Perl:  no
            Event Broker:  yes
       Install ${prefix}:  /usr/local/nagios
               Lock file:  ${prefix}/var/nagios.lock
  Check result directory:  ${prefix}/var/spool/checkresults
          Init directory:  /etc/init.d
 Apache conf.d directory:  /etc/apache2/conf.d
            Mail program:  /usr/bin/mail
                 Host OS:  linux-gnu

Web Interface Options:
------------------------
                HTML URL:  http://localhost/nagios/
                 CGI URL:  http://localhost/nagios/cgi-bin/
Traceroute (used by WAP):  /usr/sbin/traceroute

# iniciamos nagios y reiniciamos httpd.

/etc/init.d/nagios start
/etc/init.d/httpd restart

# Hecho esto, ya podemos acceder via web: http://localhost/nagios

Por comodida, creamos un enlace simbólico de n -s /usr/local/nagios/etc/ a /etc/nagios
cd /etc
ln -s /usr/local/nagios/etc/ nagios

# procedo a realizar el siguiente cambio en la configuración:

cd /etc/nagios/objects
mkdir hosts
mv localhost.cfg hosts

nano /etc/nagios/nagios.cfg

#Cambiamos:

cfg_file=/usr/local/nagios/etc/objects/localhost.cfg

#por

cfg_dir=/usr/local/nagios/etc/objects/hosts

# De esta forma, en lugar de incluir cada nuevo host en el directorio de configuracion de nagios, y referirlo en nagios.cfg, simplemente creamos el fichero en el directorio hosts y al reiniciar lo añade a la config por defecto.

Comandos útiles:

# Chequear la configuración de nagios

/usr/local/nagios/bin/nagios -v /etc/nagios/nagios.cfg

#Si el resultado es este, podemos reiniciar sin miedo a que no arranque por fallo de la configuración.
Total Warnings: 0
Total Errors: 0