Nagios en Español

Definiciones de objetos

2011-07-04T16:41:00.000-07:00

Introducción

Una de las características de formato de Nagios "objeto de configuración es que puede crear definiciones de objetos que heredan las propiedades de las definiciones de otro objeto. Una explicación de cómo funciona el objeto de sucesiones se puede encontrar aquí Sugiero fuertemente que se familiarice con sucesiones objeto una vez que lea la documentación presentada a continuación, ya que hará que el trabajo de creación y mantenimiento de definiciones de objetos mucho más fácil de lo que debería ser. Además, leer sobre los trucos de objetos que ofrecen accesos directos para tareas de configuración de otro modo tedioso.

Al crear y / o editar archivos de configuración, tenga en cuenta lo siguiente:

Las lineas que empiezan por el símbolo '#' son tomadas como comentarios y no son procesadas.

Las directivas son sensibles a las mayúsculas y minúsculas

Los caracteres que aparecen después de un punto y coma (;) en los archivos de configuración, son tratados como comentarios y no son procesados.

Notas de retención

Es importante señalar que varias directivas en los equipos, servicio, y las definiciones de contacto puede no ser recogido por Nagios cuando los cambia los archivos de configuración.

Las directivas de objeto que pueden presentar este comportamiento están marcadas con el símbolo (*). La razón de este comportamiento se debe al hecho de que Nagios elige para honrar a los valores almacenados en el archivo de estado de retención o state retention file sobre los archivos encontrados el archivos de configuración, asumiendo que tiene el estado de retención o state retention habilitado en la configuración (program-wide basis) y el valor de la directiva sea cambiada durante la ejecución mediante comando externo o external command.

Una forma de solucionar este problema es des-habilitar la retención de información no-estado usando la directiva de no_retención_de_la_información_de_estado (retain_nonstatus_information) en el equipo, servicios, o las definiciones de contacto. Des habilitando de la directiva hará que Nagios tome los valores iniciales de estas directivas de los archivos de configuración, lugar desde donde el cual el archivo de retención se reinicia.

Archivos de configuración

Nota: Los ejemplos de archivos de configuración están instalados en el directorio /usr/local/nagios/etc/ cuando usa la guía de instalación rápida.

Tipos de objetos

Definiciones de equipos
Definición de grupos de equipos
Definición de servicios
Definición de grupos de servicios
Definición de contactos
Definición de grupos de contactos
Definición de periodos de tiempo
Definición de comandos
Definición de dependencia de servicios
Definición de escalado de servicios
Definición de dependencia de objetos
Definición de escalado de objetos
Definición de información de objetos extendida
Definición de información de servicios extendida

Definición de equipos

Descripción:

Una definición de equipo se utiliza para definir un servidor físico, estación de trabajo, dispositivos, etc que se encuentra en la red.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define host{
	host_name	host_name
	alias	alias
	display_name	display_name
	address	address
	parents	host_names
	hostgroups	hostgroup_names
	check_command	command_name
	initial_state	[o,d,u]
	max_check_attempts	#
	check_interval	#
	retry_interval	#
	active_checks_enabled	[0/1]
	passive_checks_enabled	[0/1]
	check_period	timeperiod_name
	obsess_over_host	[0/1]
	check_freshness	[0/1]
	freshness_threshold	#
	event_handler	command_name
	event_handler_enabled	[0/1]
	low_flap_threshold	#
	high_flap_threshold	#
	flap_detection_enabled	[0/1]
	flap_detection_options	[o,d,u]
	process_perf_data	[0/1]
	retain_status_information	[0/1]
	retain_nonstatus_information	[0/1]
	contacts	contacts
	contact_groups	contact_groups
	notification_interval	#
	first_notification_delay	#
	notification_period	timeperiod_name
	notification_options	[d,u,r,f,s]
	notifications_enabled	[0/1]
	stalking_options	[o,d,u]
	notes	note_string
	notes_url	url
	action_url	url
	icon_image	image_file
	icon_image_alt	alt_string
	vrml_image	image_file
	statusmap_image	image_file
	2d_coords	x_coord,y_coord
	3d_coords	x_coord,y_coord,z_coord
	}

Ejemplo de definición:

define host{

host_name bogus-router

alias Bogus Router #1

address 192.168.1.254

parents server-backbone

check_command check-host-alive

check_interval 5

retry_interval 1

max_check_attempts 5

check_period 24x7

process_perf_data 0

retain_nonstatus_information 0

contact_groups router-admins

notification_interval 30

notification_period 24x7

notification_options d,u,r

}

Descripción de las directivas:

host_name:

Esta directiva se utiliza para definir un nombre corto para identificar el host. Se utiliza en las definiciones de grupo de equipos y definiciones de servicio para hacer referencia a este servidor en particular. Los equipos pueden disponer de servicios múltiples (que son monitoreados) asociadas con ellos. Cuando se utiliza correctamente, la macro debe de contener este nombre corteo.

alias:

Esta directiva es usada para definir un nombre largo o una descripcion usada para definir el equipo. Esto es útil para poder identificar mas fácilmente un host en particular. Cuando use esta propiedad, la macro $HOSTALIAS$ conectara con este alias / descripcion.

address:

Esta directiva es usada para definir la dirección del equipo. Normalmente se trata de una dirección IP, aunque podría ser cualquier cosa que desee. (Siempre y cuando se puede utilizar para comprobar el estado del equipo ). Puede utilizar un nombre de dominio completo para identificar la máquina en lugar de una dirección IP, pero si los servicios DNS no están en esto podría causar problemas. Cuando se utiliza correctamente, la macro $HOSTADDRESS$ contactará con esta dirección.

Nota: Si no se especifica una directiva de direcciones en una definición de equipo, el nombre del host se utiliza como su dirección. Una palabra de advertencia acerca de hacer esto. Si el servicio de DNS falla, la mayoría de los controles de su servicio producirán un error porque los plugins no pueden resolver el nombre de equipo.

display_name:

Esta directiva se utiliza para definir un nombre alternativo que se debe mostrar en la interfaz web para este equipo. Si no se especifica, el valor predeterminado es el valor especificado para la directiva host_name. Nota: Las versiones actuales de CGI no utilizan esta opción, a pesar de las futuras versiones de la interfaz web si lo hacen.

parents:

Esta directiva se utiliza para definir una lista separada por comas de nombres cortos de los "padres" anfitriones para este equipo en particular. Los equipos padres suelen ser routers, switches, firewalls, etc que se encuentran entre el equipo de motorización y un host remoto.

El Router, Switch, etc, más cercano a la máquina remota se considera como el equipo "padre". Lea el "Estado de Determinación y la accesibilidad de los Ejércitos de red" el documento se encuentra aquí para más información. Si este sistema es en el mismo segmento de red que el equipo de motorización (sin routers intermedios, etc) el equipo se considerá de la misma red y no tendrá un host padre. Deja este valor en blanco si el anfitrión no tiene host padre (es decir, es en el mismo segmento que el equipo de motorización Nagios). El orden en que se especifican los equipos los padres no tiene efecto en cómo las cosas son motorizadas

hostgroups:

Esta directiva se utiliza para definir los nombres cortos o hosts name(s) de los grupos de equipos y de los equipos que pertenecen a él. Una lista de grupos deben de separarse con comas. Esta directiva puede ser usada como alternativa (o como adición) a la directiva de miembros (members directive) en las definiciones de grupos de equipos o hostgroup .

check_command:

Las directivas es usada para especificar nombres cortos o short name en el comando (command) o que puede ser chequeado para saber si el equipo esta activo o no.

Típicamente este comando intentaría un ping contra el equipo para saber si esta levantado "alive". El comando debe de devolver el estado de o Nagios asumirá que el equipo esta parado. Si usted deja el argumento en blando, el equipo no será chequeado activamente.

Por lo tanto, Nagios asumirá que el equipo esta levantado (que pueden aparecer como miembros de un "pendiente " en la interfaz web). Esto es útil si está supervisando impresoras u otros dispositivos que con frecuencia se apaga. La cantidad máxima de tiempo que el comando se puede ejecutar la notificación está controlado por la opción host_check_timeout .

initial_state:

De forma predeterminada Nagios asumirá que todos los hosts se encuentran en los estados arriba cuando se inicia. Se puede reemplazar el estado inicial de un host mediante la presente Directiva. Las opciones válidas son: o = UP, DOWN = d, y u = INALCANZABLE.

max_check_attempts:

Esta directiva se utiliza para definir el número de veces que Nagios volverá a intentar el comando de verificación de acogida si se devuelve cualquier estado que no sea un estado en Aceptar. Al establecer este valor en 1 hará que Nagios para generar una alerta, sin volver a intentar el control de acogida. Nota: Si no quieres comprobar el estado de la máquina, usted todavía debe establecer en un valor mínimo de 1. Para omitir la comprobación de acogida, acaba de salir de la opción check_command en blanco.

check_interval:

Esta directiva se utiliza para definir el número de "unidades de tiempo" entre los controles regulares del ejército. A menos que haya cambiado la directiva interval_length del valor predeterminado de 60, este número significa minutos. Más información sobre este valor se puede encontrar en la documentación en la programación de la verificación o check scheduling.

retry_interval:

Esta directiva se utiliza para definir el número de "unidades de tiempo" para esperar antes de programar una nueva visita de los equipos. Las máquinas son re programados en el intervalo de re intento cuando se han cambiado a un estado no-UP. Una vez que el equipo ha alcanzado el número máximo de intentos o max_check_attempts veces sin un cambio en su estado, volverá a ser programado en su "normal " según lo definido por el valor check_interval. A menos que haya cambiado la directiva interval_length interval_length del valor predeterminado de 60, este número significa minutos. Más información sobre este valor se puede encontrar en la programación de la verificación o check scheduling.

active_checks_enabled *:

Esta directiva se utiliza para determinar si los controles activos (ya sea regular o bajo demanda) de este servidor están habilitadas. Valores: 0 = desactivar los controles host activos, 1 = activar los controles activos de motorización (por defecto). .

passive_checks_enabled *:

Esta directiva se utiliza para determinar si los controles pasivos están habilitadas para este equipo. Valores: 0 = des-habilitar las comprobaciones de acogida pasiva, 1 = activar los controles pasivos de motorización (por defecto).

check_period:

Esta directiva se utiliza para especificar el nombre corto del periodo de tiempo o time period durante el cual los controles activos de esta máquina se pueden hacer.

obsess_over_host *:

Esta directiva determina si los chequeos se realizaran o no mientras el equipo esta en modo “obsesionado” (obsessed) usando el comando ochp_command.

check_freshness *:

Esta directiva determina si los chequeos se realizan o no si el refresco de chequeo o reshness checks está activado en este equipo. Valores: 0 = controles frescura desactivados, 1 = activar los controles frescura (por defecto).

freshness_threshold:

Esta directiva se utiliza para especificar el umbral de frescura (en segundos) para este equipo. Si se establece esta directiva por un valor de 0, Nagios determinará un umbral de frescura a usar automáticamente.

event_handler:

Esta directiva es usada para especificar el nombre corto de un command que puede correr cuando hay un cambio de estado en el equipo detectado (por ejemplo cuando un equipo esta in-disponible o se recupera.). Lea la documentación en el controlador de eventos o event handlers para mas detalles acerca como escribir procesos automáticos (scripts) para el controlador de eventos.

El tiempo máximo que un comando de monitorización de eventos puede ser ejecutado, viene definido en la opción tiempo de espera en control de eventos o event_handler_timeout

event_handler_enabled *:

Esta directiva se utiliza para determinar si el controlador de eventos para este equipo está activada. Valores: 0 = desactivar el controlador de eventos de acogida, 1 = activar controlador de anfitrión del evento.

low_flap_threshold:

Esta directiva se utiliza para especificar el umbral de cambio de estado de baja utilizada en la detección del “flapeo” (se cae y se levanta o viceversa) para este equipo. Más información sobre la detección de este flapeo se puede encontrar aquí. Si se establece esta directiva por un valor de 0, el valor de todo el programa especificado por la directiva se utilizará low_host_flap_threshold.

high_flap_threshold:

Esta directiva se utiliza para especificar el umbral de cambio de estado de alta utilizados en la detección de “flapeo” (se cae y se levanta o viceversa) para este equipo. Más información sobre la detección de este flapeo se puede encontrar aquí . Si se establece esta directiva por un valor de 0, el valor de todo el programa especificado por la directiva se utilizará high_host_flap_threshold.

flap_detection_enabled *:

Esta directiva se utiliza para determinar si la detección de un flapeo (se cae y se levanta o viceversa) está habilitada para esta máquina. Más información sobre la detección de este flapeo se puede encontrar aquí (here). Valores: 0 = deshabilita la detección de flapeo, 1 = habilitar la detección de flapeo.

flap_detection_options:

Esta directiva se utiliza para determinar si la detección de flapeo lógico está habilitada para esta máquina. Las opciones son la combinación de los siguientes valores. 0= Predicción de estado desactivado, 1 = estado parado la predicción de flapeo y u= estado inalcanzable.

process_perf_data *:

Esta directiva se utiliza para determinar si el tratamiento de los datos de rendimiento está habilitada para esta máquina. Valores: 0 = des-habilitar el rendimiento de procesamiento de datos, 1 = activar el rendimiento del procesamiento de datos.

retain_status_information:

Esta directiva se utiliza para determinar cuando si y cuando no la información relacionada con el estado sobre el host se mantiene en el programa cuando se reinicia. Esto sólo es útil si ha habilitado la retención de estado usando la directiva retención de la información de estado o retain_state_information. Valor: 0 = desactivar la retención de información de estado, 1 = habilitar la retención de la información de estado.

retain_nonstatus_information:

Esta directiva se utiliza para determinar si la información de estado sobre el equipo se mantiene después del reinicio el programa. Esto sólo es útil si ha habilitado la directiva de retención de estado o retain_state_information . El valor Value: 0 = des-habilitado la retención de información de estado,Value: 1 = habilitar la retención de la información de estado.

contacts:

Esta es una lista de los nombres cortos de los contactos que debe ser notificado cada vez que hay problemas (o recuperación) con esta máquina. Contactos múltiples deben estar separados por comas. Es útil si desea que las notificaciones se envíen a unas pocas personas y no desea configurar los contact groups . Debe especificar al menos un contacto o un grupo de contacto en cada definición de equipo.

contact_groups:

Esto es una lista de nombres cortos de los contact groups a los cuales se notificará en caso de incidentes o recuperaciones de un equipo. Usted debe de especificar al menos un contacto o grupo de contactos en cada definición de equipo.

notification_interval:

Esta directiva identifica cuantas “unidades de tiempo” o "time units" se debe de esperar para volver a notificar a los contactos acerca la caída de un dispositivo que aun no es alcanzable. A menos que usted haya cambiado la directiva de longitud del intervalo (interval_length) de su valor por defecto de 60, este numero se indica en minutos. Si cambia el valor a 0, Nagios no volverá a notificar este evento a los contactos y solo una única notificación será enviada a los contactos.

first_notification_delay:

Esta identifica nos permite definir las “unidades de tiempo” o "time units" de espera entre de enviar la notificación de un problema cuando un dispositivo esta no disponible. A menos que haya cambiado la directiva longitud del intervalo (interval_length) de su valor por defecto que es 60, expresado en minutos, Nagios enviará inmediatamente las notificaciones si su valor es 0.

notification_period:

Esta directiva es usada para especificar el nombre corto de un periodo de tiempo (time period) durante el cual las notificaciones o eventos de este equipo puede ser enviado a los contactos. Si el equipo pierde conexión o se para o es inalcanzable, y se recupera entre de que se acabe este tiempo definido, no se enviará ninguna notificación

notification_options:

Esta directiva se utiliza para determinar si las notificaciones para el equipo debe ser enviado. Las opciones válidas son una combinación de uno o más de los siguientes: d = enviar notificaciones sobre el estado Abajo, u = enviar notificaciones en un estado inalcanzable, r = enviar notificaciones sobre las recuperaciones (estado OK), f = enviar notificaciones cuando el equipo comienza y deja de flapear (flapping), y s = enviar notificaciones cuando se programa comienza y termina el tiempo de inactividad scheduled downtime . Si se especifica n (no) como una opción, ningún evento del equipo será enviada. Si no se especifica ninguna de las opciones de notificación, Nagios a suponer que usted desea que las notificaciones se enviarán a todos los estados posibles. Ejemplo: Si se especifica d, r en este campo, sólo las notificaciones serán enviadas cuando el host se cae y cuando se recupera de un estado ABAJO.

notifications_enabled *:

Esta directiva se utiliza para determinar si las notificaciones para este equipo están habilitadas. Valores: 0 = des-habilitar las notificaciones del equipo, 1 = habilitar las notificaciones del equipo.

stalking_options:

Esta directiva determina que estados del equipo "acecho o "stalking"" está habilitados. Las opciones válidas son una combinación de uno o más de los siguientes: o = stalk en estados UP , d = stalk a los estados caído, y u = tallo a los Estados inalcanzable. Más información sobre el estado de acecho ( stalking) se puede encontrar aquí here .

notes:

Esta directiva se utiliza para definir una cadena opcional de notas relacionadas con el host. Si se especifica una nota aquí, podrás ver las que en la información ampliada información ampliada (extended information) CGI (cuando está viendo la información sobre el host).

notes_url:

Esta variable se utiliza para definir una dirección URL opcional que puede utilizarse para proporcionar más información acerca del host. Si se especifica una dirección URL, podrás ver un icono de carpeta roja en el CGI (cuando está viendo la información del host) que enlaza con la dirección que especifique aquí. Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será el mismo que lo que se utiliza para acceder a los CGIs (es decir, / cgi-bin/nagios /). Esto puede ser muy útil si quieres hacer que la información detallada en el host, los métodos de contacto de emergencia, etc a disposición del personal de apoyo.

action_url:

Esta directiva se utiliza para definir una dirección URL opcional que se puede utilizar para ofrecer más acciones a realizar en el host. Si se especifica una dirección URL, podrás ver un rojo "símbolo de" icono de la CGI (cuando está viendo la información del host) que enlaza con la dirección que especifique aquí. Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será el mismo que lo que se utiliza para acceder a los CGIs (es decir, / cgi-bin/nagios /).

icon_image:

Esta variable se utiliza para definir el nombre de una imagen GIF, PNG o JPG que deben estar asociados con este equipo. Esta imagen se mostrará en los diferentes lugares en el CGI. La imagen se verá mejor si se trata de 40x40 píxeles de tamaño. Imágenes de los ejércitos se supone que en los logos / subdirectorio en su directorio de imágenes de HTML (es decir, /usr/local/nagios/share/images/logos).

icon_image_alt:

Esta variable se utiliza para definir una cadena opcional que se utiliza en la etiqueta ALT de la imagen especificada por el argumento .

vrml_image:

Esta variable se utiliza para definir el nombre de una imagen GIF, PNG o JPG que deben estar asociados con este dispositivo. Esta imagen se utiliza como mapa de textura para el host especificado en el CGI statuswrl. A diferencia de la imagen se utiliza para la variable , éste probablemente no debería tener ninguna transparencia. Si lo hace, el objeto host se verá un poco raro. Las imágenes de los equipos se supone que esta en el subdirectorio logos/ de imágenes HTML (es decir, /usr/local/nagios/share/images/logos).

statusmap_image:

Esta variable se utiliza para definir el nombre de una imagen que debe estar asociado con esta máquina en el CGI statusmap. Puede especificar una imagen JPEG, PNG y GIF si quieres, aunque me gustaría sugerir fuertemente con una imagen en formato GD2, como otros formatos de imagen resultará en una gran cantidad de tiempo de CPU desperdiciado cuando la imagen statusmap se genera. GD2 imágenes pueden crearse a partir de imágenes PNG con la utilidad pngtogd2 suministrado con la biblioteca gd library de Thomas Boutell. Las imágenes GD2 se debe crear en formato sin comprimir con el fin de minimizar la carga de la CPU cuando el statusmap CGI está generando el mapa de red. La imagen se verá mejor si se trata de 40x40 píxeles de tamaño. Puede dejar estas opciones en blanco si no está utilizando el CGI statusmap. Las imágenes de los equipos se supone que esta en el subdirectorio logos/ de imágenes HTML (es decir, /usr/local/nagios/share/images/logos).

2d_coords:

Esta variable se utiliza para definir las coordenadas a utilizar al dibujar los equipos en el CGI de mapa de estado (statusmap) . Las coordenadas se dan en números enteros positivos, ya que corresponden a los píxeles de física en la imagen generada. El origen de dibujo (0,0) se encuentra en la esquina superior izquierda de la imagen y se extiende en la dirección positiva x (a la derecha) en la parte superior de la imagen y en la dirección y positiva (hacia abajo) a lo largo de la mano izquierda lado de la imagen. Como referencia, el tamaño de los iconos elaborado suele ser de unos 40x40 píxeles (el texto toma un poco más de espacio). Las coordenadas que especifique aquí son para la esquina superior izquierda del icono de equipo que se dibuja. Nota: No te preocupes por lo que el máximo de coordenadas X e Y que se pueden utilizar . El CGI calculará automáticamente las dimensiones máximas de la imagen se crea sobre la base de la mayor coordenadas x e y que especifique.

3d_coords:

Esta variable se utiliza para definir las coordenadas a utilizar en la elaboración de acogida en el CGI statuswrl . Las coordenadas pueden ser números reales positivos o negativos. El origen de dibujo (0.0,0.0,0.0). Como referencia, el tamaño de los cubos de acogida establecido es de 0,5 unidades en cada lado (el texto toma un poco más de espacio). Las coordenadas que especifique aquí se utilizan como el centro del cubo del equipo.

Definición de grupos de equipos

Descripción:

Una definición de la grupo de equipos se utiliza para agrupar una o más hosts juntos para simplificar la configuración con trucos de objetos (object tricks) o propósitos de la exhibición en el CGIs.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define hostgroup{

hostgroup_name

hostgroup_name

alias

alias

members

hosts

hostgroup_members

hostgroups

notes

note_string

notes_url

url

action_url

url

}

Definición de ejemplo:

define hostgroup{

hostgroup_name novell-servers

alias Novell Servers

members netware1,netware2,netware3,netware4

}

Descripción de las directivas:

hostgroup_name:

Esta directiva se utiliza para definir un nombre corto para identificar el grupo de equipos.

alias:

Esta directiva se utiliza para definir un nombre más largo o una descripción para identificar el grupo de equipos. Se proporciona a fin de permitir a identificar más fácilmente a un grupo determinado de equipos.

members:

Esta es una lista de los nombres cortos de los equipos (hosts) que se deben incluir en este grupo. Varios nombres de equipo deben separarse con comas. Esta directiva puede ser usada como una alternativa (o además) a la directiva hostgroups en las definiciones de equipos (host definitions).

hostgroup_members:

Esta directiva opcional puede ser usada para incluir a los equipos de otros sub grupos de en este grupo de equipos. Especificar una lista de los nombres cortos de los grupos de equipos , cuyos miembros deben ser incluidos en este grupo, separados por comas.

notes:

Esta directiva se utiliza para definir una cadena opcional de notas relacionadas con el host. Si se especifica una nota aquí, podrás ver el que en la información ampliada (extended information) del CGI (cuando está viendo la información sobre el equipo).

notes_url:

Esta variable se utiliza para definir una URL opcional que se puede utilizar para proporcionar más información sobre el grupo de acogida. Si se especifica una dirección URL, usted verá un icono de carpeta roja en el CGI (cuando está viendo la información hostgroup) que enlaza con la URL que especifique aquí. Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será la misma como lo que se utiliza para acceder a la CGI (es decir, /cgi-bin/nagios/). Esto puede ser muy útil si desea hacer que la información detallada sobre el grupo de equipos, los métodos de contacto de emergencia, etc a disposición del personal de apoyo.

action_url:

Esta directiva se utiliza para definir una URL opcional que se puede utilizar para ofrecer más acciones a realizar en el grupo de acogida. Si se especifica una dirección URL, se vea una luz roja "splat" icono de la CGI (cuando está viendo la información hostgroup) que enlaza con la URL que especifique aquí. Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será la misma como lo que se utiliza para acceder a la CGI (es decir, /cgi-bin/nagios/).

Definición del Servicio

Descripción:

Una definición de servicio se utiliza para identificar un "servicio" que se ejecuta en un equipo. El término "servicio" se utiliza de manera muy informal. Puede significar un servicio real que se ejecuta en el host (POP, SMTP, HTTP, etc) o algún otro tipo de métrica asociada con el huésped (respuesta a un ping, el número de usuarios conectados, espacio libre en disco, etc) . Los diferentes argumentos para una definición de servicio se describen a continuación.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define service{

host_name

host_name

hostgroup_name

hostgroup_name

service_description

service_description

display_name

display_name

servicegroups

servicegroup_names

is_volatile

[0/1]

check_command

command_name

initial_state

[o,w,u,c]

max_check_attempts

#

check_interval

#

retry_interval

#

active_checks_enabled

[0/1]

passive_checks_enabled

[0/1]

check_period

timeperiod_name

obsess_over_service

[0/1]

check_freshness

[0/1]

freshness_threshold

#

event_handler

command_name

event_handler_enabled

[0/1]

low_flap_threshold

#

high_flap_threshold

#

flap_detection_enabled

[0/1]

flap_detection_options

[o,w,c,u]

process_perf_data

[0/1]

retain_status_information

[0/1]

retain_nonstatus_information

[0/1]

notification_interval

#

first_notification_delay

#

notification_period

timeperiod_name

notification_options

[w,u,c,r,f,s]

notifications_enabled

[0/1]

contacts

contacts

contact_groups

contact_groups

stalking_options

[o,w,u,c]

notes

note_string

notes_url

url

action_url

url

icon_image

image_file

icon_image_alt

alt_string

}

Definición de ejemplo:

define service{

host_name linux-server

service_description check-disk-sda1

check_command check-disk!/dev/sda1

max_check_attempts 5

check_interval 5

retry_interval 3

check_period 24x7

notification_interval 30

notification_period 24x7

notification_options w,c,r

contact_groups linux-admins

}

Descripción de las directivas:

host_name:

Esta directiva es usada para especificar el nombre corto del equipo (host(s)) en el cual “corre” o está asociado el servicio. Se pueden crear varios equipos, separandolos con comas.

hostgroup_name:

Esta directiva se utiliza para especificar el nombre(s) corto(s) del nombre de grupo (hostgroup(s)) sobre el cual el servicio "funciona" o está asociado. Múltiples grupos deben estar separados por comas. El hostgroup_name se puede utilizar en lugar de, o además de, la directiva host_name.

service_description;:

Esta directiva se utiliza para definir la descripción del servicio, que puede contener espacios, guiones y dos puntos (puntos y comas, apostrofes, comillas y se debe evitar). Dos servicios relacionados con la misma máquina no pueden tener la misma descripción. Los servicios se identifican con sus host_name y directivas service_description.

display_name:

Esta directiva se utiliza para definir un nombre alternativo que se debe mostrar en la interfaz web de este servicio. Si no se especifica, el valor especificado por defecto viene especificado en la directiva service_description. Nota: Los CGIs actuales no utilizan esta opción, a pesar de las futuras versiones de la interfaz web.

servicegroups:

Esta directiva se utiliza para identificar el nombre(s) corto(s) (short name(s)) del grupo de servicio (servicegroup(s)) al cual pertenece. Múltiples grupos de servicio deben estar separados por comas. Esta directiva puede ser usada como una alternativa al uso de los miembros en las definiciones de la directiva de grupos de servicios o (servicegroup) .

is_volatile:

Esta directiva se utiliza para indicar si el servicio es "volátil". Los servicios normalmente no son volátiles. Más información sobre el servicio volátil y en qué se diferencian de los servicios normales se puede encontrar aquí. Valor: 0 = servicio no es volátil, un servicio = es volátil.

check_command:

Esta directiva se utiliza para especificar el nombre abreviado o short name del comando que Nagios ejecutará para comprobar el estado del servicio. La cantidad máxima de tiempo que el comando de servicio de comprobación puede se controlado por la opción service_check_timeout

initial_state:

De forma predeterminada Nagios asumirá que todos los servicios se encuentran en estado correcto o OK cuando se inicia. Se puede reemplazar el estado inicial de un servicio mediante el uso de esta directiva. Las opciones válidas son: o = OK, w = ADVERTENCIA, u = DESCONOCIDO, y c = CRÍTICO.

max_check_attempts:

Esta directiva se utiliza para definir el número de veces que Nagios volverá a intentar el comando de verificación de servicios si se devuelve cualquier estado que no sea un estado correcto o levantado. Al establecer este valor en 1 hará que Nagios genere una alerta, sin volver a intentar el chequeo de servicio de nuevo.

check_interval:

Esta directiva se utiliza para definir el número de "unidades de tiempo" para esperar antes de programar la próxima verificación del servicio "regular ". Los chequeos "Regular" son los que se producen cuando el servicio se encuentra en un estado bien o cuando el servicio se encuentra en un estado no bien, pero ya se ha alcanzado de nuevo el numero de re-intentos o max_check_attempts . A menos que haya cambiado la directiva interval_length del valor predeterminado de 60, este número significa minutos. Más información sobre este valor se puede encontrar en la documentación de la programación de verificación o check scheduling.

retry_interval:

Esta directiva se utiliza para definir el número de "unidades de tiempo" para esperar antes de programar una nueva revisión del servicio. Los servicios son re programados en el intervalo de re intento cuando se han cambiado a un estado no-OK. Una vez que el servicio ha sido revisado max_check_attempts veces sin un cambio en su estado, volverá a ser programado en su "normal " según lo definido por el valor check_interval. A menos que haya cambiado la directiva interval_length del valor predeterminado de 60, este número significa minutos. Más información sobre este valor se puede encontrar en la documentación de la programación de verificación (check scheduling).

active_checks_enabled *:

Esta directiva se utiliza para determinar si los controles activos de este servicio están habilitadas. Valores: 0 = des-habilitar las comprobaciones de servicio activo, 1 = activar los controles de servicio activo (por defecto). .

passive_checks_enabled *:

Esta directiva se utiliza para determinar si los controles pasivos de este servicio están habilitadas. Valores: 0 = des-habilitar las comprobaciones de servicio pasivo, 1 = activar los controles pasivos de servicios (por defecto).

check_period:

Esta directiva se utiliza para especificar el nombre corto del período de tiempo o time period durante el cual los controles activos de este servicio se puede hacer.

obsess_over_service *:

Esta directiva determina si los controles para el servicio será "obsesionado" con respecto al uso de la ocsp_command. .

check_freshness *:

Esta directiva se utiliza para determinar si los controles frescura o freshness checks están habilitadas para este servicio. Valores: 0 = controles frescura desactivar, 1 = activar los controles frescura (por defecto).

freshness_threshold:

Esta directiva se utiliza para especificar el umbral de frescura (en segundos) para este servicio. Si se establece esta directiva por un valor de 0, Nagios determinará un umbral de frescura a usar automáticamente.

event_handler:

Esta directiva se utiliza para especificar el nombre abreviado o short name del comando que debe ejecutarse cada vez que un cambio en el estado (flapeo) del servicio se detecta (es decir, cada vez que se cae o se recupera). Lea la documentación sobre los controladores de eventos (event handlers) para obtener una explicación más detallada de cómo escribir guiones para la gestión de eventos. La cantidad máxima de tiempo que el comando de controlador de eventos se puede ejecutar es controlado por la opción event_handler_timeout.

event_handler_enabled *:

Esta directiva se utiliza para determinar si el controlador de eventos para este servicio está habilitado. Valores: 0 = desactivar el controlador de evento de servicio, 1 = activar controlador de servicio de sucesos.

low_flap_threshold:

Esta directiva se utiliza para especificar el umbral de cambio de estado de servicio. Más información sobre la detección de la aleta se puede encontrar aquí. Si se establece esta directiva por un valor de 0, el valor de todo el programa especificado por la directiva ow_service_flap_threshold se utilizará.

high_flap_threshold:

Esta directiva se utiliza para especificar el umbral de cambio de estado de alta utilizados en la detección de la cambio de este servicio. Más información sobre la detección cambio se puede encontrar aquí. Si se establece esta directiva a un valor de 0, el valor de todo el programa especificado por la directiva high_service_flap_threshold se utilizará.

flap_detection_enabled *:

Esta directiva se utiliza para determinar si la detección del cambio está habilitado para este servicio. Más información sobre la detección del cambio se puede encontrar aquí. Valores: 0 = des-habilitar la detección del cambio de servicio(flapeo), 1 = habilitar la detección de servicio de la flapping.

flap_detection_options:

Esta directiva se utiliza para determinar qué estados de servicio en la lógica de detección de alternancia de servicio (flapeo) o flap detection logic se utiliza para este servicio. Las opciones válidas son una combinación de uno o más de los siguientes: o = estados bien, w = ADVERTENCIA estados, c = estados críticos, u = estados DESCONOCIDO.

process_perf_data *:

Esta directiva se utiliza para determinar si el tratamiento de los datos de rendimiento está habilitado para este servicio. Valores: 0 = des-habilitar el rendimiento de procesamiento de datos, 1 = activar el rendimiento del procesamiento de datos.

retain_status_information:

Esta directiva se utiliza para determinar la información o no relacionados con el estado sobre el servicio se mantiene a través del programa cuando este se reinicia. Esto sólo es útil si ha habilitado la retención de estado usando la directiva retain_state_information. Valor: 0 = desactivar la retención de información de estado, 1 = habilitar la retención de la información de estado.

retain_nonstatus_information:

Esta directiva se utiliza para determinar si la información de estado sobre el servicio se mantiene cuando el programa se reinicia. Esto sólo es útil si ha habilitado la retención de estado usando la directiva retain_state_information. Valor: 0 = desactivar la retención de información no-estado, 1 = habilitar la retención no la información de estado.

notification_interval:

Esta directiva se utiliza para definir el número de "unidades de tiempo" para esperar antes de volver a notificar a un contacto que este servicio se encuentra todavía en un estado no-OK. A menos que haya cambiado la directiva interval_length del valor predeterminado de 60, este número significa minutos. Si establece este valor a 0, Nagios no volverá a notificar a los contactos sobre los problemas de este servicio - sólo un a notificación del problema será enviado.

first_notification_delay:

Esta directiva se utiliza para definir el número de "unidades de tiempo" para esperar antes de enviar la notificación primer problema cuando este servicio entra en un estado no-OK. A menos que haya cambiado la directiva interval_length , el valor predeterminado de 60, este número significa minutos. Si establece este valor a 0, Nagios comenzará a enviar las notificaciones de inmediato

notification_period:

Esta directiva se utiliza para especificar el nombre corto del período de tiempo o time period durante el cual las notificaciones de eventos para este servicio se pueden enviar a los contactos. Ninguna notificación de servicio se enviarán durante el tiempo que no está cubierto por este valor de periodo.

notification_options:

Esta directiva se utiliza para determinar si las notificaciones por el servicio debe ser enviado. Las opciones válidas son una combinación de uno o más de los siguientes: w = enviar notificaciones en un estado de advertencia, u = enviar notificaciones en un estado desconocido, c = enviar notificaciones en un estado crítico, r = enviar notificaciones sobre las recuperaciones (estado OK) , f = enviar notificaciones cuando se inicia el servicio y deja de batir, y s = enviar notificaciones cuando se programa comienza y termina el tiempo de inactividad (scheduled downtime). Si se especifica n (no) como una opción, ninguna notificación se enviará. Si no se especifica ninguna de las opciones de notificación, Nagios a suponer que usted desea que las notificaciones se enviarán a todos los estados posibles. Ejemplo: Si se especifica w, r en este campo, las notificaciones sólo se enviarán cuando el servicio entra en un estado de advertencia y cuando se recupera de un estado de advertencia.

notifications_enabled *:

Esta directiva se utiliza para determinar si las notificaciones para este servicio están habilitados. Valores: 0 = desactivar el servicio de notificaciones, 1 = activar las notificaciones de servicio.

contacts:

Esta es una lista de los nombres cortos de los contactos que debe ser notificados cada vez que hay problemas (o recuperación) con este servicio. Varios contactos deben estar separadas por comas. Útil si desea que las notificaciones se dirige sólo a unas cuantas personas y no desea configurar grupos de contacto. Debe especificar al menos un contacto o un grupo de contacto en cada definición de servicio.

contact_groups:

Esta es una lista de los nombres cortos de los grupos de contacto o contact groups que debe ser notificado cada vez que hay problemas (o recuperación) con este servicio. Varios grupos de contacto en caso de estar separados por comas. Debe especificar al menos un contacto o un grupo de contacto en cada definición de servicio.

stalking_options:

Esta directiva determina que servicios están en estado "stalking" están habilitado. Las opciones válidas son una combinación de uno o más de los siguientes: o = stalking en estados bien, w = stalking a los Estados ADVERTENCIA, u = stalking a los Estados DESCONOCIDO, y c = stalking en estados críticos. Más información sobre el stalking oso del Estado se puede encontrar aquí.

notes:

Esta directiva se utiliza para definir una cadena opcional de notas relacionadas con el servicio. Si se especifica una nota aquí, podrás ver el que en el CGI la información ampliada o extended information (cuando está viendo la información sobre el servicio especificado).

notes_url:

Esta directiva se utiliza para definir una URL opcional que se puede utilizar para proporcionar más información sobre el servicio. Si se especifica una dirección URL, usted verá un icono de carpeta roja en el CGI (si es que ves la información de servicio) que enlaza con la URL que especifique aquí. Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será la misma como lo que se utiliza para acceder a la CGI (es decir, /cgi-bin/nagios/). Esto puede ser muy útil si desea hacer que la información detallada sobre el servicio, los métodos de contacto de emergencia, etc a disposición del personal de apoyo.

action_url:

Esta directiva se utiliza para definir una URL opcional que se puede utilizar para ofrecer más acciones a realizar en el servicio. Si se especifica una dirección URL, se vea una luz roja "splat" icono de la CGI (si es que ves la información de servicio) que enlaza con la URL que especifique aquí. Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será la misma como lo que se utiliza para acceder a la CGI (es decir /cgi-bin/nagios/).

icon_image:

Esta variable se utiliza para definir el nombre de una imagen GIF, PNG, JPG o que deben ser asociados con este servicio. Esta imagen se mostrará en el estado (status) y el CGIs con información extendida o extended information. La imagen se verá mejor si es de 40x40 píxeles. Imágenes de los servicios se supone que están en los logotipos / subdirectorio en el directorio de imágenes en HTML (es decir, //usr/local/nagios/share/images/logos).

icon_image_alt:

Esta variable se utiliza para definir una cadena opcional que se utiliza en la etiqueta ALT de la imagen especificada por el argumento . La etiqueta ALT se utiliza en el estado (status), la extended information y CGIs statusmap.

Service Group Definition

Descripción:

El grupo de servicio se utiliza para agrupar una o más servicios en conjunto para simplificar la configuración con trucos objeto o object tricks o propósitos de la exhibición en el CGIs.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define servicegroup{

servicegroup_name

servicegroup_name

alias

alias

members

services

servicegroup_members

servicegroups

notes

note_string

notes_url

url

action_url

url

}

Definición de ejemplo:

define servicegroup{

servicegroup_name dbservices

alias Database Services

members ms1,SQL Server,ms1,SQL Server Agent,ms1,SQL DTC

}

Descripción de las directivas:

servicegroup_name:

Esta directiva es usada para definir el nombre de un grupo de servicios.

alias:

Esta directiva se utiliza para definir un nombre más largo o una descripción para identificar el grupo de servicio. Se proporciona a fin de permitir a identificar más fácilmente a un grupo determinado servicio.

members:

Esta es una lista de las descripciones de los servicios (y los nombres de sus equipos correspondiente) que deben incluirse en este grupo. Los nombres de host y el servicio deben estar separadas por comas. Esta directiva se puede utilizar como una alternativa a la directiva servicegroups en las definiciones de servicio (service definitions ). El formato de la Directiva miembro es el siguiente (tenga en cuenta que un nombre de host debe preceder a un nombre de servicio en la descripción):

members=,,,,...,,

servicegroup_members:

Esta directiva opcional puede ser usado para incluir los servicios de otros “sub” grupos de servicio a este grupo de servicio. Especifica una lista delimitada por comas de nombres cortos de los grupos de servicio de otros, cuyos miembros deben ser incluidos en este grupo.

notes:

Esta directiva se utiliza para definir una cadena opcional de notas relacionadas con el grupo de servicio. Si se especifica una nota aquí, podrás ver las que en la información ampliada extended information CGI (cuando está viendo la información sobre el grupo de servicio especificado).

notes_url:

Esta directiva se utiliza para definir una dirección URL opcional que puede utilizarse para proporcionar más información sobre el grupo de servicio. Si se especifica una dirección URL, podrás ver un icono de carpeta roja en el CGI (cuando está viendo la información de servicio del grupo) que se vincula a la dirección que especifique aquí. Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será el mismo que lo que se utiliza para acceder a los CGIs (es decir, /cgi-bin/nagios/). Esto puede ser muy útil si quieres hacer que la información detallada sobre el grupo de servicio, los métodos de contacto de emergencia, etc a disposición del personal de apoyo.

action_url:

Esta directiva se utiliza para definir una dirección URL opcional que se puede utilizar para ofrecer más acciones a realizar en el grupo de servicio. Si se especifica una dirección URL, podrás ver un rojo "símbolo de" icono de la CGI (cuando está viendo la información de servicio del grupo) que se vincula a la dirección que especifique aquí. Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será el mismo que lo que se utiliza para acceder a los CGIs (es decir, /cgi-bin/nagios/).

Definición de contacto

Descripción:

Una definición de contacto se utiliza para identificar a alguien a quien se debe contactar en caso de un problema en la red. Los diferentes argumentos para una definición de contacto se describe a continuación.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define contact{

contact_name

contact_name

alias

alias

contactgroups

contactgroup_names

host_notifications_enabled

[0/1]

service_notifications_enabled

[0/1]

host_notification_period

timeperiod_name

service_notification_period

timeperiod_name

host_notification_options

[d,u,r,f,s,n]

service_notification_options

[w,u,c,r,f,s,n]

host_notification_commands

command_name

service_notification_commands

command_name

email

email_address

pager

pager_number or pager_email_gateway

addressx

additional_contact_address

can_submit_commands

[0/1]

retain_status_information

[0/1]

retain_nonstatus_information

[0/1]

}

Definición de ejemplo:

define contact{

contact_name jdoe

alias John Doe

host_notifications_enabled 1

service_notifications_enabled 1

service_notification_period 24x7

host_notification_period 24x7

service_notification_options w,u,c,r

host_notification_options d,u,r

service_notification_commands notify-by-email

host_notification_commands host-notify-by-email

email jdoe@localhost.localdomain

pager 555-5555@pagergateway.localhost.localdomain

address1 xxxxx.xyyy@icq.com

address2 555-555-5555

can_submit_commands 1

}

Descripción de las directivas:

contact_name:

Esta directiva se utiliza para definir un nombre corto para identificar el contacto. Se hace referencia en las definiciones de grupo de contacto contact group . Bajo las circunstancias adecuadas, la macro $CONTACTNAME$ contendrá este valor.

alias:

Esta directiva se utiliza para definir un nombre más largo o la descripción del contacto. En estas circunstancias los derechos, la macro $CONTACTALIAS$ contendrá este valor. Si no se especifica, el contact_name se utilizará como alias

contactgroups:

Esta directiva se utiliza para identificar el nombre corto (s) del grupo de contacto al cual el contacto pertenece. Múltiples grupos de contacto deben estar separados por comas. Esta directiva se puede utilizar como una alternativa a (o además) a los miembros de la directiva en las definiciones de grupo de contacto o contactgroup

host_notifications_enabled:

Esta directiva se utiliza para determinar si el contacto recibirá las notificaciones acerca de los problemas y recuperaciones Valores: 0 = no enviar notificaciones, 1 = enviar notificaciones.

service_notifications_enabled:

Esta directiva se utiliza para determinar si el contacto recibirá las notificaciones sobre los problemas de servicio y las recuperaciones. Valores: 0 = no enviar notificaciones, 1 = enviar notificaciones.

host_notification_period:

Esta directiva se utiliza para especificar el nombre corto del período de tiempo o time period durante el cual puede ser el contacto notificado acerca de los problemas de caída o recuperación. Usted puede pensar en esto como una llamada de las notificaciones a los contactos. Lea la documentación relativa a los plazos de tiempo o time periods para obtener más información sobre cómo funciona esto y los problemas potenciales que pueden derivarse de un uso inadecuado.

service_notification_period:

Esta directiva se utiliza para especificar el nombre corto del período de tiempo time period durante el cual puede ser el contacto notificado acerca de los problemas de servicio o recuperaciones. Usted puede pensar en esto como una llamada de las notificaciones de servicios para el contacto. Lea la documentación relativa a los plazos de tiempo time periods para obtener más información sobre cómo funciona esto y los problemas potenciales que pueden derivarse de un uso inadecuado.

host_notification_commands:

Esta directiva se utiliza para definir una lista de los nombres cortos de los comandos o commands utilizados para notificar al contacto de un problema de caída o recuperación. Varios comandos notificación debe ser separado por comas. Todos los comandos de la notificación se ejecutan cuando el contacto tiene que ser notificada. La cantidad máxima de tiempo que un comando se puede ejecutar la notificación está controlado por la opción tiempo de espera de la notificación o notification_timeout.

host_notification_options:

Esta directiva se utiliza para definir los estados de los equipos para que las notificaciones se pueden enviar a este contacto. Las opciones válidas son una combinación de uno o más de los siguientes: d = Notificar por los estados de equipos caídos, u = notificará a los Estados de equipo inalcanzable, r = notificar acerca de la recepción de equipos de sistemas UP estados, f = notifique cuando la máquina arranca y “flapea” o “bate” flapping , y s = enviar notificaciones cuando el tiempo de inactividad del equipo o scheduled downtime o servicio regular comienza y termina. Si se especifica n (no) como una opción, el contacto no recibirá ningún tipo de notificaciones de acogida.

service_notification_options:

Esta directiva se utiliza para definir los estados de servicio para que las notificaciones se pueden enviar a este contacto. Las opciones válidas son una combinación de uno o más de los siguientes: w = notificar a ADVERTENCIA o WARNING de estados de servicio, u = notificar a los estados de servicio DESCONOCIDO o UNKNOWN, c = notificará a los Estados servicio crítico o CRITICAL, r = notificar acerca de la recuperación de servicio (estados OK), y f = notificará cuando el servicio se inicia y se detiene aleteo o flapping . Si se especifica n (no) como una opción, el contacto no recibirá ningún tipo de notificaciones de servicio.

service_notification_commands:

Esta directiva se utiliza para definir una lista de los nombres cortos de los comandos utilizados para notificar a los contactos de un problema de servicio o de recuperación. Varios comandos de notificación deben estar separadas por comas. Todos los comandos de la notificación se ejecutan cuando el contacto debe ser notificado. La cantidad máxima de tiempo que un comando de notificación puede ejecutar es controlado por la opción notification_timeout.

email:

Esta directiva se utiliza para definir una dirección de correo electrónico para el contacto. Dependiendo de cómo configurar los comandos de notificación, que puede ser utilizado para enviar un correo electrónico de alerta para el contacto. En las circunstancias adecuadas, la macro $CONTACTEMAIL contendrá este valor.

pager:

Esta directiva se utiliza para definir un número de localizador para el contacto. También puede ser una dirección de correo electrónico a una pasarela de buscapersonas (es decir, pagejoe@pagenet.com). Dependiendo de cómo configurar los comandos de notificación, que puede ser utilizado para enviar una página de alerta para el contacto. En las circunstancias adecuadas, la macro $ CONTACTPAGER contendrá este valor.

addressx:

Directivas de direcciones se utilizan para definir adicionales "direcciones" para el contacto. Estas direcciones pueden ser cualquier cosa - números de teléfonos celulares, direcciones de mensajería instantánea, etc Dependiendo de cómo configurar los comandos de notificación, que se puede utilizar para enviar una alerta al contacto. Hasta seis direcciones se pueden definir utilizando estas directivas (address1 través address6). La macro $CONTACTADDRESSx contendrá este valor.

can_submit_commands:

Esta directiva se utiliza para determinar si el contacto puede enviar comandos externos para Nagios desde el CGI. Valores: 0 = no permiten el contacto para enviar comandos, 1 = permitir el contacto para enviar comandos.

retain_status_information:

Esta directiva se utiliza para determinar si procede o no el estatuto de la información relacionada sobre el contacto se mantiene a través de reinicia el programa. Esto sólo es útil si se ha habilitado la retención de estado o retain_state_information usando la directiva retain_state_information. Valor: 0 = desactivar la retención de información de estado, 1 = estado de permitir la retención de información.

retain_nonstatus_information:

Esta directiva se utiliza para determinar cuando la información de estado sobre el contacto se mantiene mientras se reinicia el programa. Esto sólo es útil si se ha habilitado la retención de estado usando la directiva retain_state_information. Valor: 0 = desactivar sin estatus de retención de información, 1 = activar sin estatus de retención de información.

Definición del Grupo de Contacto

Descripción:

Una definición de grupo de contacto se utiliza para agrupar uno o más contactos en conjunto con el propósito de enviar las notificaciones de las alertas / recuperaciones.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define contactgroup{

contactgroup_name

contactgroup_name

alias

alias

members

contacts

contactgroup_members

contactgroups

}

Definición de ejemplo:

define contactgroup{

contactgroup_name novell-admins

alias Novell Administrators

members jdoe,rtobert,tzach

}

Descripción de las directivas:

contactgroup_name:

Esta directiva es un nombre corto que se utiliza para identificar el grupo de contacto.

alias:

Esta directiva se utiliza para definir un nombre más largo o una descripción para identificar el grupo de contacto.

members:

Esta directiva opcional se utiliza para definir una lista de los nombres cortos de contactos que se deben incluir en este grupo. Varios nombres de contacto en caso de estar separados por comas. Esta directiva puede ser usada como una alternativa a (o además) con la directiva contactgroups en las definiciones de contacto

contactgroup_members:

Esta directiva opcional puede ser usado para incluir contactos de otros grupos "sub" en contacto con este grupo de contacto. Especificar una lista delimitada por comas de los nombres cortos de otros grupos de contacto, cuyos miembros deben ser incluidos en este grupo.

Definición de Período de tiempo

Descripción:

Un período de tiempo es una lista de tiempos durante varios días que se consideran "válida" los tiempos para las notificaciones y cheques de servicio. Se compone de intervalos de tiempo para cada día de la semana que "rotan" una vez que la semana ha llegado a su fin. Los diferentes tipos de excepciones a la jornada semanal normal son soportados, incluyendo: lunes a viernes específicas, los días de los meses genéricos, los días de los meses concretos y fechas del calendario.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define timeperiod{

timeperiod_name

timeperiod_name

alias

alias

[weekday]

timeranges

[exception]

timeranges

exclude

[timeperiod1,timeperiod2,...,timeperiodn]

}

Ejemplo de definiciones:

define timeperiod{

timeperiod_name nonworkhours

alias Non-Work Hours

sunday 00:00-24:00 ; Every Sunday of every week

monday 00:00-09:00,17:00-24:00 ; Every Monday of every week

tuesday 00:00-09:00,17:00-24:00 ; Every Tuesday of every week

wednesday 00:00-09:00,17:00-24:00 ; Every Wednesday of every week

thursday 00:00-09:00,17:00-24:00 ; Every Thursday of every week

friday 00:00-09:00,17:00-24:00 ; Every Friday of every week

saturday 00:00-24:00 ; Every Saturday of every week

}

define timeperiod{

timeperiod_name misc-single-days

alias Misc Single Days

1999-01-28 00:00-24:00 ; January 28th, 1999

monday 3 00:00-24:00 ; 3rd Monday of every month

day 2 00:00-24:00 ; 2nd day of every month

february 10 00:00-24:00 ; February 10th of every year

february -1 00:00-24:00 ; Last day in February of every year

friday -2 00:00-24:00 ; 2nd to last Friday of every month

thursday -1 november 00:00-24:00 ; Last Thursday in November of every year

}

define timeperiod{

timeperiod_name misc-date-ranges

alias Misc Date Ranges

2007-01-01 - 2008-02-01 00:00-24:00 ; January 1st, 2007 to February 1st, 2008

monday 3 - thursday 4 00:00-24:00 ; 3rd Monday to 4th Thursday of every month

day 1 - 15 00:00-24:00 ; 1st to 15th day of every month

day 20 - -1 00:00-24:00 ; 20th to the last day of every month

july 10 - 15 00:00-24:00 ; July 10th to July 15th of every year

april 10 - may 15 00:00-24:00 ; April 10th to May 15th of every year

tuesday 1 april - friday 2 may 00:00-24:00 ; 1st Tuesday in April to 2nd Friday in May of every year

}

define timeperiod{

timeperiod_name misc-skip-ranges

alias Misc Skip Ranges

2007-01-01 - 2008-02-01 / 3 00:00-24:00 ; Every 3 days from January 1st, 2007 to February 1st, 2008

2008-04-01 / 7 00:00-24:00 ; Every 7 days from April 1st, 2008 (continuing forever)

monday 3 - thursday 4 / 2 00:00-24:00 ; Every other day from 3rd Monday to 4th Thursday of every month

day 1 - 15 / 5 00:00-24:00 ; Every 5 days from the 1st to the 15th day of every month

july 10 - 15 / 2 00:00-24:00 ; Every other day from July 10th to July 15th of every year

tuesday 1 april - friday 2 may / 6 00:00-24:00 ; Every 6 days from the 1st Tuesday in April to the 2nd Friday in May of every year

}

Descripción de las directivas:

timeperiod_name:

Este directivas es el nombre corto que se utiliza para identificar el período de tiempo.

alias:

Esta directiva es un nombre más largo o una descripción para identificar el período de tiempo.

[weekday]:

Las directivas de los días de semana ("Domingo" a través de "Sábado") están delimitados por comas listas de rangos de tiempo que son "válidos" los tiempos para un día determinado de la semana. Tenga en cuenta que hay siete días diferentes para las que se pueden definir rangos de tiempo (de domingo a sábado). Cada intervalo de tiempo es en la forma de HH:MM-HH:MM, donde se especifican horas en un reloj de 24 horas. Por ejemplo, 00:15-24:00 significa las 12:15a.m. en la mañana de este día hasta las 12:00 am la medianoche (23 horas, 45 minutos de tiempo es el rango total). Si usted desea excluir a un día entero de la TimePeriod, simplemente no lo incluya en la definición de período de tiempo.

[exception]:

Puede especificar varios tipos de excepciones al horario laborable estándar de rotación. Las excepciones pueden tomar una serie de formas diferentes, incluyendo un solo día de un mes específico o genérico, los días de semana solo en un mes, o las fechas de calendario único. También se puede especificar un rango de días / fechas e incluso especificar intervalos a saltar para obtener la funcionalidad descrita por "cada 3 días entre estas fechas". En lugar de una lista de todos los formatos posibles para las cadenas excepción, voy a dejar que nos fijemos en las definiciones de ejemplo TimePeriod de arriba para ver lo que es posible :-) . Durante la semana y diferentes tipos de excepciones todos tienen diferentes niveles de prioridad, lo que es importante para comprender cómo pueden afectar a los demás. Más información sobre esto se puede encontrar en la documentación sobre timeperiods.

exclude:

Esta directiva se utiliza para especificar los nombres cortos de otras definiciones de TimePeriod cuyos rangos de tiempo deben ser excluidos de este período de tiempo. Varios nombres TimePeriod deben ser separados con una coma.

Definición de Comando

Descripción:

Una definición de orden es sólo eso. Se define un comando. Los comandos que se pueden definir son los chequeos de servicios, notificaciones de servicio, los manipuladores de servicios de eventos, los controles de host, las notificaciones de host y los controladores de eventos del equipo. Definiciones de los comandos pueden contener macros, pero debe asegurarse de que incluya sólo las macros que son "válidas" en las circunstancias cuando el comando se utilizará. Más información sobre las macros están disponibles y cuando son "válidas" se puede encontrar aquí. Los diferentes argumentos para una definición de comandos se describen a continuación.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define command{

command_name

command_name

command_line

command_line

}

Definición de ejemplo:

define command{

command_name check_pop

command_line /usr/local/nagios/libexec/check_pop -H $HOSTADDRESS$

}

Descripción de las directivas:

command_name:

Esta directiva es el nombre corto que se utiliza para identificar el comando. Se hace referencia en las definiciones de contacto, de equipo, y de servicio (en la notificación, consulta, y las directivas de controlador de eventos), entre otros sitios.

command_line:

Esta directiva se utiliza para definir lo que realmente se ejecuta Nagios, cuando el comando se utiliza para el control de servicios o de equipos, las notificaciones, o controladores de eventos. Antes de la línea de comandos se ejecuta, todas las macros válidas son sustituidas por sus respectivos valores. Consulte la documentación de macros para determinar cuándo se pueden utilizar diferentes macros. Tenga en cuenta que la línea de comandos no está rodeado de comillas. Además, si usted desea pasar un signo de dólar ($) en la línea de comandos, usted tiene que finalizar esa linea con otro signo de dólar($).

NOTA: Usted debe no incluir un punto y coma (;) en la directiva command_line, porque después de todo lo que se tendrá en cuenta como un comentario fichero de configuración. Puede evitar esta limitación mediante el establecimiento de una de las macros $USER en el archivo de recursos o resource file a un punto y coma y luego hacer referencia a la macro adecuada $ USER $ en la directiva command_line en lugar del punto y coma.

Si usted desea pasar argumentos a los comandos en tiempo de ejecución, puede utilizar $ARGn$ macros en la directiva command_line de la definición del comando y luego se separan los argumentos individuales del nombre del comando (y el uno del otro) con signo de admiración (!) Los caracteres del objeto definición de directiva (ver comando del host, el servicio de mandatos de controlador de eventos, etc) que hace referencia el comando. Más información sobre cómo los argumentos en las definiciones de comandos se procesan en tiempo de ejecución se pueden encontrar en la documentación sobre las macros.

Definición de servicios de dependencia

Descripción:

Dependencias de los servicios son una característica avanzada de Nagios que permiten eliminar las notificaciones y cheques de activos de servicios basados en el estado de uno o más servicios. Dependencias de los servicios son opcionales y están dirigidos principalmente a usuarios avanzados que han complicado las configuraciones de control. Más información sobre el funcionamiento de las dependencias de servicio (lea esto!) Se puede encontrar aquí.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define servicedependency{

dependent_host_name

host_name

dependent_hostgroup_name

hostgroup_name

dependent_service_description

service_description

host_name

host_name

hostgroup_name

hostgroup_name

service_description

service_description

inherits_parent

[0/1]

execution_failure_criteria

[o,w,u,c,p,n]

notification_failure_criteria

[o,w,u,c,p,n]

dependency_period

timeperiod_name

}

Definición de ejemplo:

define servicedependency{

host_name WWW1

service_description Apache Web Server

dependent_host_name WWW1

dependent_service_description Main Web Site

execution_failure_criteria n

notification_failure_criteria w,u,c

}

Descripción de las directivas:

dependent_host_name:

Esta directiva se utiliza para identificar el nombre corto (s) de la máquina (s) o hots(s) que el servicio depende de "corre" en o está asociado. Varios hosts deben estar separadas por comas. Dejando en blanco esta directiva se puede utilizar para crear las dependencias con "el mismo host".

dependent_hostgroup_name:

Esta directiva se utiliza para especificar el nombre corto (s) de la grupo de equipos o hostgroup (s) sobre el cual el servicio el cual depende “corre" o está asociado. Múltiples grupos de equipos (Hostgroups) deben estar separados por comas. El dependent_hostgroup se puede utilizar en lugar de, o además de, la directiva dependent_host.

dependent_service_Descripción:

Esta directiva se utiliza para identificar la descripción de los servicios dependientes.

host_name:

Esta directiva se utiliza para identificar el nombre corto (s) de la máquina (s) (host) del cual depende el servicio (también conocida como la maestra de servicio) o el servicio está asociado. Varios hosts deben estar separadas por comas.

hostgroup_name:

Esta directiva se utiliza para identificar el nombre corto (s) del hostgroup (s) en el cual el servicio esta asociado. (también conocida como la maestra de servicio). Hostgroups múltiples deben estar separados por comas. El hostgroup_name se puede utilizar en lugar de, o además de, la directiva host_name.

service_Descripción:

Esta directiva se utiliza para identificar la descripción del servicio del cual se depende (también conocida como la maestra de servicio).

inherits_parent:

Esta directiva indica si la dependencia hereda las dependencias del servicio de las cuales dependía (también conocida como la maestra de servicio). En otras palabras, si el servicio principal depende de otros servicios y cualquiera de las dependencias falle, en esta dependencia también se producirá un error.

execution_failure_criteria:

Esta directiva se utiliza para especificar los criterios que determinan cuando el servicio dependiente no se debe comprobar. Si el servicio principal se encuentra en estado de error ,el servicio dependiente no se activa .

Las opciones válidas son una combinación de uno o más de los siguientes (opciones múltiples se separan con comas): o = fallo en un estado OK, w = error en un estado de advertencia, u = no en un estado desconocido, c = un error en un estado crítico, y p = no en un estado pendiente (por ejemplo, el servicio aún no ha sido comprobado). Si se especifica n (no) como una opción, la dependencia de la ejecución no se producirá un error y control del servicio depende siempre de forma activa seleccionada (si las condiciones lo permiten otros para que sea). Ejemplo: Si se especifica o, c, u en este campo, el servicio dependiente no se comprobará si el servicio de maestro, esta en un estado OK, CRITICAL o UNKNOWN.

notification_failure_criteria:

Esta directiva se utiliza para definir los criterios que determinan cuándo las notificaciones para el servicio dependiente no debe ser enviado. Si el servicio principal se encuentra en uno estado NO OK, las notificaciones para el servicio dependiente no se enviará a los contactos. Las opciones válidas son una combinación de uno o más de los siguientes: o = no en un estado bien, w = error en un estado de advertencia, u = no en un estado desconocido, c = no en un estado crítico, y p = a un estado pendiente (por ejemplo, el servicio aún no ha sido comprobado). Si se especifica n (no) como una opción, la dependencia de la notificación nunca fallan y las notificaciones para el servicio dependiente siempre será enviado. Ejemplo: Si se especifica w en este campo, las notificaciones para el servicio dependiente no se enviará si el servicio principal se encuentra en un estado de advertencia.

dependency_period:

Esta directiva se utiliza para especificar el nombre corto del período de tiempo durante el cual esta dependencia es válido. Si esta directiva no se especifica, la dependencia se considera que es válido durante todo el tiempo.

Definición de escalado del Servicio

Descripción:

Escaladas de servicios son opcionales y se utilizan para escalar las notificaciones para un servicio particular. Más información sobre la forma de notificación de trabajo escaladas se puede encontrar aquí.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define serviceescalation{

host_name

host_name

hostgroup_name

hostgroup_name

service_description

service_description

contacts

contacts

contact_groups

contactgroup_name

first_notification

#

last_notification

#

notification_interval

#

escalation_period

timeperiod_name

escalation_options

[w,u,c,r]

}

Definición de ejemplo:

define serviceescalation{

host_name nt-3

service_description Processor Load

first_notification 4

last_notification 0

notification_interval 30

contact_groups all-nt-admins,themanagers

}

Descripción de las directivas:

host_name:

Esta directiva se utiliza para identificar el nombre corto (s) del equipo o host (s) que la escalada de servicios debe aplicarse o está asociado.

hostgroup_name:

Esta directiva se utiliza para especificar el nombre corto (s) del hostgroup (s) por el cual el escalado de servicios debe aplicarse o está asociado. Múltiples hostgroups deben estar separados por comas. El hostgroup_name se puede utilizar en lugar de, o además de, la directiva host_name.

service_Descripción:

Esta directiva se utiliza para identificar la descripción de los servicios de escalado que se debe de aplicar.

first_notification:

Esta directiva es un número que identifica a la primera notificación de que esta escalada es eficaz. Por ejemplo, si establece este valor a 3, este aumento sólo se utilizará si el servicio está en un estado no-OK tiempo suficiente para que una tercera notificación.

last_notification:

Esta directiva es un número que identifica a la última notificación por la que esta escalada es eficaz. Por ejemplo, si establece este valor a 5, esta escalada no se utilizará si hay más de cinco notificaciones se envían por el servicio. Al establecer este valor a 0 significa seguir usando esta entrada escalada de siempre (no importa cómo muchas notificaciones deben de salir).

contacts:

Esta es una lista de los nombres cortos de los contactos que debe ser notificado cada vez que hay problemas (o recuperación) con este servicio. Varios contactos deben estar separadas por comas. Útil si desea que las notificaciones se dirige sólo a unas cuantas personas y no desea configurar grupos de contacto o contact groups. Debe especificar al menos un contacto o un grupo en cada definición de la escalada de servicio.

contact_groups:

Esta directiva se utiliza para identificar el nombre abreviado del grupo de contacto o contact group que debe ser notificado cuando el servicio de notificación se debe de escalar. Varios grupos de contacto en caso de estar separados por comas. Debe especificar al menos un contacto o un grupo en cada definición de la escalado de servicio.

notification_interval:

Esta directiva se utiliza para determinar el intervalo en el que las notificaciones deben hacerse al mismo tiempo esta escalada es válido. Si se especifica un valor de 0 en el intervalo, Nagios envía las notificaciones por primera vez cuando esta definición es válida la escalada, pero evitará que más notificaciones del problema sea enviado desde el equipo. Las notificaciones no se envían de nuevo hasta que el anfitrión se recupere. Esto es útil si desea dejar de tener las notificaciones enviadas después de una cierta cantidad de tiempo. Nota: Si una gran cantidad de entradas escalada se superponen en uno o más rangos de notificación, el intervalo más pequeño de la notificación de todas las entradas de la escalada es el que se utiliza.

escalation_period:

Esta directiva se utiliza para especificar el nombre corto del período de tiempo durante el cual esta escalada es válido. Si esta directiva no se especifica, la escalada es considerado como válido durante todo el tiempo.

escalation_options:

Esta directiva se utiliza para definir los criterios que determinan si esta escalada se usa el servicio. La escalada se utiliza sólo si el servicio se encuentra en uno de los estados en la presente Directiva. Si esta directiva no se especifica en una escalada de servicios, la escalada es considerada como válida en todos los estados de servicio. Las opciones válidas son una combinación de uno o más de los siguientes: r = escalar sobre un OK (recuperación) del estado, w = escalar en un estado de advertencia o WARNING, u = escalar en un estado desconocido o UNKNOWN, y c = escalar en un estado CRITICAL. Ejemplo: Si se especifica w en este campo, la escalada sólo se utilizará si el servicio se encuentra en un estado de advertencia.

Definición de dependencia del equipo

Descripción:

Dependencias del equipo son una característica avanzada de Nagios que permiten eliminar las notificaciones de hosts basados en el estado de uno o más hosts. Dependencias de equipo son opcionales y están dirigidos principalmente a usuarios avanzados que han complicado las configuraciones de control. Más información sobre cómo trabajar las dependencias de acogida (leer esto!) Se puede encontrar aquí.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define hostdependency{

dependent_host_name

host_name

dependent_hostgroup_name

hostgroup_name

host_name

host_name

hostgroup_name

hostgroup_name

inherits_parent

[0/1]

execution_failure_criteria

[o,d,u,p,n]

notification_failure_criteria

[o,d,u,p,n]

dependency_period

timeperiod_name

}

Definición de ejemplo:

define hostdependency{

host_name WWW1

dependent_host_name DBASE1

notification_failure_criteria d,u

}

Descripción de las directivas:

dependent_host_name:

Esta directiva se utiliza para identificar el nombre corto (s) del equipo o host a cargo (s). Varios hosts deben estar separadas por comas.

dependent_hostgroup_name:

Esta directiva se utiliza para identificar el nombre corto (s) de la hostgroup dependiente (s). Múltiples Hostgroups deben estar separados por comas. El dependent_hostgroup_name se puede utilizar en lugar de, o además de, la directiva dependent_host_name.

host_name:

Esta directiva se utiliza para identificar el nombre corto (s) de la máquina (s) o host del cual depende (también conocida como la sede principal). Varios hosts deben estar separadas por comas.

hostgroup_name:

Esta directiva se utiliza para identificar el nombre corto (s) de la hostgroup (s) del cual depende (también conocida como la sede principal). Hostgroups múltiples deben estar separados por comas. El hostgroup_name se puede utilizar en lugar de, o además de, la directiva host_name.

inherits_parent:

Esta directiva indica si la dependencia hereda las dependencias del equipo del cual depende (también conocida como la sede principal). En otras palabras, si el equipo maestro depende de otros equipos, y cualquiera de las dependencias falla, esta dependencia también se producirá un error.

execution_failure_criteria:

Esta directiva se utiliza para especificar los criterios que determinan cuando el equipo dependiente no se debe comprobar. Si la máquina principal se encuentra en uno de los estados de error, el chequeo del anfitrión dependiente seleccionado no se activa . Las opciones válidas son una combinación de uno o más de los siguientes (opciones múltiples se separan con comas): o = no en un estado UP, d = no en un estado inactivo, u = no en un estado inalcanzable, y p = no en un estado pendiente (por ejemplo, la máquina aún no ha sido comprobado). Si se especifica n (no) como una opción, la dependencia de la ejecución no se producirá un error y el anfitrión depende siempre de forma activa seleccionada (si las condiciones lo permiten otros para que sea). Ejemplo: Si se especifica u, d en este campo, el anfitrión dependiente no se activa comprobar si el host maestro, ya sea en un estado inalcanzable (UNREACHABLE ) o caído (DOWN)

notification_failure_criteria:

Esta directiva se utiliza para definir los criterios que determinan cuándo las notificaciones para el anfitrión dependiente no debe ser enviado. Si la máquina principal se encuentra en uno de los fracaso de los estados se especifica, las notificaciones para el anfitrión dependientes no se enviará a los contactos. Las opciones válidas son una combinación de uno o más de los siguientes: o = no en un estado UP, d = no en un estado inactivo, u = no en un estado inalcanzable, y p = error en un estado pendiente (por ejemplo, la acogida ha aún no se ha comprobado). Si se especifica n (no) como una opción, la dependencia de la notificación nunca fallan y las notificaciones para el anfitrión depende siempre será enviado. Ejemplo: Si se especifica d en este campo, las notificaciones para el anfitrión dependiente no se enviará si la máquina principal se encuentra en estado DOWN.

dependency_period:

Esta directiva se utiliza para especificar el nombre corto del período de tiempo durante el cual esta dependencia es válido. Si esta directiva no se especifica, la dependencia se considera que es válido durante todo el tiempo.

Definición de escalado de equipo

Descripción:

Escalados de equipo son opcionales y se utilizan para escalar las notificaciones para un host en particular. Más información sobre la forma de notificación de trabajo escaladas se puede encontrar aquí.

Definición del formato:

Nota: Las Directivas en rojo son obligatorios, mientras que los de negro son opcionales.

define hostescalation{

host_name

host_name

hostgroup_name

hostgroup_name

contacts

contacts

contact_groups

contactgroup_name

first_notification

#

last_notification

#

notification_interval

#

escalation_period

timeperiod_name

escalation_options

[d,u,r]

}

Definición de ejemplo:

define hostescalation{

host_name router-34

first_notification 5

last_notification 8

notification_interval 60

contact_groups all-router-admins

}

Descripción de las directivas:

host_name:

Esta directiva se utiliza para identificar el nombre corto del equipo al cual se debe de escalar.

hostgroup_name:

Esta directiva se utiliza para identificar el nombre corto (s) de la hostgroup (s) del grupo al cual el escalado se debe de aplicar. Varios grupos de equipos deben estar separados por comas. Si se utiliza, el escalado se aplicará a todos los hosts que son miembros de la hostgroup especificada (s).

first_notification:

Esta directiva es un número que identifica la primera notificación el cual este escalado es eficaz. Por ejemplo, si establece este valor a 3, este aumento sólo se utilizará si el ordenador está inactivo o inaccesible el tiempo suficiente para una tercera notificación para salir

last_notification:

Esta directiva es un número que identifica a la última notificación por el cual el escalado es eficaz. Por ejemplo, si establece este valor a 5, esta escalada no se utilizará si hay más de cinco notificaciones se envían para el equipo. Al establecer este valor a 0 significa seguir usando esta entrada escalada de siempre (no importa cómo muchas notificaciones de salir).

contacts:

Esta es una lista de los nombres cortos de los contactos al cual debe ser notificado cada vez que hay problemas (o recuperación) con esta máquina. Varios contactos deben estar separadas por comas. Útil si desea que las notificaciones se dirige sólo a unas cuantas personas y no desea configurar grupos de contacto. Debe especificar al menos un contacto o un grupo en cada definición de la escalada de acogida.

contact_groups:

Esta directiva se utiliza para identificar el nombre abreviado del grupo de contacto que debe ser notificado cuando la notificación del equipo requiere de una notificación de escalado. Varios grupos de contacto en caso de estar separados por comas. Debe especificar al menos un contacto o un grupo en cada definición de la escalada del equipo.

notification_interval:

Esta directiva se utiliza para determinar el intervalo en el que las notificaciones deben hacerse al mismo tiempo esta escalada es válido. Si se especifica un valor de 0 en el intervalo, Nagios envíe las notificaciones por primera vez cuando esta definición es válida la escalada, pero evitará que más notificaciones problema de ser enviado para el anfitrión. Las notificaciones se envían de nuevo hasta que el anfitrión se recupere. Esto es útil si desea dejar de tener las notificaciones enviadas después de una cierta cantidad de tiempo. Nota: Si varias entradas escalada de una gran cantidad de superposición de uno o más rangos de la notificación, el intervalo más pequeño de la notificación de todas las entradas de la escalada se utiliza. .

escalation_period:

Esta directiva se utiliza para especificar el nombre corto del período de tiempo durante el cual este escalado es válido. Si esta directiva no se especifica, la escalada es considerado como válido durante todo el tiempo.

escalation_options:

Esta directiva se utiliza para definir los criterios que determinan cuándo este escalado de host se utiliza. El escalado se utiliza sólo si el host se encuentra en uno de los estados en la presente Directiva. Si esta directiva no se especifica en una escalada del equipo, el escalado es considerado como válida en todos los países de acogida. Las opciones válidas son una combinación de uno o más de los siguientes: r = escalar en una UP (recuperación) del estado, d = escalar en un estado inactivo, y u = escalar en un estado inalcanzable. Ejemplo: Si se especifica d en este campo, la escalada sólo se utilizará si el ordenador está en un estado hacia abajo.

Definición de información extendida de equipo

Descripción:

Información extendida de información de equipos se utilizan básicamente para hacer la salida del estado, mapa de estado o statusmap, statuswrl, y CGIs extinfo parecen bastante. No tienen ningún efecto sobre la vigilancia y son completamente opcionales.

Consejo: A partir de Nagios 3.x, todas las directivas contenidas en la información ampliada definiciones de equipos también están disponibles en las definiciones de equipo. Por lo tanto, usted puede elegir para definir las directrices a continuación en las definiciones de su equipo si le parece una configuración más simple. Las informaciones de definiciones extendidas continúan contando con el apoyo para las versiones anteriores

Definición del formato:

Nota: Las variables en rojo son obligatorios, mientras que los de negro son opcionales. Sin embargo, es necesario proporcionar al menos una variable opcional en cada definición para que pueda ser de mucha utilidad.

define hostextinfo{

host_name

host_name

notes

note_string

notes_url

url

action_url

url

icon_image

image_file

icon_image_alt

alt_string

vrml_image

image_file

statusmap_image

image_file

2d_coords

x_coord,y_coord

3d_coords

x_coord,y_coord,z_coord

}

Definición de ejemplo:

define hostextinfo{

host_name netware1

notes This is the primary Netware file server

notes_url http://webserver.localhost.localdomain/hostinfo.pl?host=netware1

icon_image novell40.png

icon_image_alt IntranetWare 4.11

vrml_image novell40.png

statusmap_image novell40.gd2

2d_coords 100,250

3d_coords 100.0,50.0,75.0

}

Descripción de las variables:

host_name:

Esta variable se utiliza para identificar el nombre corto del host que está asociado con los datos.

notes:

Esta directiva se utiliza para definir una cadena opcional de notas relacionadas con el host. Si se especifica una nota aquí, podrás ver el que en el CGI información ampliada (cuando está viendo la información sobre el host)

notes_url:

Esta variable se utiliza para definir una URL opcional que se puede utilizar para proporcionar más información acerca del host. Si se especifica una dirección URL, verás un enlace que dice "Notas Host Extra" en el CGI información ampliada (cuando está viendo la información sobre el host). Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será la misma como lo que se utiliza para acceder a la CGI (es decir, /cgi-bin/nagios/). Esto puede ser muy útil si desea hacer que la información detallada en el host, los métodos de contacto de emergencia, etc a disposición del personal de apoyo.

action_url:

Esta directiva se utiliza para definir una URL opcional que se puede utilizar para ofrecer más acciones a realizar en el host. Si se especifica una dirección URL, verás un enlace que dice "Las acciones Host Extra" en el CGI información ampliada (cuando está viendo la información sobre el host). Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será la misma como lo que se utiliza para acceder a la CGI (es decir, /cgi-bin/nagios//).

icon_image:

Esta variable se utiliza para definir el nombre de una imagen GIF, PNG, JPG o que deben estar asociados con esta máquina. Esta imagen se mostrará en el estado y CGIs información extendida. La imagen se verá mejor si es de 40x40 píxeles. Imágenes para los anfitriones se supone que esta en el el subdirectorio /logos en el directorio de imágenes en HTML (es decir, /usr/local/nagios/share/images/logos)

icon_image_alt:

Esta variable se utiliza para definir una cadena opcional que se utiliza en la etiqueta ALT de la imagen especificada por el argumento . La etiqueta ALT se utiliza en el estado, la información ampliada y CGIs statusmap.

vrml_image:

Esta variable se utiliza para definir el nombre de una imagen GIF, PNG, JPG o que deben estar asociados con esta máquina. Esta imagen se utilizará como el mapa de textura para el host especificado en el CGI statuswrl. A diferencia de la imagen que el uso de la variable , éste probablemente no debería tener ninguna transparencia. Si lo hace, el objeto host se verá un poco raro. Imágenes para los anfitriones se supone que en el logos / subdirectorio en el directorio de imágenes en HTML (es decir, /usr/local/nagios/share/images/logos).

statusmap_image:

Esta variable se utiliza para definir el nombre de una imagen que debe estar asociado con esta máquina en el CGI statusmap. Puede especificar una imagen JPEG, PNG, GIF y si quieres, aunque me gustaría sugerir fuertemente con una imagen en formato GD2, como otros formatos de imagen resultará en una gran cantidad de tiempo de CPU pierde cuando la imagen se genera statusmap. GD2 se pueden crear imágenes a partir de imágenes PNG con la utilidad pngtogd2 suministrado con la biblioteca de Thomas Boutell de Di-s. El GD2 imágenes deben ser creados en formato sin comprimir con el fin de minimizar la carga de la CPU cuando el CGI statusmap está generando la imagen del mapa de la red. La imagen se verá mejor si es de 40x40 píxeles. Puede dejar estos opción en blanco si no está utilizando el CGI statusmap. Imágenes para los anfitriones se supone que en el logos / subdirectorio en el directorio de imágenes en HTML (es decir, /usr/local/nagios/share/images/logos).

2d_coords:

Esta variable se utiliza para definir las coordenadas a utilizar en la elaboración de la acogida en el CGI statusmap. Coordenadas deben ser dados por números enteros positivos, ya que corresponden a los píxeles de física en la imagen generada. El origen de la elaboración (0,0) se encuentra en la esquina superior izquierda de la imagen y se extiende en la dirección positiva (a la derecha) en la parte superior de la imagen y en la dirección positiva (hacia abajo) a lo largo de la mano izquierda lado de la imagen. Para referencia, el tamaño de los iconos elaborados suele ser de unos 40x40 píxeles (el texto toma un poco más de espacio). Las coordenadas que especifique aquí son de la esquina superior izquierda del icono de host que se dibuja. Nota: No se preocupe por lo que las coordenadas x e y máximo que puede utilizar son. El CGI calculará automáticamente las dimensiones máximas de la imagen se crea sobre la base de la más grande de coordenadas X e Y que usted especifique.

3d_coords:

Esta variable se utiliza para definir las coordenadas a utilizar en la elaboración de la acogida en el CGI statuswrl. Las coordenadas pueden ser números reales positivos o negativos. El origen de dibujo (0.0,0.0,0.0). Como referencia, el tamaño de los cubos de acogida elaborado es de 0,5 unidades en cada lado (texto tiene un poco más espacio). Las coordenadas que especifique aquí se utilizan como el centro del cubo de acogida

Información ampliación de la Definición de Servicio

Descripción:

Información extendida de entradas de servicio se utilizan básicamente para hacer la salida de la situación y CGIs extinfo parecen bastante. No tienen ningún efecto sobre la vigilancia y son completamente opcionales.

Consejo: A partir de Nagios 3.x, todas las directivas contenidas en las informaciones de definiciones de servicio extendido también están disponibles en las definiciones de servicio. Por lo tanto, usted puede elegir para definir las directrices a continuación en las definiciones de servicio si se hace la configuración más simple. Las definiciones extendidas de servicios seguirán siendo compatible en las versiones anteriores.

Definición del formato:

Nota: Las variables en rojo son obligatorios, mientras que los de negro son opcionales. Sin embargo, es necesario proporcionar al menos una variable opcional en cada definición para que pueda ser de mucha utilidad.

define serviceextinfo{

host_name

host_name

service_description

service_description

notes

note_string

notes_url

url

action_url

url

icon_image

image_file

icon_image_alt

alt_string

}

Definición de ejemplo:

define serviceextinfo{

host_name linux2

service_description Log Anomalies

notes Security-related log anomalies on secondary Linux server

notes_url http://webserver.localhost.localdomain/serviceinfo.pl?host=linux2&service=Log+Anomalies

icon_image security.png

icon_image_alt Security-Related Alerts

}

Descripción de las variables:

host_name:

Esta directiva se utiliza para identificar el nombre corto del host que el servicio está asociado.

service_Descripción:

Esta directiva es la descripción del servicio que se asocia con los datos.

notes:

Esta directiva se utiliza para definir una cadena opcional de notas relacionadas con el servicio. Si se especifica una nota aquí, podrás ver el que en el CGI información ampliada (cuando está viendo la información sobre el servicio especificado).

notes_url:

Esta directiva se utiliza para definir una URL opcional que se puede utilizar para proporcionar más información sobre el servicio. Si se especifica una dirección URL, verás un enlace que dice "Notas de servicio adicional" en el CGI información ampliada (cuando está viendo la información sobre el servicio especificado). Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será la misma como lo que se utiliza para acceder a la CGI (es decir, /cgi-bin/nagios/). Esto puede ser muy útil si desea hacer que la información detallada sobre el servicio, los métodos de contacto de emergencia, etc a disposición del personal de apoyo

action_url:

Esta directiva se utiliza para definir una URL opcional que se puede utilizar para ofrecer más acciones a realizar en el servicio. Si se especifica una dirección URL, verás un enlace que dice "Acciones de servicio adicional" en el CGI información ampliada (cuando está viendo la información sobre el servicio especificado). Cualquier URL válida se puede utilizar. Si usted planea usar rutas relativas, la ruta de la base será la misma como lo que se utiliza para acceder a la CGI (es decir, / cgi-bin/nagios /).

icon_image:

Esta variable se utiliza para definir el nombre de una imagen GIF, PNG, JPG o que deben estar asociados con esta máquina. Esta imagen se mostrará en el estado y CGIs información extendida. La imagen se verá mejor si es de 40x40 píxeles. Imágenes para los anfitriones se supone que en el logos / subdirectorio en el directorio de imágenes en HTML (es decir, /usr/local/nagios/share/images/logos)..

icon_image_alt:

Esta variable se utiliza para definir una cadena opcional que se utiliza en la etiqueta ALT de la imagen especificada por el argumento . La etiqueta ALT se utiliza en el estado, la información ampliada y CGIs statusmap.

Lista de traducciones pendientes

2011-06-01T19:08:00.000-07:00

1.-About
1.1 What is Nagios Core? (TRADUCIDO POR Israel Ochoa)
1.2 System requirements (TRADUCIDO POR Israel Ochoa)
1.3 Licensing (TRADUCIDO POR Israel Ochoa)
1.4 Downloading the latest version(TRADUCIDO POR Israel Ochoa)

2.-Release Notes
2.1 What's new in this version (PENDIENTE DE TRADUCCION)
2.2 Known issues (PENDIENTE DE TRADUCCION)

3.- Support
3.1 Nagios Library - Nagios tips, tutorials, documentation, and
manuals (PENDIENTE DE TRADUCCION)
3.2 Support Forum - Community and customer Nagios support forum
(PENDIENTE DE TRADUCCION)
3.3 More Options - Community and commercial support options
(PENDIENTE DE TRADUCCION)

4.-Getting Started
4.1-Advice for beginners(TRADUCIDO POR Israel Ochoa)
4.2 Quickstart installation guide (TRADUCIDO POR Israel Ochoa)
4.3 Upgrading from previous versions(TRADUCIDO POR Israel Ochoa)
4.4 How to monitor a Windows machine (TRADUCIDO POR Israel Ochoa)
4.5 How to monitor a Linux/Unix machine (TRADUCIDO POR Israel Ochoa)
4.6 How to monitor a Netware server (TRADUCIDO POR Israel Ochoa)
4.7 How to monitor a network printer (TRADUCIDO POR Israel Ochoa)
4.8 How to monitor a router/switch (TRADUCIDO POR Israel Ochoa)
4.9 How to monitor a publicly available service (HTTP, FTP, SSH, etc.)
(TRADUCIDO POR Israel Ochoa)

5 Configuring Nagios
5.1 Configuration overview (TRADUCIDO POR Israel Ochoa)
5.2 Main configuration file options (EN TRADUCCION POR Israel Ochoa)
5.3 Object configuration overview (TRADUCIDO POR David Perez - En Revision)
5.4 Object definitions (TRADUCIDO POR David Perez)
5.5 CGI configuration file options (PENDIENTE DE TRADUCCION)
5.6 Configuring authorization for the CGIs(PENDIENTE DE TRADUCCION)

6.-Running Nagios
6.1 Verifying your configuration (PENDIENTE DE TRADUCCION)
6.2 Starting and stopping Nagios(PENDIENTE DE TRADUCCION)

7 The Basics
7.1 Plugins (PENDIENTE DE TRADUCCION)
7.2 Macros and how they work (PENDIENTE DE TRADUCCION)
7.3 Standard macros available in Nagios (PENDIENTE DE TRADUCCION)
7.4 Host checks (PENDIENTE DE TRADUCCION)
7.5 Service checks (PENDIENTE DE TRADUCCION)
7.6 Active checks (PENDIENTE DE TRADUCCION)
7.7 Passive checks (PENDIENTE DE TRADUCCION)
7.8 State types (PENDIENTE DE TRADUCCION)
7.9 Time periods (PENDIENTE DE TRADUCCION)
7.10 Determining status and reachability of network hosts(PENDIENTE DE
TRADUCCION)
7.11 Notifications (PENDIENTE DE TRADUCCION)
7.12 Information on the CGIs(PENDIENTE DE TRADUCCION)

8 Advanced Topics
8.1 External commands (PENDIENTE DE TRADUCCION)
8.2 Event handlers (PENDIENTE DE TRADUCCION)
8.3 Volatile services (PENDIENTE DE TRADUCCION)
8.4 Service and host result freshness checks (PENDIENTE DE TRADUCCION)
8.5 Distributed monitoring (PENDIENTE DE TRADUCCION)
8.6 Redundant and failover monitoring (PENDIENTE DE TRADUCCION)
8.7 Detection and handling of state flapping (PENDIENTE DE TRADUCCION)
8.8 Notification escalations (PENDIENTE DE TRADUCCION)
8.9 On-call notification rotations (PENDIENTE DE TRADUCCION)
8.10 Monitoring service and host clusters (PENDIENTE DE TRADUCCION)
8.11 Host and service dependencies (PENDIENTE DE TRADUCCION)
8.12 State stalking (PENDIENTE DE TRADUCCION)
8.13 Performance data (PENDIENTE DE TRADUCCION)
8.14 Scheduled host and service downtime (PENDIENTE DE TRADUCCION)
8.15 Using the embedded Perl interpreter (PENDIENTE DE TRADUCCION)
8.16 Adaptive monitoring (PENDIENTE DE TRADUCCION)
8.17 Predictive dependency checks (PENDIENTE DE TRADUCCION)
8.18 Cached checks (PENDIENTE DE TRADUCCION)
8.19 Passive host state translation (PENDIENTE DE TRADUCCION)
8.20 Check scheduling (PENDIENTE DE TRADUCCION)
8.21 Custom CGI headers and footers(PENDIENTE DE TRADUCCION)

9 Object inheritance
9.1 Time-saving tips for object definitions(PENDIENTE DE TRADUCCION)

10 Security and Performance Tuning
10.1 Security considerations (PENDIENTE DE TRADUCCION)
10.2 Enhanced CGI security and authentication (PENDIENTE DE
TRADUCCION)
10.3 Tuning Nagios for maximum performance (PENDIENTE DE TRADUCCION)
10.4 Fast startup options (PENDIENTE DE TRADUCCION)
10.5 Large installation tweaks (PENDIENTE DE TRADUCCION)
10.6 Using the nagiostats utility (PENDIENTE DE TRADUCCION)
10.7 Graphing Nagios performance statistics(PENDIENTE DE TRADUCCION)

11 Integration With Other Software
11.1 Integration Overview (PENDIENTE DE TRADUCCION)
11.2 SNMP Traps (PENDIENTE DE TRADUCCION)
11.3 TCP Wrappers(PENDIENTE DE TRADUCCION)

12 Nagios Addons
12.1 NRPE (PENDIENTE DE TRADUCCION)
12.2 NSCA (PENDIENTE DE TRADUCCION)
12.3 NDOUtils (PENDIENTE DE TRADUCCION)
12.4 Other addons (PENDIENTE DE TRADUCCION)
12.5 Nagios Exchange(PENDIENTE DE TRADUCCION)

13 Development
13.1 Plugin API (PENDIENTE DE TRADUCCION)
13.2 Developing Plugins For Use With Embedded Perl(PENDIENTE DE
TRADUCCION)

Traduccion masiva

2011-06-01T19:06:00.000-07:00

David Perez miembro del Grupo de Usuarios de Nagios en Español ha iniciado la colaboracion en la traduccion de la documentacion del sitio oficial de Nagios , nos basamos en esa lista y en la documentacion ya traducida por su servidor

Gracias a David tenemos una lista de traducciones pendientes

Por el momento lo estamos manejando de esta forma, cada quien toma un tema, lo traduce y me lo envia para su revision y formato, de ahi se sube a la pagina dando credito al traductor, estas revisiones y adiciones a la pagina se realizaran semanalmente dependiendo de la documentacion recibida.

Todo esto despues se piensa poner en alguna pagina con una lectura mas amigable.

Si deseas colaborar puedes entrar al Grupo.

Gracias a todos y saludos
Israel

Documentos aportados por la comunidad

2011-05-04T12:03:00.000-07:00

Instalación del Addon NDOUTILS para Nagios sobre Ubuntu 9.04 - Daniel Dueñas.
Instalar check_esx3.pl para nagios sobre ubuntu 9.04 (Monitorización de ESX, ESXI, VCENTER ) - Daniel Dueñas
El Aquel de Aquellar por Dani - Varios posts sobre Nagios.
Monitorizar en Nagios con un script propio a través de NSCLIENt++ - Mónica Boto

How to de Nagios versión 2.x (Legacy)

2011-05-04T11:55:00.000-07:00

Instalando Nagios 2.x

Configurando Nagios 2.x

Mapas y configuración adicional

Audio en Nagios

APAN

SNMP

NRPE

External Command File

Cambios en el Sitio

2011-05-04T11:48:00.000-07:00

Pues le di un poco de "housekeeping" al sitio, si ya se, lo tenia un poco en el olvido.

Acomode mejor la información acorde a lo que existe en el sitio oficial de Nagios, a su vez ingrese la guía rápida para instalar el V-Shell y un apartado para documentación aportada por la comunidad.

El Nagios Team a puesto a disposición de la comunidad la UI (User Interface) V-Shell desarrollada en PHP para Nagios Core desde finales de Noviembre del 2010 (un poco tarde pero seguro).

El Quickstart ya esta en español en este sitio [Introducción a Nagios V-Shell]

Si tienes algun manual, tutorial, etc. que quieras compartir con la comunidad utiliza el Grupo de Usuario de Nagios en Español y lo subire a este sitio, ya sea un enlace un documento, etc...

Saludos!.

Documentación 3.x en Español

2011-05-04T11:40:00.000-07:00

Acerca de

Notas de Release

¿Qué es lo nuevo en esta versión?

Soporte

Opciones de Soporte

Iniciando

Configurando Nagios

Nagios - Introducción a Nagios V-Shell

2011-05-04T11:32:00.000-07:00

Introducción

Este documento describe como instalar y configurar el Nagios V-Shell o Shell "Visual" para instalaciones de Nagios Core y Nagios XI.

Audiencia

Este documento es para uso de administradores de Nagios XI y Nagios Core y asume que Nagios Core esta instalado en el sistema.

Información General

El Nagios V-Shell es una interfáz WEB escrita en PHP que fue diseñada para interpretarse como XHTML válido y ser totalmente formateada y estilizada usando clases CSS mientras se mantiene el poder de Nagios Core para ejecutar comandos de sistema y nodos.

Instalación

Antes de instalar: Usted necesita conocer la ubicación del directorio con la configuración de Apache donde su archivo nagios.conf esta localizado, así como el archivo htpasswd.users que contiene sus autorizaciones para Nagios Core. Estos archivos se pueden localizar con el siguiente comando:

locate

Para descargar e instalar, haga login en su servidor Nagios y escriba los siguientes comandos en la linea de comandos:

cd /tmp
wget http://assets.nagios.com/downloads/exchange/nagiosvshell/vshell.tar.gz
tar zxf vshell.tar.gz
cd vshell
mkdir /usr/local/vshell
cp -r * /usr/local/vshell

Para configurar su Apache, modifique el contenido del archivo vshell.conf para igualar la estructura de directorios de su distribución y de su instalación de Nagios. Use un editor de texto para modificar este archivo, despues copie este archivo al mismo directorio donde esta su archivo nagios.conf

Nagios V-Shell asume el uso de "Apache Basic Authentication" para determinar el nombre de usuario. Si usted esta utilizando otros metodos de autenticación usted necesita modificar la línea 60 en el archivo vshell/index.php y asignarle a la variable "$username" su usuario de administrador.

Constantes de V-Shell

Para configuraciones personalizadas con Apache, los cambios se necesitan realizar en el archivo /vshell/constants.inc.php el cual contiene las variables para la URL de V-Shell asi como los CGIs de Nagios Core.

Nota Importante: V-Shell asume que su instalación de Nagios Core puede ser accesada a traves de http:///nagios. Si su configuración difiere de esto, realice los cambios apropiados en el archivo constants.inc.php. Si un error ocurre en la instalación, verifique que las constantes apuntan correctamente a las URLs web. Futuras versiones incluiran un archivo de configuración por separado y la posibilidad de un "wizard" que verifique la configuración del sistema.

A Comenzar!

Nagios V-Shell toma la información de autenticación del archivo existente de Nagios htpasswd.users así como del archivo de Nagios Core cgi.cfg. La mayoría de los permisos para Nagios Core deberan de estar reflejados en Nagios V-Shell. Para comenzar, inicie sesión en su servidor Nagios en http:///vshell e ingrese la información de autenticación de su Nagios Core.

V-Shell mantiene la mayoría de las características de Nagios Core, mientras utiliza una barra de menu en la parte superior para la navegación del sitio. Esto fue realizado para maximizar el espacio para ver la tabla de equipos y servicios.

Comandos de sistema, reportes e interfáz del Core de Nagios pueden ser accesados directamente desde los enlaces en V-Shell (Links).

Actualmente las tablas de equipos y servicios estan estilizadas para ser familiares a aquellos que estan acostumbrados a Nagios Core, pero el "look and feel" de V-Shell puede ser fácilmente cambiado modificando una sola hoja de estilo CSS, ya que los estilos estan basados en IDs y clases y no hay estilos "in-line" en V-Shell.

Las páginas de grupos de equipos y servicios pueden consolidarse en una sola vista expandible. La página carga tablas de resumen para cada grupo con la opción de cambiar los detalles de los grupos a la vista "grid"

Las páginas de detalles de equipos y servicios son modeladas después de Nagios Core y pueden direccionar a los enlaces de los CGIs de Core para ingresar comandos para equipo y servicio. Los comandos todavia toman algunos momentos para ser procesados y la página necesita ser cargada de nuevo para que el nuevo comando aparezca en pantalla.

Mejoras Futuras

Como es algo nuevo, V-Shell actualmente no soporta cada una de las características de Nagios Core, pero en futuras versiones incluira más características como habilidades de paginación, mejoras en rendimiento y configuraciones de permisos más complejas. Si esta usted interesado en contribuir a Nagios V-Shell por favor entre a http://nagios.org/contribute para mayor información.

Formas de Soporte y Discusión

Para sugerir ideas, ingresar parches u obtener ayuda con Nagios V-Shell visite el foro de soporte de Nagios en:
http://support.nagios.com/forum/viewforum.php?f=19
O puedes ingresar tus dudas en el Grupo de Nagios en Español de este mismo sitio.

Video de instalación [http://assets.nagios.com/downloads/nagioscore/videos/vshell/vshell.html]

Instalación del Addon NDOUTILS para Nagios sobre Ubuntu 9.04

2011-05-04T09:52:00.000-07:00

Daniel Dueñas aka Poseidon a creado un tutorial muy bueno sobre NDOUtils.
El tutorial lo pueden encontrar aquí

Gracias Daniel por este aporte a la comunidad Nagios en Español.

Nagios Core 3.2.2

2010-09-02T11:08:00.000-07:00

Este post es para comunicarles que ya pueden descargar la versión 3.2.2 de Nagios Core aquí, la cual tiene varios fixes, pueden verlos aquí.

Saludos!

Nagios Plugins 1.4.15

2010-07-29T15:57:00.000-07:00

Pues recien salidos del horno los plugins para Nagios, versión 1.4.15, pueden ver el anuncio oficial aquí.

Saludos!

Nagios Seed Camp

2010-06-03T16:45:00.000-07:00

¿Eres programador? y ¿te gusta Nagios como plataforma de monitoreo de redes?...

Si ambas preguntas son un rotundo SI, sigue leyendo para que te puedas beneficiar en efectivo.

El equipo de Nagios lanzo un concurso llamado Nagios Seedcamp:

We're pleased to announce the launch of Nagios Seedcamp - a development contest designed to spur innovation in the Nagios Community. Participants in Nagios Seedcamp will have an opportunity to win cash prizes up to $1,000 USD. Scratch your itch, develop some code, and make a run for the cash. Learn more about Nagios Seedcamp at www.nagios.org/seedcamp

Basicamente estan invitando a mejorar este sistema y en el proceso te llevaras premios en efectivo de hasta 1,000 dolares!

Por lo cual no esperes mas, puedes entrar a Seedcamp para registrarte y empezar a desarrollar tu mejora para Nagios.

Grupo de Nagios en Español

2010-04-07T09:11:00.000-07:00

Ultimamente ha habido actividad en la lista de correo del grupo de Nagios en Español resolviendo algunas dudas y eso es bueno, en este momento le estoy dando una revisada a la documentación traducida al español para continuar con la misma, ya que falta demasiada documentación por traducir.

Si tienen alguna duda respecto a Nagios pueden ingresarla en el Grupo de Usuarios de Nagios en Español

Saludos!
IO

Nagios 3.2.1

2010-03-22T11:12:00.000-07:00

Tarde pero seguro, salio la nueva versión de Nagios con algunas improvisaciones.

Nagios 3.2.1

Saludos!

Nagios XI Download

2009-11-19T14:47:00.000-08:00

Pues me acaba de llegar un correo de sales en nagios.com para confirmarme que fui seleccionado para probar el nuevo Nagios XI (yeah!), despues enviaran la información para poder bajar el paquete y como todo buen tester enviar el feedback sobre su producto.

Entonces estamos a la espera...

Ethan Galstad in Pauldotcom Podcast

2009-11-13T13:13:00.000-08:00

Interview: Ethan Galstad says Nagios Ain't Gonna Insist On Sainthood

Esta entrevista salio la semana pasada y no la habia escuchado debido a que estaba un poco ocupado con una auditoria PCI DSS.

Pues en esta entrevista le hacen varias preguntas muy interesantes a Ethan, pero las dos que mas me gustaron fueron estas:

Drink Team:

Paul - Why you created Nagios?
Ethan - Because I wanted to be in those meeting drinks instead...
Paul - So wait a minute, are you telling me that you created Nagios so you can drink beer?
Ethan - This is a simple fact...
All- YEAH!! clap clap...

Y la otra de que pensaba Ethan de la modificaciones de Nagios que existen, lo cual comento que no tiene ningun problema por las integraciones con otros paquetes, modificaciones que se le hagan al software, es una persona muy sencilla y flexible.

Tienen que escuchar el podcast en caso de que quieran conocer un poco mas a Ethan.

Saludos!

Tips para Troubleshooting en Nagios

2009-10-30T13:58:00.000-07:00

Bueno, este es uno de los primeros "tips" para realizar un buen troubleshooting en Nagios.

Comenzaremos en como detectar que nuestros plugins realmente estan haciendo lo que se supone deben hacer, ya que en Nagios nos puede aparecer algún resultado como Unknown.

Vamos a poner un ejemplo en el caso de SNMP, sabemos que el equipo que estamos monitoreando tiene habilitado SNMP y solamente permite al servidor Nagios realizar estas peticiones, pero cuando agregamos el servicio SNMP para monitorear X OID nos aparece en estado Unknown y comunmente recibimos el mensaje de:

SNMP problem - No data received from host

Ahora implementando el tip tenemos que ejecutar el comando desde nuestra shell, comenzando con snmpget, para esto digamos que escribimos el OID mib-2.33.1.1.5.0:

$/usr/bin/snmpget -t 1 -r 5 -m ALL -v 1 -c MiComunidadRO 192.168.1.100:161 mib-2.33.1.1.5.0
Error in packet
Reason: (noSuchName) There is no such variable name in this MIB.
Failed object: SNMPv2-SMI::mib-2.33.1.1.5.0

Damn!, nos aparece un error, el MIB del equipo monitoreado no reconoce el OID que le enviamos, pero ya nos dimos cuenta que la comunicación SNMP si esta funcionado.
Ahora enviamos el siguiente comando:

$/usr/bin/snmpget -t 1 -r 5 -m ALL -v 1 -c MiComunidadRO 192.168.1.100:161 1.3.6.1.2.1.1.3.0
DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (246586176) 28 days, 12:57:41.76

Yeah!, funciono, estamos recibiendo información correcta (SYSUPTIME).
Ahora vamos a probar nuestro plugin de check_snmp:

$./check_snmp -C MiComunidadRO -H 192.168.1.100 -o 1.3.6.1.2.1.1.3.0
SNMP OK - Timeticks: (246705486) 28 days, 13:17:34.86

Funciono correctamente.

Entonces ya nos dimos cuenta que todo esta funcionando sin problemas excepto por la primer OID que definimos mib-2.33.1.1.5.0 (causa de la falla).

Lección aprendida
Si definimos primero el servicio en Nagios y un servicio nos aparece un estado Unknown o que no recibe información, hay que dirigirnos al shell para empezar el troubleshooting, comenzando con el comando definido dentro del plugin y despues con el plugin, solo para asegurarnos de que todo esta funcionando correctamente, de esta forma es más fácil detectar alguna falla.

Saludos!

NagiosEs Google Group

2009-10-29T12:31:00.000-07:00

Este post es para informarles que esta funcionando muy bien el grupo de usuarios de nagioses, habia un gadget para este tipos de blog en el cual podias conectar un grupo de google con tu blog, pero al parecer ya no existe.

Asi que si tienen dudas, documentación que deseen compartir, tips, etc., el grupo esta ahi para eso.

Saludos!

Nagios XI

2009-10-28T10:44:00.000-07:00

Me llego un correo de Nagios Enterprises en el cual estan dando la noticia de que van a sacar al mercado un Nagios Enhanced (Mejorado) llamado Nagios XI.

We're pleased to announce the upcoming availability of Nagios XI™ - a powerful new IT infrastructure monitoring solution for today's demanding organizational requirements.

Based on proven, enterprise-class Open Source components, XI is the result of several projects we've undertaken to meet a variety of client requirements. Designed for scalability and flexibility, XI is designed to make problematic IT monitoring tasks simple.

We took care to design XI from the ground up with a powerful architecture that provides organizations with flexibility for the future. And we know good architecture when we see it. We designed Nagios Core with an extendable architecture that spurred a decade of innovation and industry disruption. We're doing the same with XI to usher in a new era of innovation.

Value-Added Benefits

XI SplashGoing beyond basic IT monitoring capabilities, Nagios XI is an enterprise-class solution that provides organizations with extended insight of their IT infrastructure before problems affect critical business processes. Nagios XI provides several value-added benefits over a standard Nagios Core installation, including:

* Resigned User Interface
* Dashboards
* Views
* Native Performance Graphing
* Database Backend and APIs
* Web configuration GUI
* Configuration Wizards
* Advanced User Management
* Non-Stop Operations Manager
* Extendable Architecture

Ya me registre para ser un beta tester de esta aplicación y ver las mejoras que trae.
Saludos!

Nagios Plugins 1.4.14 Released

2009-09-30T13:06:00.000-07:00

Pues si, el día de hoy salio la nueva version de los plugins de Nagios los cuales podrán bajar aquí

Saludos!

MNTOS (Multi Nagios Tactical Overview System)

2009-08-25T13:44:00.000-07:00

El otra vez me estaba dando una vuelta por el nagiosexchange.org el cual paso a ser Monitoring Exchange buscando que habia de nuevo y me encontre con esta aplicación MNTOS (Multi Nagios Tactical Overview System), el cual básicamente es para que podamos ver el status de varios sistemas Nagios en una especie de Dashboard.
Les recomiendo bajen el software desde la página del autor.
Realmente es sencillo implementarlo, despues de configurarlo adecuadamente tendran una página como esta:

Nagios Core 3.2.0

2009-08-18T09:53:00.000-07:00

Pues ya salio la nueva versión de Nagios en la cual el unico cambio es que ya no se llamara Nagios la interfaz WEB ni el daemon si no que pasan a llamarse Nagios Core.

[Bajar Nagios Core 3.2.0]

Nagios 3.1.2 Release!

2009-06-24T09:18:00.000-07:00

Ya esta aquí la versión 3.1.2 de Nagios.

Anterior a esta salio una version 3.1.1 en la cual se corregian varios problemas de seguridad y funcionamiento, pero en la 3.1.2 que salio casi inmediatamente se corrige un problema con CPU Hogging, esto quiere decir que Nagios se apropiaba de toda la carga del CPU pero ya esta esta corregido en esta nueva versión.

Enjoy!

Reestructuración y revisión del blog

2009-06-10T12:29:00.000-07:00

El blog lo tenia un poco (¿poco?!) desordenado, algunos links estaban rotos en varias entradas, pero hoy me dedique a ordenar todo de una forma más amigable.
Todavia van a ver algunos links que no estan funcionando en la parte de la documentación de la versión 3.x, esto es por que todavia no termino de traducir esa parte de la documentación (es un #$%... monton).

Saludos!

Aviso para principiantes

2009-06-10T11:08:00.001-07:00

!Felicidades por escoger Nagios¡, Nagios es poderoso y flexible, pero requiere un poco de esfuerzo para configurarlo la manera que a usted le guste. Una vez que usted se familiarize con el, vea como funciona y que es lo que puede hacer por usted, usted nunca dejara de trabajar con el. :-) Aquí hay algunas cosas importantes que se debe de tener en mente para usuarios primerizos de Nagios:

Relajese - va a tomar algo de tiempo. No espere que las cosas esten funcionando exactamente como usted lo desea inmediatamente. no es asi de fácil. Configurar Nagios requiere un poco de trabajo - en parte por las opciones que Nagios ofrece, en parte por que usted necesita saber que va a monitorear de su red (y como es la mejor forma de hacerlo).
Utilice las opciones de inicio rápido. Las guías de instalación rápida estan diseñadas para que los nuevos usuarios tengan arriba y ejecutandose a Nagios con una configuración básica de una forma rápida. En menos de 20 minutos usted puede tener a Nagios instalado y monitoreando el sistema local. Una vez completado, usted puede aprender a como configurar Nagios a fondo para hacer más.
Lea la documentación. Nagios puede ser "mañoso" al configurarlo si usted solo tiene una idea de lo que esta pasando, y casi imposible si usted no lo sabe. Asegurese de leer la documentación (particularmente las secciones de "Configurando Nagios" y "Lo básico"). Guarde los temas avanzados para cuando usted ya entienda muy bien lo básico.
Busque ayuda con los demás. Si usted leyó la documentación, reviso los archivos de configuración de ejemplo y aun así tiene problemas, envie un mensaje a la lista de correo nagios-users describiendo su problema (En este caso en el grupo de Nagios en Español de este sitio).

Descripción General de Configuración

2009-06-08T13:38:00.000-07:00

Introducción

Hay varios archivos de configuración que usted va a necesitar crear o editar antes de empezar a monitorear algo. Sea paciente! Configurar Nagios puede tomar un poco de tiempo, especialmente si es usuario por primera vez. Una vez que se de cuenta de como funcionan las cosas, habra valido la pena tdo su tiempo invertido. :-)

Nota: Los archivos de configuración de ejemplo son instalados en el directorio /usr/local/nagios/etc/ cuando usted sigue la guía de instalación rápida.

Archivo de Configuración Principal

El archivo de configuración principal contiene directivas que pueden afectar el como el "daemon" de Nagios opera. Este archivo de configuración es leido por el Nagios "daemon" y los CGIs. Aquí es donde usted deseara empezar con sus aventuras de configuración.

La Documentación del archivo de configuración principal puede ser encontrada aquí.

Archivo(s) de Recursos (Resource File(s))

Los archivos de recursos son utilizados para guardar macros definidas por el usuario. El punto principal de tener los archivos de recursos es para utilizarlos para guardar información de configuración sensible (como contraseñas), sin ponerlos disponibles en los CGIs.

Usted puede especificar uno o más archivos de recursos utilizando la directiva resource_file en el archivo de configuración principal.

Archivos de Definición de Objetos

Los archivos de definición de objetos son utilizados para definir equipos, servicios, grupos de equipos, contactos, grupos de contactos, comandos, etc. Aquí es donde usted define todo lo que desee monitorear y como lo va a monitorear.

Usted puede especificar uno o más archivos de definición de objetos utilizando las directivas cfg_file y/o cfg_dir en su archivo de configuración principal.

Una introducción a la definición de objetos y como se pueden relacionar entre si puede ser encontrado aquí.

Archivo de Configuración CGI

El archivo de configuración CGI contiene un número de directivas que afectan la operación de los CGIs. También contiene una referencia al archivo de configuración principal, por lo cual los CGIs conocen como está su configuración de Nagios y donde estan guardadas las definiciones de objetos.

Documentación para la configuración del archivo CGI puede ser localizada aquí.

Reestructuración de Nagios Exchange

2009-06-08T13:14:00.000-07:00

Bueno, ya tenia rato que no posteaba algo aquí, en esta ocasión es sobre la nueva página de Nagios Exchange y Nagios Wiki (antes Nagios Community Wiki).

Pasen a estos sitios para que se den una vuelta y vean que ahora estan más "limpios" en diseño y de fácil navegación.

Saludos!

Instalar Centreon 2.0.1 en CentOS 5.3

2009-04-15T09:56:00.000-07:00

Centreon es el software de monitoreo de mayor flexibilidad y desempeño bajo la licencia GPL.

Pensada para todo tipo de usuarios, Centreon cumple con los indicadores de sistemas, redes y aplicaciones.

Centreon tiene funciones que son esenciales para el monitoreo de infraestructuras críticas.

Siendo modular, puede evolucionar dependiendo de sus necesidades permitiendo esto extender su funcionabilidad

Primero instalamos los paquetes siguientes:

Perl RRDtool
http://dag.wieers.com/rpm/packages/rrdtool/perl-rrdtool-1.2.23-1.el5.rf.i386.rpm

RRDtool Devel
http://dag.wieers.com/rpm/packages/rrdtool/rrdtool-devel-1.2.23-1.el5.rf.i386.rpm

RRDtool
http://dag.wieers.com/rpm/packages/rrdtool/rrdtool-1.2.23-1.el5.rf.i386.rpm

NDOUtils
http://packages.sw.be/ndoutils/ndoutils-1.4-0.beta7.3.el5.rf.i386.rpm

rpm -ivh --nodeps

Creamos un symlink a ndomod-3x-o

ln -s /usr/libexec/ndomod-3x.o /usr/sbin/ndomod.o

Actualizamos PEAR

pear upgrade --force pear

Instalamos PHP-GD

yum install -y php-gd

Instalamos PHP-SNMP

yum install -y php-snmp

Despues instalamos Centreon

./install.sh -i

Solamente contestamos todo y verificamos que las rutas sean las correctas.

Iniciamos centcore, centstorage and ndoutils.

/sbin/service centcore start
/sbin/service centstorage start
/sbin/service ndoutils start

Despues podemos accesar a:

http://ipofcentreonserver/centreon/

Throubleshooting...

Reseting root password in MySQL

# Stop the mysqld daemon process.
# Start the mysqld daemon process with the --skip-grant-tables option.
(mysqld-safe --skip-grant-tables)
# Start the mysql client with the -u root option.
# Execute the UPDATE mysql.user SET Password=PASSWORD('password') WHERE User='root';
# Execute the FLUSH PRIVILEGES; command

Nagios/Centreon - by Felipe Ferreira
http://felipeferreira.net/?p=59

Errores con ndo.sock
Si paramos el servicio de ndoutils, lo deseamos volver a iniciar y nos aparece el error:

Could not bind socket: Address already in use

Solo removemos el archivo ndo.sock

rm -vfr /ruta/donde/esta/ndo.sock

Y volvemos a iniciar ndoutils normalmente.

Instalar Nagios 2.7 en Ubuntu - Por RonyWorld2005

2009-04-13T14:53:00.000-07:00

Instalar Nagios 2.7 en Ubuntu

Paso 1: Instalar el compilador de C

# apt-get install gcc make sudo g++

Paso 2: Descargar Nagios 2.7 de la página del proyecto http://nagios.org
Paso 3: Descomprimir el archivo nagios-2.7.tar.gz de la siguiente manera:

# tar xvzf nagios-2.7.tar.gz

Paso 4: Luego ingresamos al directorio nagios-2.7 de la siguiente manera:

# cd nagios-2.7

Paso 5: Creamos un usuario y grupo de nombre nagios:

root@nagiosserver:~# groupadd nagios
root@nagiosserver:~# useradd nagios -g nagios

* Listo, podemos agregar un grupo para ejecutar comandos con Nagios, pero utilizaremos el grupo nagios:

root@nagiosserver:~# usermod -G nagios (usuario de apache)

Ejecutamos el script de configuración:

root@nagiosserver:~#./configure --prefix=/usr/local/nagios --with-cgiurl=/nagios/cgi-bin --with-htmurl=/nagios/ --with-nagios-user=nagios --with-nagios-grp=nagios --with-command-grp=nagios

Paso 6: Compilamos

root@nagiosserver:~#make all

Paso 7: Instalamos binarios y los archivos HTML:

root@nagiosserver:~#make install

Paso 8: Instalamos Ejemplos de configuración:
Lo cual instalara los archivos .cfg en /usr/local/nagios/etc/xxx.cfg

root@nagiosserver:~#make install-config

Paso 9: Instalamos el script de iniciación:

root@nagiosserver:~#make install-init

Paso 10: Importante que todos los archivos en /usr/local/nagios incluyendo el directorio Nagios tengan como usuario y grupo a nagios:

root@nagiosserver:/usr/local#chown -R nagios:nagios nagios

Paso 11: Ya tenemos Nagios instalado. Nos dirigimos al directorio nagios y no encontraremos con los siguientes sub-directorios:
Sub-directorio Contenido
bin/ Programa Nagios
etc/ Los archivos de configuracion como Main, resource, object, y CGI van aqui.
sbin/ CGIs
share/ Archivos HTML
var/ Directorio vacío para log file, status file, retention file, etc.
var/archives Directorio vacío para los logs
var/rw Directorio vacío para el archivo external command
Paso 12: Editamos el apache2:Ingresamos al archivo apache2.conf con el comando vi

root@nagiosserver:/etc/apache2# vi apache2.conf

#Le copiamos esto para poder autenticarnos en la aplicación web de Nagios con el Apache.

# SSLRequireSSL
Options ExecCGI
AllowOverride None
Order allow,deny
Allow from all
# Order deny,allow
# Deny from all
# Allow from 127.0.0.1
AuthName "Nagios Access"
AuthType Basic AuthUserFile /usr/local/nagios/etc/htpasswd.users
Require valid-user
Alias /nagios "/usr/local/nagios/share"

# SSLRequireSSL
Options None
AllowOverride None
Order allow,deny
Allow from all#
Order deny,allow#
Deny from all#
Allow from 127.0.0.1
AuthName "Nagios Access"
AuthType Basic AuthUserFile /usr/local/nagios/etc/htpasswd.users
Require valid-user

Paso 13: Agregamos el usuario al archivo htpasswd.users que se encuentra en la siguiente ruta:

root@nagiosserver:/usr/local/nagios/etc# htpasswd.users

Utilizamos el siguiente comando para agregar usuario:

root@nagiosserver:~#htpasswd -c /usr/local/nagios/etc/htpasswd.users monitoreoori
New Password: xxxxxx
Repetir Password: xxxxxx

Paso 14: Si queremos agregar otros usuarios lo podemos hacer de la siguiente manera:

root@nagiosserver:~#htpasswd /usr/local/nagios/etc/htpasswd.users

Paso 15: Por utilizamos el navegador web Firefox 2 y copiamos lo siguiente:

http://localhost/nagios

Te pedirá el Usuario y Password que se supone ingresaste en el paso anterior y listo.

INSTALACIÓN DE PLUGINES

Paso 1: Posteriormente instalamos los plugins básicos, los cuales usualmente van en libexec/ en el directorio de Nagios.

root@nagiosserver:/usr/local/nagios/libexec# plugines ejecutables

Paso 2: descargamos los plugines de la siguiente página:http://nagiosplug.sourceforge.net
Paso 3: Descomprimimos el archivo nagios-plugins-1.4.5.tar.gz

root@nagiosserver:/home#tar xvzf nagios-plugins-1.4.5.tar.gz

Paso 4: Ingresamos al directorio nagios-plugins-1.4.5 y ejecutamos el Script de configuración:

root@nagiosserver:/home/nagios-plugins-1.4.5# ./configure --prefix=/usr/local/nagios --with-cgiurl=/nagios/cgi-bin

Paso 5: Compilamos los plugines con el siguiente comando:

root@nagiosserver:/home/nagios-plugins-1.4.5#make all

Paso 6: Instalamos y compilamos los binarios de los plugines con el siguiente comando:

root@nagiosserver:/home/nagios-plugins-1.4.5#make install

Paso 7: Para poder ejecutar los plugines como usuario root podemos ejecutar el siguiente comando:

root@nagiosserver:/home/nagios-plugins-1.4.5# make install-root

Paso 8: Se deben instalar las siguientes librerías de Perl:

root@nagiosserver:~# apt-get install libnet-snmp-perl libsnmp-perl

Ahora ya podremos ejecutar plugines tales como: ./check_ifoperstatus, ./check_ifstatus, entre otros.
Paso 9: Instalación de la siguiente librería (lm-sensors) para ejecutar el comando: ./check_sensors

root@nagiosserver:~# apt-get install lm-sensors

Paso 10: chown –R nagios:nagios /usr/local/nagios/libexec
Paso 11: Descarga de nuevos plugines de la siguiente URL:http://www.manubulon.com/nagios/
check_snmp_storage.pl: Descripción: Chequea disco de Windows y filesystems de Unix y Linux (disks, swap, memory, etc...)
check_snmp_load.pl: Descripción: Chequea la cantidad de CPU de un equipo Linux, Unix y Windows, Cisco además del average de carga del mismo.
check_snmp_win.pl:Descripción: Checks windows services
Paso 11: Instalar nuevos plugines de la siguiente manera:
1) Se convierte en archivos ejecutable con el siguiente comando:
2) root@nagiosserver:~# chmod a+x check_xxxxx.pl
3) Luego lo instalamos de esta manera: ./install.sh check_xxxxx.pl
Comprobamos que se ha instalado correctamente en la ruta /usr/local/nagios/libexec
4) Por ultimo ejecutamos el comando de esta manera:
root@nagiosserver:~#./check_xxxxx.pl –h (para que nos de una ayuda de cómo el modo de utilizar).

Preguntas y Documentación

2009-04-13T13:57:00.000-07:00

Estare agregando poco a poco documentación y dudas que surgieron en algun momento sobre Nagios...

Nagios 3.1.0 en CentOS 5.3

2009-04-13T11:55:00.000-07:00

Buen dia,

Pondre una breve guía para tener a Nagios 3.1.0 "up and running" en CentOS 5.3:

Primero bajamos Nagios 3.1.0 del repositorio de DAG.
Despues lo instalamos, pero antes de eso tenemos que instalar algunos paquetes necesarios, los cuales tambien los podemos bajar del repositorio de DAG:

# rpm --test -ivh fping-2.4-1.b2.2.el5.rf.i386.rpm
warning: fping-2.4-1.b2.2.el5.rf.i386.rpm: Header V3 DSA signature: NOKEY, key ID 6b8d79e6
Preparing... ########################################### [100%]

# rpm --test -ivh nagios-2.9-1.el5.rf.i386.rpm
warning: nagios-2.9-1.el5.rf.i386.rpm: Header V3 DSA signature: NOKEY, key ID 6b8d79e6
error: Failed dependencies:
libltdl.so.3 is needed by nagios-2.9-1.el5.rf.i386

[root@ltfs351 nagios]# rpm --test -ivh nagios-2.9-1.el5.rf.i386.rpm libtool-libs-1.5.6-4.EL4.2.i386.rpm
warning: nagios-2.9-1.el5.rf.i386.rpm: Header V3 DSA signature: NOKEY, key ID 6b8d79e6
warning: libtool-libs-1.5.6-4.EL4.2.i386.rpm: Header V3 DSA signature: NOKEY, key ID db42a60e
Preparing... ########################################### [100%]

[root@ltfs351 nagios]# rpm -ivh nagios-2.9-1.el5.rf.i386.rpm libtool-libs-1.5.6-4.EL4.2.i386.rpm
warning: nagios-2.9-1.el5.rf.i386.rpm: Header V3 DSA signature: NOKEY, key ID 6b8d79e6
warning: libtool-libs-1.5.6-4.EL4.2.i386.rpm: Header V3 DSA signature: NOKEY, key ID db42a60e
Preparing... ########################################### [100%]
1:libtool-libs ########################################### [ 50%]
2:nagios ########################################### [100%]

# rpm --test -ivh nagios-plugins-1.4.9-1.el5.rf.i386.rpm
warning: nagios-plugins-1.4.9-1.el5.rf.i386.rpm: Header V3 DSA signature: NOKEY, key ID 6b8d79e6
error: Failed dependencies:
perl(Net::SNMP) is needed by nagios-plugins-1.4.9-1.el5.rf.i386

# rpm --test -ivh nagios-plugins-1.4.9-1.el5.rf.i386.rpm perl-Net-SNMP-5.2.0-1.2.el5.rf.noarch.rpm
warning: nagios-plugins-1.4.9-1.el5.rf.i386.rpm: Header V3 DSA signature: NOKEY, key ID 6b8d79e6
error: Failed dependencies:
perl(Crypt::DES) is needed by perl-Net-SNMP-5.2.0-1.2.el5.rf.noarch
perl(Digest::HMAC) is needed by perl-Net-SNMP-5.2.0-1.2.el5.rf.noarch
perl(Digest::SHA1) is needed by perl-Net-SNMP-5.2.0-1.2.el5.rf.noarch

# rpm --test -ivh nagios-plugins-1.4.9-1.el5.rf.i386.rpm perl-Net-SNMP-5.2.0-1.2.el5.rf.noarch.rpm \
perl-Crypt-DES-2.05-3.2.el5.rf.i386.rpm perl-Digest-HMAC-1.01-2.rf.0.rh7.rf.noarch.rpm \
perl-Digest-SHA1-2.11-1.el5.rf.i386.rpm
warning: nagios-plugins-1.4.9-1.el5.rf.i386.rpm: Header V3 DSA signature: NOKEY, key ID 6b8d79e6
Preparing... ########################################### [100%]

# rpm -ivh nagios-plugins-1.4.9-1.el5.rf.i386.rpm perl-Net-SNMP-5.2.0-1.2.el5.rf.noarch.rpm \
perl-Crypt-DES-2.05-3.2.el5.rf.i386.rpm perl-Digest-HMAC-1.01-2.rf.0.rh7.rf.noarch.rpm \
perl-Digest-SHA1-2.11-1.el5.rf.i386.rpm
warning: nagios-plugins-1.4.9-1.el5.rf.i386.rpm: Header V3 DSA signature: NOKEY, key ID 6b8d79e6
Preparing... ########################################### [100%]
1:perl-Digest-SHA1 ########################################### [ 20%]
2:perl-Digest-HMAC ########################################### [ 40%]
3:perl-Crypt-DES ########################################### [ 60%]
4:perl-Net-SNMP ########################################### [ 80%]
5:nagios-plugins ########################################### [100%]

Despues de instalar Nagios podemos revisar nuestra configuración en el directorio /etc/nagios:

nagios -v /etc/nagios/nagios.cfg

Despues de verificar que todo esta bien podemos iniciar Nagios, sin embargo nos marcara un error si no le damos permiso en SELinux (referencia Fedora - Guía de Instalación Rápida).

Listo, con esto tendran Nagios 3.1.0 en CentOS 5.3 :D

Lectura adicional: Convertir RHEL 4 a CentOS 4 y actualizar a CentOS 5

Documentación de Nagios

2009-03-31T16:36:00.000-07:00

Pues en este sitio continuare agregando entradas referentes a la documentación 3.x de Nagios.

Monitoreando Servicios publicamente disponibles

2009-03-31T16:29:00.000-07:00

Introducción

Este documento describe como monitorear servicios, aplicaciones y protocolos publicamente disponibles. Al decir "público" quiere decir que esos servicios son accesibles a traves de la red - ya sea en la red local o por Internet. Ejemplos de servicios publicos son HTTP, POP3, IMAP, FTP, and SSH. Hay más servicios públicos que tal vez usted utilice en sus tareas diarias. Estos servicios y aplicaciones, así como sus protocolos, pueden ser monitoreados por Nagios sin necesidad de requerimientos de acceso especiales.

Servicios privados, en contraste, no pueden ser monitoreados con Nagios sin la intervención de algún agente. Ejemplos de servicios privados asociados con los equipos son como la carga de CPU, uso de Memoria, uso en disco, cuenta de usuarios activos, información de procesos, etc. Estos servicios privados o atributos de los equipos usualmente no son expuestos a clientes externos. Esta situación requiere que un agente de monitoreo intermediario sea instalado en el equipo que se desea monitorear esa información. Mayor información en monitorear servicios privados en diferentes tipos de equipos pueden ser localizados en la documentación siguiente:

Monitoreando Máquinas con Windows

Monitoreando servidores Netware

Monitoreando Máquinas con Linux/Unix

Tip: Ocasionalmente usted encontrará que la información de servicios y aplicaciones privadas pueden ser monitoreadas utilizando SNMP. El agente SNMP le permite monitorear remotamente información privada (e inaccesible) acerca del equipo. Para mayor información acerca de monitorear servicios utilizando SNMP, revise la documentación en monitoreando switches y routers.

Nota: Estas instrucciones asumen que usted instaló Nagios de acuerdo a la guía de instalación rápida. La configuración de ejemplo en la parte inferior hace referencia a objetos que estan definidos en los archivos de configuración de ejemplo (commands.cfg, localhost.cfg) que fueron instalados si usted siguio la guía rápida.

Plugins para Monitorear Servicios

Cuando usted se encuentra en la necesidad de monitorear una aplicación, servicio o protocolo en particular, las oportunidades son buenas de que un plugin exista para monitorearlo. La distribución oficial de plugins de Nagios viene con plugins que pueden ser utilizados para monitorear una variedad de servicios y protocolos. Tambien existe un gran numero de plugins contribuidos que pueden ser localizados en el subdirectorio contrib/. El sitio NagiosExchange.org hospeda un numero considerable de plugins adicionales que han sido creados por usuarios del sistema, reviselo cuando tenga una oportunidad.

Si no encuentra un plugin apropiado para sus necesidades de monitoreo, usted puede escribir uno por su cuenta. Los plugins son fáciles de escribir, por lo cual no deje que esto lo asuste. Lea la documentación sobre desarrollo de plugins para más información.

Lo guiaremos para monitorear algunos servicios básicos que usted probablemente utilizara tarde o temprano. Cada uno de estos servicios pueden ser monitoreados utilizando uno de los pluginsque fueron instalados como parte de la distribución de plugins de Nagios. Comencemos...

Creando una definición de equipo (Host)
Antes de que empiece a monitorear un servicio, usted primero tiene que definir un equipo que esta asociado con el servicio. Puede poner definiciones de equipos en cualquier archivo de configuración de objetos especificado por el archivo de la directiva cfg_file o puesto en el directorio especificado por la directiva cfg_dir. Si ya creo una definición de equipo, usted puede saltar este paso.

Para este ejemplo, digamos que desea monitorear una variedad de servicios en el equipo remoto. Llamemos al equipo remotehost. La definición de equipo puede ser puesta en su propio archivo o ser agregada en un archivo de configuración existente. Asi es como la definición del equipo remotehost debe verse:


define host{
 use  generic-host  ; Inherit default values from a template
 host_name  remotehost  ; The name we're giving to this host
 alias  Some Remote Host ; A longer name associated with the host
 address  192.168.1.50  ; IP address of the host
 hostgroups  allhosts  ; Host groups this host is associated with
 }

Ahora que la definición ha sido agregada para el equipo que vamos a monitorear, podemos empezar a definir servicios que deben ser monitoreados. Como las definiciones de equipos, las definiciones de servicios pueden ser agregadas en cualquier archivo de configuración de objetos.
Creando Definiciones de Servicios
Para cada servicio que desee monitorear, debe definir un servicio en Nagios que este asociado con la definición de equipo que acaba de crear. Usted puede agregar definiciones de servicios en cualquier archvio de configuración de objetos especificado en la directiva cfg_file o agregado en el directorio especificado en la directiva cfg_dir.

Algunos ejemplos de definición de servicios para monitorear servicios publicos comunes (HTTP, FTP, etc) son mostrados abajo.
Monitoreando HTTP
En algún momento usted querrá monitorear servidores web - el suyo o el de alguien más. El plugin check_http esta diseñado para ello. El entiende el protocolo HTTP y usted puede monitorear el tiempo de respuesta, códigos de error, cadenas que regresa HTML, certificados de servidor y mucho más.

El archivo commands.cfg contiene la definición del comando que vamos a utilizar por el plugin check_http. Debe verse así:


define command{
 name  check_http
 command_name check_http
 command_line $USER1$/check_http -I $HOSTADDRESS$ $ARG1$
 }

Una definición de servicio simple para monitorear el servicio de HTTP el la máquina remotehost debe verse así:


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description HTTP
 check_command check_http
 }

Esta simple definición de servicio va a monitorear el servicio HTTP ejecutadose en remotehost. Producira alertas si el servidor web no responde dentro de 10 segundos o si el HTTP regresa códigos de error (403, 404, etc.). Eso es lo que usted necesita para un monitoreo simple. Un poco simple, huh?

Tip: Para monitoreo avanzado, ejecute el plugin check_http manualmente con --help como argumento en la línea de comandos para ver todas las opciones que el plugin nos puede dar. Esta sintaxis --help funciona con todos los plugins que seran cubiertos en este documento.

Una definición más avanzada sobre el monitoreo del servicio HTTP es mostrado a continuación. Esta definición de servicio revisará si el URI /download/index.php contiene la cadena "latest-version.tar.gz". Producirá un error si la cadena no es encontrada, la URI es invalida, o el servidor web toma más de 5 segundos para responder.


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description Product Download Link
 check_command check_http!-u /download/index.php -t 5 -s "latest-version.tar.gz"
 }

Monitoreando FTP
Cuando necesite monitorear servidores FTP, puede utilizar el plugin check_ftp. El archivo commands.cfg contiene una definición de comando para ser utilizado por el plugin check_ftp, el cual se ve como sigue:


define command{
 command_name check_ftp
 command_line $USER1$/check_ftp -H $HOSTADDRESS$ $ARG1$
 }

Una definición de servicio simple para monitorear un servidor FTP en remotehost debe verse así:


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description FTP
 check_command check_ftp
 }

Esta definición de servicio va a monitorear el servicio de FTP y generará alertas si el servidor FTP no responde dentro de 10 segundos.

Una definición de servicio más avanzada es mostrada a continuación. Este servicio revisara al servidor FTP ejecutandose en el puerto 1023 en remotehost. Generará una alerta si el servidor no responde dentro de 5 segundos o si la respuesta del servidor no contiene la cadena "Pure-FTPd [TLS]".


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description Special FTP 
 check_command check_ftp!-p 1023 -t 5 -e "Pure-FTPd [TLS]"
 }

Monitoreando SSH
Cuando necesite monitorear servidores SSH, puede utilizar el plugin check_ssh. El archivo commands.cfg contiene la definición de comandos que son utilizadas por el plugin check_ssh, el cual debe verse así:


define command{
 command_name check_ssh
 command_line $USER1$/check_ssh $ARG1$ $HOSTADDRESS$
 }

Una definición de servicio simple para monitorear el servidor SSH en remotehost debe verse así:


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description SSH
 check_command check_ssh
 }

Esta definición de servicio debe monitorear el servicio SSH y generar alertas si el servidor SSH no responde dentro de 10 segundos.
Una definición de servicio más avanzada es mostrada acontinuación. Este servicio revisará el servidor SSH y generará una alerta si el servidor no responde dentro de 5 segundos o si la cadena de la versión de servidor no empata con "OpenSSH_4.2".


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description SSH Version Check 
 check_command check_ssh!-t 5 -r "OpenSSH_4.2"
 }

Monitoreando SMTP
El plugin check_smtp es utilizado para monitorear servidores de correo. El archivo commands.cfg contiene una definición de comando para utilizar el plugin check_smtp, el cual debe verse así:


define command{
 command_name check_smtp
 command_line $USER1$/check_smtp -H $HOSTADDRESS$ $ARG1$
 }

Una definición de servicio simple para monitorear el servidor SMTP en remotehost debe verse así:


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description SMTP
 check_command check_smtp
 }

Esta definición de servicio debe monitorear el servicio SMTP y generar alertas si el servidor SMTP no responde dentro de 10 segundos.
Una definición de servicio más avanzada se puede ver acontinuación. Este servicio deberá revisar el servidor SMTP y generar una alerta si el servidor no responde en 5 segundos o si la respuesta del servidor no contiene "mygreatmailserver.com".


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description SMTP Response Check 
 check_command check_smtp!-t 5 -e "mygreatmailserver.com"
 }

Monitoreando POP3
El plugin check_pop es utilizado para monitorear el servicio POP3 en los servidores de correo. El archivo commands.cfg contiene la definición de comando para utilizar el plugin check_pop, el cual debe verse así:


define command{
 command_name check_pop
 command_line $USER1$/check_pop -H $HOSTADDRESS$ $ARG1$
 }

Una simple definición de servicio para monitorear el servicio POP3 en remotehost deberá verse así:


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description POP3
 check_command check_pop
 }

Esta definición de servicio deberá monitorear el servicio POP3 y generar alertas si el servidor POP3 no responde dentro de 10 segundos.
Una definición de servicio más avanzada es mostrada acontinuación. Este servicio revisará el servicio POP3 y deberá generar una alerta si el servidor no responde dentro de 5 segundos o si la respuesta del servidor no contiene "mygreatmailserver.com".


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description POP3 Response Check 
 check_command check_pop!-t 5 -e "mygreatmailserver.com"
 }

Monitoreando IMAP
El plugin check_imap puede ser utilizado para monitorear servicios IMAP4 en los servidores de correo. El archivo commands.cfg contiene una definición de comando para utilizar el plugin check_imap, el cual se ve así:


define command{
 command_name check_imap
 command_line $USER1$/check_imap -H $HOSTADDRESS$ $ARG1$
 }

Una definición de servicio simple para monitorear el servicio IMAP4 en remotehost deberá verse así:


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description IMAP
 check_command check_imap
 }

Esta definición de servicio deberá monitorear el servicio IMAP4 y generar alertas si el servidor IMAP4 no responde dentro de 10 segundos.

Una definición de servicio más avanzada es mostrada acontinuación. Este servicio deberá revisar el servicio IAMP4 y generar una alerta si el servidor no responde dentro de 5 segundos o si la respuesta del servidor no contiene "mygreatmailserver.com".


define service{
 use  generic-service  ; Inherit default values from a template
 host_name  remotehost
 service_description IMAP4 Response Check 
 check_command check_imap!-t 5 -e "mygreatmailserver.com"
 }

Reiniciando Nagios
Una vez que usted ha agregado nuevas definiciones de equipos y servicios en sus archivos de configuración de objetos, usted esta listo para monitorearlos. Para esto, usted necesita verificar su configuración y reiniciar Nagios.

Si el proceso de verificación produce mensajes de error, solucione los archivos de configuración antes de continuar. Asegurese de no reiniciar Nagios hasta que el proceso de verificación se complete sin errores!.

Monitoreando Routers y Switches

2009-03-31T16:28:00.001-07:00

Introducción

Este documento describe como usted puede monitorear el estado de los switches y routers de la red. Algunos switches y hubs baratos "inadministrables" no tienen una dirección IP y esencialmente son invisibles en su red, por lo tanto no hay forma de poder monitorearlos. A switches y routers más caros se les puede asignar direcciones y pueden ser monitoreados pingeandolos o utilizando SNMP para solicitar información sobre su estado.

Se describira como usted puede monitorear las siguientes cosas en switches, hubs y routers administrables:

Pérdida de Paquetes, round trip average

Información sobre el estado usando SNMP

Ancho de Banda / Taza de Tráfico

Nota: Estas instrucciones asumen que usted instaló Nagios de acuerdo a las guías de instalación rápida. La configuración de ejemplo en la parte inferior hace referencia a objetos que estan definidos en los archivos de configuración de ejemplo (commands.cfg, templates.cfg, etc.) que fueron instalados si usted siguio la guía rápida.

Descripción

Monitoring switches and routers can either be easy or more involved - depending on what equipment you have and what you want to monitor. As they are critical infrastructure components, you'll no doubt want to monitor them in at least some basic manner.

Los switches y routers pueden ser monitoreados facilmente "pingueandolos" para determinar pérdida de paquetes, RTA, etc. Si su switch soporta SNMP, usted puede monitorear el estado de los puertos, etc. con el plugin check_snmp y el ancho de banda (si usted esta utilizando MRTG) con el plugin check_mrtgtraf.

El plugin check_snmp solamente puede ser compilado e instalado su usted tiene instalados los paquetes net-snmp y net-snmp-utils instalados en su sistema. Asegurese que su plugin existe en /usr/local/nagios/libexec antes de continuar. Si no es así, instale net-snmp y net-snmp-utils y recompile/reinstale los plugins de Nagios.

Pasos

Hay varios pasos que usted necesita seguir en orden para monitorear un nuevo router o switch. Estos son:

Realizar prerequisitos por primera vez

Crear nuevas definiciones de equipos y servicios para monitorear el equipo

Reiniciar el servicio de Nagios

Que es lo que ya se ha hecho por usted

Para hacerle la vida un poco más fácil, algunas tareas de configuración ya se han realizado para usted:

Dos definiciones de comandos (check_snmp y check_local_mrtgtraf) han sido agregadas al archivo commands.cfg. Esto le permite utilizar los plugins check_snmp y check_mrtgtraf para monitorear routers de red.

Una plantilla de switch (llamada generic-switch) ha sido creada en el archivo templates.cfg. Esto le permite a usted agregar nuevas denificiones de equipo router/switch de una manera simple.

Los archivos de configuración anteriormente mencionados pueden ser localizados en el directorio /usr/local/nagios/etc/objects/. UUsted puede modificar estas definiciones u otras definiciones para satisfacer mejor sus necesidades si usted así lo desea. Sin embargo, se le recomienda esperar mientras usted se familiariza con la configuración de Nagios antes de hacerlo. Por el momento, solo siga las instrucciones en la parte inferior y usted estará monitoreando sus routers/switches de red rápidamente.

Prerequisitos
La primera vez que usted configure Nagios para monitorear una máquina Windows, usted necesitara realizar un poco más de trabajo. Recuerde, usted necesita realizar esto para el *primer* switch que va a monitorear.

Edite su archivo de configuración de Nagios principal (main).


vi /usr/local/nagios/etc/nagios.cfg

Quite el caracter asterisco (#) de la siguiente línea de su archivo de configuración principal:


#cfg_file=/usr/local/nagios/etc/objects/switch.cfg

Grabe y salga.

¿Qué es lo que ha hecho?, usted le acaba de decir a Nagios que vea el archivo /usr/local/nagios/etc/objects/switch.cfg para encontrar definiciones de objetos adicionales. Ahi es donde usted estara agregando definiciones de equipos y servicios para los routers y switches. El archivo de configuración ya contiene definiciones ejemplo de equipos, grupo de equipos (hostgroups) y servicios. Para el *primer* router/switch que va a monitorear, usted simplemente modifique las definiciones de ejemplo de equipos y servicios en ese archivo, en vez de crear nuevas.

Configurando Nagios

Usted necesita crear algunas definiciones de objetos en orden para monitorear un nuevo router/switch.

Abra el archivo switch.cfg para editarlo.


vi /usr/local/nagios/etc/objects/switch.cfg

Agregue una nueva definición de equipo para el switch que usted va a monitorear. Si este es el *primer* switch que va a monitorear, usted simplemente puede modificar la definición de equipo de ejemplo en el archivo switch.cfg. Cambie los campos host_name, alias, y address a los valores apropiados para el switch.


define host{
 use  generic-switch  ; Inherit default values from a template
 host_name  linksys-srw224p  ; The name we're giving to this switch
 alias  Linksys SRW224P Switch ; A longer name associated with the switch
 address  192.168.1.253  ; IP address of the switch
 hostgroups allhosts,switches   ; Host groups this switch is associated with
 }

Monitoreando Servicios

Ahora usted puede agregar definiciones de servicios (en el mismo archivo de configuración) para monitorear diferentes aspectos del switch. Si este es el *primer* witch que va a monitorear, usted simplemente puede modificar las definiciones de servicios en el archivo switch.cfg.

Nota: Reemplace "linksys-srw224p" en las definiciones de ejemplo en la parte inferior con el nombre que usted especifico en la directiva host_name de la definición de equipo que acaba de agregar.

Monitoreando Pérdida de Paquetes y RTA

Agregue la siguiente definición de servicio en orden para monitorear pérdida de paquetes y promedio de round trip entre el equipo de Nagios y el switch cada 5 minutos bajo condiciones normales.


define service{
 use   generic-service ; Inherit values from a template
 host_name linksys-srw224p ; The name of the host the service is associated with
 service_description PING ; The service description
 check_command  check_ping!200.0,20%!600.0,60% ; The command used to monitor the service
 normal_check_interval 5 ; Check the service every 5 minutes under normal conditions
 retry_check_interval 1 ; Re-check the service every minute until its final/hard state is determined
 }

Este servicio será:

CRITICO (CRITICAL) si el promedio de round trip (RTA) es mayor a 600 milisegundos o la pérdida de paquetes es 60% o más

PRECAUCIÓN (WARNING) si el RTA es mayor a 200 ms o la pérdida de paquetes es 20% o más

OK si el RTA es menor a 200 ms y la pérdida de paquetes es menor a 20%

Monitorando Información de Estado con SNMP

Si su switch o router soporta SNMP, usted puede monitorear mucha información utilizando el plugin check_snmp. Si no es así, salte esta sección.

Agregue la siguiente definición de servicio para monitorear el tiempo de actividad (uptime) del switch.


define service{
 use   generic-service ; Inherit values from a template
 host_name   linksys-srw224p
 service_description Uptime 
 check_command  check_snmp!-C public -o sysUpTime.0
 }

En la directiva check_command de la definición de servicio anterior, el "-C public" le dice al plugin que la comunidad SNMP que va a ser utilizada es "public" y el "-o sysUpTime.0" indica cual OID deberá ser revisada.

Si usted desea asegurarse si un puerto o interfaz en especifico del switch estan en funcionamiento, usted puede agregar una definición de servicio como la siguiente:


define service{
 use   generic-service ; Inherit values from a template
 host_name   linksys-srw224p
 service_description Port 1 Link Status
 check_command  check_snmp!-C public -o ifOperStatus.1 -r 1 -m RFC1213-MIB
 }

En el ejemplo anterior, el "-o ifOperStatus.1" se refiere al OID para el estado operacional del puerto 1 en el switch. La opción "-r 1" le dice al plugin check_snmp que regrese el estado OK si "1" si es recibido como resultado de SNMP (1 indica un estado de funcionamiento ("up") del puerto) y (CRÍTICO) CRITICAL si no fue recibido 1. El "-m RFC1213-MIB" es opcional y le dice al plugin check_snmp que solo cargue el "RFC1213-MIB" en vez de cada una de las MIBs que estan instaladas en su sistema, lo cual puede hacer que se agilice todo.

Eso es todo para el ejemplo de monitoreo con SNMP. Hay muchas cosas que pueden ser monitoreadas utilizando SNMP, por lo cual es cuestion de usted que necesita y que quiere monitorear. Buena suerte!

Tip: Usted puede usualmente encontrar OIDs que pueden ser monitoreadas en un switch ejecutando el siguiente comando (reemplace 192.168.1.253 con la dirección IP del switch):
snmpwalk -v1 -c public 192.168.1.253 -m ALL .1

Monitoreando Ancho de Banda / Taza de Tráfico

Si usted esta monitoreando el uso de ancho de banda en switches y routers utilizando MRTG, usted puede hacer que Nagios le alerte cuando las tazas de tráfico exceden umbrales o rangos que usted especifica. El plugin check_mrtgtraf (el cual es incluido en la distribución de plugins de Nagios) le permite a usted hacer eso.

Usted necesita permitir al plugin check_mrtgtraf conocer cual archivo de registro (log) donde se guardan los datos de MRTG, junto con los rangos o umbrales, etc. En este ejemplo, se va a monitorear uno de los puertos de un switch linksys. El archivo de registros (log) de MTRG esta grabado en /var/lib/mrtg/192.168.1.253_1.log. A continuación se muestra la definición de servicio que se utiliza para monitorear el uso ancho de banda que esta grabada en ese archivo de registro (log file)...


define service{
 use   generic-service ; Inherit values from a template
 host_name   linksys-srw224p
 service_description Port 1 Bandwidth Usage
 check_command  check_local_mrtgtraf!/var/lib/mrtg/192.168.1.253_1.log!AVG!1000000,2000000!5000000,5000000!10
 }

En el ejemplo anterior, la opción "/var/lib/mrtg/192.168.1.253_1.log" que es pasada al comando check_local_mrtgtraf le dice al plugin cual archivo de registros de MRTG se va a leer. La opción "AVG" le dice que deberá utilizar estadisticas promedio de ancho de banda. Las opciones "1000000,2000000" son los rangos de precaución (en bytes) para las tazas de tráfico entrante. Las opciones "5000000,5000000" son rangos críticos (en bytes) para tazas de tráfico saliente. La opción "10" cause que el plugin regrese un estado CRÍTICO (CRITICAL) si el archivo de registros no se ha actualizado en 10 minutos (se debe actualizar cada 5 minutos).

Grabe el archivo.

Reiniciando Nagios

Una vez que usted ha agregado las nuevas definiciones de equipos y serviciosen el archivo switch.cfg, usted esta listo para monitorear un router/switch. Para esto, usted necesita verificar su configuración y reiniciar Nagios.

Si el proceso de verificación produce un error, arregle los archivos de configuración antes de continuar. Asegurese de no reiniciar Nagios hasta que el proceso de verificación se complete sin errores!

Monitoreando Impresoras de Red

2009-03-31T16:27:00.000-07:00

Introducción

Este documento describo como monitorear el estado de impresoras dentro de la red. Especificamente impresoras HP que tienen tarjetas internas/externas Jetdirect u otros servidores de impresión (como el Troy PocketPro 100S o el Netgear PS101) que soportan el protocolo JetDirect.

El plugin check_hpjd (que es parte de la distribución estandar de plugins de Nagios) permite a usted monitorear el estado de impresoras disponibles con JetDirect que tienen SNMP habilitado. El plugin es capaz de detectar los siguientes estados de la impresora:

Paper Jam (Papel atascado)

Out of Paper (Sin Papel)

Printer Offline (Impresora fuera de Linea)

Intervention Required (Intervención Requerida)

Toner Low (Toner Bajo)

Insufficient Memory (Memoria Insuficiente)

Open Door (Puerta Abierta)

Output Tray is Full (Bandeja de Salida esta llena)

y más...

Nota: Estas instrucciones asumen que usted instaló Nagios de acuerdo a las guías de instalación rápida. La configuración de ejemplo en la parte inferior hace referencia a objetos que estan definidos en los archivos de configuración de ejemplo (commands.cfg, templates.cfg, etc.) que fueron instalados si usted siguio la guía rápida.

Descripción

Monitorear el estado de una impresora en red es bastante simple. Las impresoras con JetDirect habilitado usualmente tienen SNMP activado, lo cual permite a Nagios monitorear su estado utilizando el plugin check_hpjd.

El plugin check_hpjd solamente se compilará y se instalará si usted tiene instalados los paquetes net-snmp y net-snmp-utils. Asegurese que el plugin existe en /usr/local/nagios/libexec antes de continuar. Si no existe, instale net-snmp y net-snmp-utils, recompile y reinstale los plugins de Nagios.

Pasos

Hay varios pasos que debe de seguir en orden para monitorear una nueva impresora en red. Estos son:

Realizar los prerequisitos por primera vez

Crear nuevas definiciones de equipo y servicios para monitorear la impresora

Reiniciar el servicio de Nagios

Que es lo que ya se ha hecho por usted

Para hacerle la vida un poco más fácil, algunas tareas de configuración ya han sido realizadas para usted:

Una definición del comando check_hpjd ha sido agregada en el archivo commands.cfg. Esto permite a usted utilizar el plugin check_hpjd para monitorear impresoras.

Una plantilla de equipo para impresora (llamada generic-printer) ha sido creada en el archivo templates.cfg. Esto permite a usted el agregar nuevas definiciones de equipos de impresora de una manera simple.

Los archivos de configuración anteriormente mencionados pueden ser localizados en el directorio /usr/local/nagios/etc/objects/. Usted puede modificar estas definiciones u otras definiciones para satisfacer mejor sus necesidades si usted así lo desea. Sin embargo, se le recomienda esperar mientras usted se familiariza con la configuración de Nagios antes de hacerlo. Por el momento, solo siga las instrucciones en la parte inferior y usted estara monitoreando sus impresoras de red rápidamente.

Prerequisitos

La primera vez que usted configure Nagios para monitorear una impresora de red, usted necesitara realizar un poco más de trabajo. Recuerde, usted necesita realizar esto para la *primera* impresora de red que va a monitorear.

Edite el archivo de configuración principal de Nagios.


vi /usr/local/nagios/etc/nagios.cfg

Remueva el caracter asterisco (#) de la siguiente línea del archivo de configuración principal:


#cfg_file=/usr/local/nagios/etc/objects/printer.cfg

Grabe el archivo y salga.

¿Qué es lo que ha hecho?, usted le acaba de decir a Nagios que vea el archivo /usr/local/nagios/etc/objects/printers.cfg para buscar definiciones adicionales de objetos. Ahi es donde usted agregara definiciones de equipos y servicios para la impresora. Este archivo de configuración ya contiene algunos ejemplos de definiciones de equipos, grupos de equipos (hostgroups) y servicios. Para la *primer* impresora a monitorear, usted simplemente modifique las definiciones de equipo y servicio en ese archivo, no hay necesidad de crear nuevos, solo copie, pegue y modifique.

Configurando Nagios

Usted necesita crear algunas definiciones de objetos en orden para monitorear una nueva impresora.

Habra el archivo printer.cfg para editarlo.


vi /usr/local/nagios/etc/objects/printer.cfg

Agregue una nueva definición de equipo para la impresora de red que usted va a monitorear. Si esta es la *primer* impresora a monitorear, usted puede simplemente modificar la definicion de equipo de ejemplo en el archivo printer.cfg. Cambie los campos host_name, alias, y address a los valores apropiados para la impresora.


define host{
 use  generic-printer ; Inherit default values from a template
 host_name  hplj2605dn ; The name we're giving to this printer
 alias  HP LaserJet 2605dn ; A longer name associated with the printer
 address  192.168.1.30 ; IP address of the printer
 hostgroups allhosts  ; Host groups this printer is associated with
 }

Ahora puede agregar algunas definiciones de servicio (al mismo archivo de configuración) para monitorear diferentes aspectos de la impresora. Si esta es la *primer* impresora que va a monitorear, usted simplemente puede modificar el ejemplo de la definición de servicio en el archivo printer.cfg.

Nota: Reemplace "hplj2605dn" en las definiciones de ejemplo de la parte superior con el nombre que usted especifico en la directiva host_name de la definicion del equipo que acaba de agregar.

Agregue la siguiente definición de servicio para revisar el estatus de la impresora. El servicio utiliza el plugin check_hpjd para revisar el estatus de la impresora cada 10 minutos por default. La cadena de la comunidad SNMP utilizada para realizar la petición a la impresora es "public" en este ejemplo.


define service{
 use   generic-service  ; Inherit values from a template
 host_name   hplj2605dn  ; The name of the host the service is associated with
 service_description Printer Status  ; The service description
 check_command  check_hpjd!-C public ; The command used to monitor the service
 normal_check_interval 10 ; Check the service every 10 minutes under normal conditions
 retry_check_interval 1 ; Re-check the service every minute until its final/hard state is determined
 }

Agregue la siguiente definición de servicio para realizar un ping a la impresora cada 10 minutos por default. Esto es útil para monitorear RTA, perdida de paquetes y conectividad en general en la red.


define service{
        use                     generic-service
        host_name               hplj2605dn
        service_description     PING
        check_command           check_ping!3000.0,80%!5000.0,100%
        normal_check_interval   10
        retry_check_interval    1
        }

Grabe el archivo.

Reiniciando Nagios

Una vez que usted ha agregado las nuevas definiciones de equipo y servicio al archivo de configuración printer.cfg, usted esta listo para empezar a monitorear la impresora. Para hacer esto, usted necesita verificar su configuración y reiniciar Nagios.

Si el proceso de verificación produce un error, arregle los archivos de configuración antes de continuar. Asegurese de no reiniciar Nagios hasta que el proceso de verificación se complete sin errores!

Monitoreando Equipos con Novell Netware

2009-03-31T16:26:00.001-07:00

Introducción
Este documento proporciona información sobre como monitorear servidores Novell Netware.
Recursos Externos
Usted puede encontrar documentación de como monitorear servidores Netware con Nagios en el sitio de Novell Cool Solutions, incluyendo:

MRTGEXT: NLM module for MRTG and Nagios

Nagios: Host and Service Monitoring Tool

Nagios and NetWare: SNMP-based Monitoring

Monitor DirXML/IDM Driver States with Nagios

Check NDS Login ability with Nagios

NDPS/iPrint Print Queue Monitoring by Nagios

check_gwiaRL Plugin for Nagios 2.0

Tip: Cuando visite el sitio de Novell Cool Solutions, realice una busqueda de "Nagios" para encontrar más articulos y componentes de software relacionados al monitoreo.
Gracias a Christian Mies, Rainer Brunold, y otros por contribuir con documentación, complementos, etc. de Nagios y Netware en el sitio de Novell!

Monitoreando Equipos con Linux/Unix

2009-03-31T16:25:00.002-07:00

Introducción

Este documento describe el como monitorear servicios "privados" y atributos en servidores Linux/UNIX, como son:

Carga de CPU

Uso de Memoria

Uso en Disco Duro

Usuarios firmados

Procesos Ejecutandose

Etc.

Los servicios publicamente disponibles que son proporcionados por los servidores Linux (HTTP, FTP, SSH, SMTP, etc.) pueden ser monitoreados facilmente siguiendo la documentación en servicios publicamente disponibles.

Nota: Estas instrucciones asumen que usted instaló Nagios de acuerdo a la guía de instalación rápida. Las entradas de configuración de ejemplo en la parte inferior de los objetos de referencia que estan definidos en los archivos de configuración de ejemplo (commands.cfg, templates.cfg, etc.) son instalados si se sigue la guía de instalación rápida.

Descripción

[Nota: Este documento no ha sido terminado. Se le recomienda que lea la documentación del complemento NRPE para instrucciones de como monitorear un servidor remoto Linux/Unix.]

Hay varias formas de monitorear los atributos de servidores remotos Linux/Unix. Una es utilizando llaves SSH compartidas (shared SSH keys) y el plugin check_by_ssh para ejecutar plugins en servidores remotos. Este metodo no será cubierto aquí, pero puede resultar muy demandante para el servidor de monitoreo si se monitorean cientos o miles de servicios. El costo de creación y destrucción de conecciones SSH es causa de esto.

Otro método común para monitorear remotamente equipos Linux/Unix Es el de usar el complemento NRPE. NRPE permite ejecutar plugins en equipos remotos Linux/Unix. Esto puede ser útil si se necesita monitorear los recursos/atributos locales como uso en disco, carga en CPU, uso en memoria, etc. en un equipo remoto.

(En este sitio viene explicado a grandes rasgos como funciona en el manual de la versión 2 apartado NRPE).

Monitoreando Equipos con Windows

2009-03-31T16:25:00.001-07:00

Introducción

Este documento describe el como monitorear servicios "privados" y atributos en máquinas con Windows, como por ejemplo:

Uso de Memoria

Carga en CPU

Uso en Disco Duro

Estado en Servicios

Procesos ejecutandose

etc.

Los servicios publicamente disponibles que proveen las máquinas con Windows (HTTP, FTP, POP3, etc.) pueden ser monitoreados fácilmente siguiendo la documentación en monitoreando servicios publicamente disponibles.

Nota: Estas instrucciones asumen que usted instaló Nagios de acuerdo a la guía de instalación rápida. Las entradas de configuración de ejemplo en la parte inferior de los objetos de referencia que estan definidos en los archivos de configuración de ejemplo (commands.cfg, templates.cfg, etc.) son instalados si se sigue la guía de instalación rápida.

Descripción

El monitorear servicios privados o atributos de una máquina con Windows requiere que usted instale un agente. Este agente actua como un proxy entre el plugin de Nagios que realiza el monitoreo y el servicio actual o atributo de la máquina Windows. Sin instalar un agente en Windows, Nagios no podria monitorear servicios privados o atributos de Windows.

Para este ejemplo, instalaremos el complemento NSClient++ en la máquina con Windows y utilizaremos el plugin check_nt para comunicarnos con el complemento NSClient++. El plugin check_nt debera ya estar instalado en el servidor de Nagios si se siguieron los pasos de la guía de instalación rápida.

Otros agentes de Windows (como NC_Net) pueden ser utilizados en ves de NSClient++ si usted lo desea - usted tendra que realizar cambios en las definiciones de comandos y servicios. Por simplicidad solamente se cubrira el complemento NSClient++ en estas instrucciones.

Pasos

Hay algunos pasos que usted debe seguir en orden para monitorear la nueva máquina Windows. Aquí estan:

Realizar prerequisitos por primera vez

Instalar un agente de monitoreo en la máquina Windows

Crear nuevas definiciones de nuevo equipo (host) y nuevo servicio (service) para monitorear a la máquina Windows

Reiniciar el servicio de Nagios

Que es lo que ya se ha hecho por usted

Para hacerle la vida un poco más fácil, algunas tareas de configuración ya se han realizado para usted:

Una definición del comando check_nt ha sido agregado al archivo commands.cfg. Esto permite a usted que utilice el plugin check_nt para monitorear servicios de Windows.

Una plantilla de equipo de servidor Windows (llamada windows-server) ha sido creada en el archivo templates.cfg. Esto permite a usted el agregar nuevas definiciones de equipos con Windows de una manera simple.

Los archivos de configuración anteriormente mencionados pueden ser localizados en el directorio /usr/local/nagios/etc/objects/. Usted puede modificar estas definiciones u otras definiciones para satisfacer mejor sus necesidades si usted así lo desea. Sin embargo, se le recomienda esperar mientras usted se familiariza con la configuración de Nagios antes de hacerlo. Por el momento, solo siga las instrucciones en la parte inferior y usted estara monitoreando sus máquinas con Windows rápidamente.

Prerequisitos

La primera vez que usted configure Nagios para monitorear una máquina Windows, usted necesitara realizar un poco más de trabajo. Recuerde, usted necesita realizar esto para la *primera* máquina Windows que va a monitorear.

Edite su archivo de configuración de Nagios principal (main).


vi /usr/local/nagios/etc/nagios.cfg

Quite el caracter asterisco (#) de la siguiente línea de su archivo de configuración principal:


#cfg_file=/usr/local/nagios/etc/objects/windows.cfg

Grabe y salga.

¿Qué es lo que ha hecho?, usted le acaba de decir a Nagios que vea el archivo /usr/local/nagios/etc/objects/windows.cfg para buscar definiciones adicionales de objetos. Ahi es donde usted agregara definiciones de equipos y servicios Windows. Este archivo de configuración ya contiene algunos ejemplos de definiciones de equipos, grupos de equipos (hostgroups) y servicios. Para la primer máquina Windows, usted simplemente modifique las definiciones de equipo y servicio en ese archivo, no hay necesidad de crear nuevos, solo copie, pegue y modifique.

Instalando el agente Windows

Antes de monitorear servicios privados y atributos de las máquinas con Windows, usted necesita instalar un agente a estas máquinas. Se recomienda utilizar el complemento NSClient++, que puede ser localizado en http://sourceforge.net/projects/nscplus. Estas instrucciones lo llevaran a traves de una instalación básica del complemento NSClient++, asi como la configuración de Nagios para monitorear la máquina Windows.

1. Descargue la última versión estable del complemento NSClient++ desde http://sourceforge.net/projects/nscplus

2. Descomprima los archivos de NSClient++ en un nuevo directorio C:\NSClient++

3. Abra un command prompt y cambiese al directorio C:\NSClient++

4. Registre el servicio de NSClient++ con el siguiente comando:


 nsclient++ /install

5. Instale el "systray" de NSClient++ con el siguiente comando ('SysTray' es case-sensitive):


 nsclient++ SysTray

6. Abra el manejador de servicios y asegurese que el servicio NSClientpp es permitido para interactuar con el escritorio (vease el tab 'Log On' en el manejador de servicios). Si no esta permitido para interactuar con el escritorio, seleccione el cuadro para permitirlo.

7. Edite el archivo NSC.INI (localizado en el directorio C:\NSClient++) y realize los siguientes cambios:

Descomente todos los modulos que aparecen listados en la sección [modules], excepto CheckWMI.dll y RemoteConfiguration.dll

Opcional, si requiere una contraseña para los clientes, cambie la opción 'password' en la sección [Settings].

Descomente la opción 'allowed_hosts' en la sección [Settings]. Agregue la dirección IP de su servidor de Nagios en esta línea o dejela en blanco para permitir a todos los equipos conectarse.

Asegurese que la opción 'port' en la sección [NSClient] esta descomentada y asignada a '12489' (el puerto por default).

8. Inicie el servicio de NSClient++ con el siguiente comando:


 nsclient++ /start

9. Si fue instalado adecuadamente, un nuevo icono debera aparecer en la barra del sistema (systray). Será un circulo amarillo con una M negra dentro.

10. Exito! El servidor Windows ahora puede ser agregado a la configuracion de Nagios para su monitoreo...

Configurando Nagios

Ahora es tiempo de definir objetos en sus archivos de configuración de Nagios en orden para monitorear la nueva máquina de Nagios.

Abra el archivo windows.cfg para editarlo.


vi /usr/local/nagios/etc/objects/windows.cfg

Agregue una definición nueva de equipo para la máquina Windows que usted desea monitorear. Si esta es la primer máquina Windows que va a monitorear, usted simplemente tendra que modificar la definición de ejemplo del equipo en windows.cfg. Cambie el host_name, alias, y address por lo valores apropiados para su equipo con Windows.


define host{
 use  windows-server ; Inherit default values from a Windows server template (make sure you keep this line!)
 host_name  winserver
 alias  My Windows Server
 address  192.168.1.2
 }

Bien. Ahora puede agregar algunas definiciones de servicios (en el mismo archivo de configuración) en orden para decirle a Nagios que se van a monitorear varios aspectos de la máquina Windows. Si es la *primer* máquina Windows que va a monitorear, usted simplemente puede modificar las definiciones de servicios de ejemplo en windows.cfg.

Nota: Reemplace "winserver" en las definiciones de ejemplo en la parte inferior con el nombre que usted especifico en la directiva host_name en la definición de equipo que usted agregó.

Agregue la siguiente definición de servicio para monitorear la version del complemento NSClient++ que se esta ejecutando en el servidor Windows. Esto es útil cuando llega el tiempo de actualizar en los servidores Windows una nueva versión del complemento, y usted podra decir cual de las máquinas Windows necesitan que se actualice a la última version de NSClient++.


define service{
 use   generic-service
 host_name   winserver
 service_description NSClient++ Version
 check_command  check_nt!CLIENTVERSION
 }

Agregue la siguiente definición de servicio para monitorear el tiempo de actividad del servidor Windows.


define service{
 use   generic-service
 host_name   winserver
 service_description Uptime
 check_command  check_nt!UPTIME
 }

Agregue la siguiente definición de servicio para monitorear el uso de CPU en el servidor Windows y generar una alerta CRITICA si en 5 minutos la carga de CPU es de 90% o más o una alerta PRECAUCIÓN (WARNING) si en 5 minutos la carga es de 80% o más.


define service{
 use   generic-service
 host_name   winserver
 service_description CPU Load
 check_command  check_nt!CPULOAD!-l 5,80,90
 }

Agregue la siguiente definición de servicio para monitorear el uso de memoria del servidor Windows y generar una alerta CRITICA si el uso de memoria es de 90% o más y una alerta de PRECAUCIÓN (WARNING) si el uso de memoria es de 80% o más.


define service{
 use   generic-service
 host_name   winserver
 service_description Memory Usage
 check_command  check_nt!MEMUSE!-w 80 -c 90
 }

Agregue la siguiente definición de servicio para monitorear el uso en el disco C:\ del servidor Windows y generar una alerta CRITICA si el uso en disco es de 90% o más y una alerta de PRECAUCIÓN (WARNING) si el uso en disco es de 80% o mas.


define service{
 use   generic-service
 host_name   winserver
 service_description C:\ Drive Space
 check_command  check_nt!USEDDISKSPACE!-l c -w 80 -c 90
 }

Agregue la siguiente definición de servicio para monitorear el estado del servicio W3SVC en una máquina Windowsy generar una alerta CRITICA si el servicio es detenido.



define service{
 use   generic-service
 host_name   winserver
 service_description W3SVC
 check_command  check_nt!SERVICESTATE!-d SHOWALL -l W3SVC
 }

Agregue la siguiente definición de servicio para monitorear el proceso Explorer.exe de una máquina Windowsy generar una alerta CRITICA si el proceso no se esta ejecutando.


define service{
 use   generic-service
 host_name   winserver
 service_description Explorer
 check_command  check_nt!PROCSTATE!-d SHOWALL -l Explorer.exe
 }

Eso es todo por ahora. Usted a agregado algunos servicios básicos que deben ser monitoreados en un máquina Windows. Grabe el archivo de configuración.

Protección con Contraseña

Si usted especificó una contraseña en el archivo de configuración de NSClient++ para una máquina Windows, usted necesita modificar la definición del comando check_nt para incluir la contraseña. Abra el archivo commands.cfg para editarlo.


vi /usr/local/nagios/etc/commands.cfg

Cambie la definición del comando check_nt para incluir el argumento "-s <PASSWORD>" (donde PASSWORD es la contraseña que se especifico en la máquina Windows) así:


define command{
 command_name check_nt
 command_line $USER1$/check_nt -H $HOSTADDRESS$ -p 12489 -s PASSWORD -v $ARG1$ $ARG2$
 }

Grabe el archivo.

Reiniciando Nagios

Usted ya terminó de modificar la configuración de Nagios, por lo cual usted necesita verificar sus archivos de configuración y reiniciar Nagios.

Si el proceso de verificación produce un error, arregle los archivos de configuración antes de continuar. Asegurese de no reiniciar Nagios hasta que el proceso de verificación se complete sin errores!

Actualización de versiones previas

2009-03-31T16:24:00.001-07:00

Contents
Actualizando desde versiones previas de Nagios 3.x
Actualizando desde Nagios 2.x
Actualizando desde una instalación RPM

Actualizando desde versiones previas de Nagios 3.x
Cuando versiones nuevas alfa, beta, y estable de Nagios 3.x estan disponibles, se le recomienda a usted actualizar lo más rapido posible. Nuevas versiones usualmente contienen parches para fallas criticas, por lo cual es muy importante que esté al día. Asumiendo que usted instaló Nagios desde el código fuente como esta explicado en las guías de configuración rápida, usted puede instalar nuevas versiones de Nagios 3.x facilmente. Usted no necesita acceso como root para hacerlo, dado que todo lo necesario por hacer como root es realizado en la instalación. Aquí esta el proceso para actualización...

Asegurese que tiene un buen respaldo de su instalación y archivos de configuración de Nagios. Si algo sale mal o no funciona, esto permitira a usted poder regresar a su antigua versión.

Cambiese al usuario Nagios. Usuarios de Debian/Ubuntu deberan utilizar sudo -s nagios.


su -l nagios

Baje el archivo comprimido con el código fuente de la última versión de Nagios (visite http://www.nagios.org/download/ para la útlima versión).


wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.x.tar.gz

Extraiga el código fuente de Nagios.


tar xzf nagios-3.x.tar.gz
cd nagios-3.x

Ejecute el script de configuración de Nagios, pasando el nombre del grupo usado para controlar los permisos del archivo de comandos externos:


./configure --with-command-group=nagcmd

Compile el código fuente de Nagios.


make all

Instale binarios actualizados, documentacion e interfaz web. Sus archivos de configuración no seran sobreescritos por este paso.


make install

Verifique sus archivos de configuracion y reinicie Nagios.


/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg
/sbin/service nagios restart

Eso es todo - Usted terminó!

Actualizando desde Nagios 2.x
No debe de ser complicado actualizar de Nagios 2.x a Nagios 3. La actualización es esencialmente la misma que fue descrita anteriormente para actualizar a versiones nuevas de Nagios 3.x. You will, however, have to change your configuration files a bit so they work with Nagios 3:

La antigua variable service_reaper_frequency en el archivo principal de configuración ha sido renombrada a check_result_reaper_frequency.

La antigua macro $NOTIFICATIONNUMBER$ ha sido modificada para dar lugar a las nuevas macros $HOSTNOTIFICATIONNUMBER$ y $SERVICENOTIFICATIONNUMBER$.

La antigua directiva parallelize en definición de servicios ha sido eliminada y no sera utilizada más, esto por que todas las revisiones de servicios se hacen de forma paralela.

La antigua opción aggregate_status_updates ha sido elimininada. Todas las actualizaciones del archivo de status han sido agregadas a un intervalo minimo de 1 segundo.

Las definiciones Extended host and extended service estan descontinuadas. Siguen siendo leidas y procesadas por Nagios, pero es recomendable que mueva las directivas encontradas en estas definiciones a sus definiciones de equipos y servicios respectivamente.

La variable de archivo downtime_file en el archivo de configuración principal ya no es soportado, dado que las entradas de tiempo de inactividad programado son grabadas en el archivo de retención (retention_file). Para preservar las entradas existentes de tiempo de inactividad, pare Nagios 2.x y agregue el contenido del archivo de tiempo de inactividad a el archivo de retención (retention_file).

La variable de archivo downtime_file en el archivo de configuración principal ya no es soportado, por lo cual los comentarios ahora son grabados en el archivo de retención (retention file). Para preservar los comentarios existentes, pare Nagios 2.x y agregue el contenido del archivo de comentarios en el archivo de retención.

Tambien este seguro de leer la sección de la documentación "Que hay de nuevo". Describe todos los cambios al código de Nagios 3 que se han hecho desde la última version estable de Nagios 2.x. Algo a cambiado, por lo cual asegurese de leerlo.

Actualizando desde una instalación RPM
Si actualmente usted tiene una isntalación de Nagios basada en paqueteria RPM- o Debian/Ubuntu y usted quiere realizar la transición de instalar Nagios desde el código fuente oficial, aquí está un proceso básico a seguir:

Respalde su instalación de Nagios

Archivos de configuración

Archivo principal de configuración (usualmente nagios.cfg)

Archivo de configuración de recursos (usualmente resource.cfg)

Archivo de configuración CGI (usualmente cgi.cfg)

Todos los archivos de definición de objetos

Archivo de Retención (usualmente retention.dat)

El archivo de registros actual de Nagios (usualmente nagios.log)

Archivos de registros de Nagios guardados

Desinstale el paquete original RPM o APT

Instale Nagios desde el código fuente como viene en las guías de configuración rápida

Reestablesca sus archivos de configuración originales, archivo de retención y archivos de registro

Verifique su configuración e inicie Nagios

Note que los diferentes paquetes RPM o APT pueden instalar Nagios en diferentes formas y en diferentes rutas. Asegurese de tener respaldados todos sus archivos criticos de Nagios antes de eliminar los paquetes RPM o APT, de tal forma que pueda revertir la instalación en caso de que algo salga mal.

Acerca de

2009-03-31T16:22:00.001-07:00

¿Qué es Nagios?

Nagios® es una aplicación para monitoreo de sistemas y redes.
Revisa equipos y servicios que uno mismo le especifica, alertandonos cuando algo esta mal y cuando esta bien.
Algunas de las características con las que cuenta son:

Monitorear servicios de red (SMTP, POP3, HTTP, PING, etc.)

Monitorear recursos de los hosts (carga de procesador, uso de disco, etc.)

Diseño simple de plugins para que podamos crear los nuestros a nuestras necesidades especificas.

Habilidad de definir una jerarquía de hosts usando la opciòn parent.

Notificaciones a contactos cuando un servicio o host tenga problemas y puedan resolverlo (email, pager o definido por el usuario).

Rotación de log automática.

Etc.

¿Requisitos Requerimientos del sistema:
Cualquier equipo que este ejecutando Linux o una variante de Unix y con compilador C, y preferentemente que tenga:

1. Un Web server (Apache el ideal)
2. Thomas Boutell's GD library esto para el statusmap y trends

Licencia:
Nagios esta bajo la GNU General Public License versión 2 publicada por la Free Software Foundation. Esto le da permiso legal de copiar, distribuir y/o modificar Nagios bajo ciertas condiciones. Lea el archivo 'LICENSE' en la distribución de Nagios o lea la versión en línea para mayores detalles.

Nagios es proporcionado COMO ES sin NINGUNA GARANTÍA DE NINGUN TIPO, INCLUYENDO GARANTÍA DE DISEÑO, COMERCIALIZACIÓN Y ADECUARSE PARA UN PROPOSITO EN PARTICULAR.

Reconocimientos
Muchas personas han contribuido a Nagios ya sea reportando 'bugs', sugerencias de mejora, escribiendo plugins, etc. Una lista de algunos contribuidores en el desarrollo de Nagios pueden ser localizados en http://www.nagios.org.

Bajar la última versión
Usted puede revisar las nuevas veriones de Nagios en http://www.nagios.org.

Nagios y el logo de Nagios son marcas registradas de Ethan Galstad. Todas las demas marcas registradas, marcas de servicio, etc. son propiedad de sus respectivos dueños.

Ubuntu Guía Rápida (Quickstart)

2009-03-31T16:10:00.003-07:00

Introduction
Esta guía esta pensada para proveerle simples instrucciones de como instalara Nagios desde código fuente en Ubuntu y tener monitoreando su máquina local en 20 minutos. Opciones de instalación avanzadas no son discutidas aquí - solo lo básico que funcionara para el 95% de usuarios que desen empezar.

Estas instrucciones fueron escritas basadas en la distribución Linux (Escritorio) Ubuntu 6.10. Debe funcionar tambien en Ubuntu 7.10.

Lo que usted logrará obtener

Si usted sigue estas instrucciones, esto es lo que lograra obtener:

Nagios y los plugins serán instalados bajo /usr/local/nagios

Nagios sera configurado para que empiece a monitorear algunos aspectos de su sistema local (carga de CPU, uso en disco, etc.)

La interfaz WEB de Nagios sera accesada en http://localhost/nagios/

Paquetes Requeridos

Revise que tenga los siguientes paquetes instalados en su instalación de Ubuntu antes de continuar.

Apache 2

Compilador GCC y librerias de desarrollo

Librerias de desarrollo GD

Puede utilizar apt-get para instalar estos paquetes utilizando los siguientes comandos:

sudo apt-get install apache2
sudo apt-get install build-essential

Con Ubuntu 6.10, instale la libreria gd2 con este comando:

sudo apt-get install libgd2-dev

Con Ubuntu 7.10, el nombre de la libreria gd2 a cambiado, por lo cual usted necesitara utilizar el siguiente:

sudo apt-get install libgd2-xpm-dev

1) Crear información de la cuenta

Cambiar a usuario root.

sudo -s

Crear usuario nuevo nagios y proporcionarle una contraseña.

/usr/sbin/useradd -m nagios
passwd nagios

En Ubuntu server edition (6.01 y posiblemente en nuevas versiones), usted necesitara agregar el grupo nagios (no es creado por default). Usted podra saltar este paso en ediciones 'desktop' de Ubuntu.

/usr/sbin/groupadd nagios
/usr/sbin/usermod -G nagios nagios

Crear un grupo nuevo nagcmd para permitir que comandos externos sean ingresados por medio de la interfaz web. Agregar tanto el usuario nagios como el usuario apache al grupo.

/usr/sbin/groupadd nagcmd
/usr/sbin/usermod -G nagcmd nagios
/usr/sbin/usermod -G nagcmd www-data

2) Bajar Nagios y los Plugins

Crear un directorio para guardar los archivos.

mkdir ~/downloads
cd ~/downloads

Bajar el código fuente comprimido de ambos, tanto Nagios como los plugins de Nagios (visitar http://www.nagios.org/download/ para enlaces de las últimas versiones). Al momento de escribir, las ultimas versiones de Nagios y los plugins de Nagios fueron 3.0.3 and 1.4.11, respectivamente.

wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.2.tar.gz
wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz

3) Compile e instale Nagios

Extraiga el código fuente del archivo comprimido de Nagios.

cd ~/downloads
tar xzf nagios-3.0.3.tar.gz
cd nagios-3.0.3

Ejecute el script de configuración de Nagios, pasando el nombre del grupo que usted creo anteriormente:

./configure --with-command-group=nagcmd

Compile el código fuente de Nagios.

make all

Instale los binarios, el script de inicio, archivos de configuración de ejemplo y otorge permisos en el directorio de comandos externos.

make install
make install-init
make install-config
make install-commandmode

No inicie Nagios todavia - hay más cosas que hacer antes de hacerlo...

4) Personalice la configuración

Archivos de configuración de ejemplo han sido instalados en el directorio /usr/local/nagios/etc. Estos archivos de ejemplo deben de trabajar adecuadamente para empezar a utilizar Nagios. Usted necesita realizar un cambio más antes de proceder...

Edite el archivo de configuración /usr/local/nagios/etc/objects/contacts.cfg con su editor favorito y cambie la dirección de correo que esta asociada con el contacto nagiosadmin con la dirección de correo donde desea recibir las alertas.

vi /usr/local/nagios/etc/objects/contacts.cfg

5) Configure la interfaz WEB

Instale el archivo de configuración web en el directorio conf.d de Apache.

make install-webconf

Creamos la cuenta nagiosadmin para entrar a la interfaz web de Nagios. Recuerde la contraseña que asigno a esta cuenta - la necesitará después.

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

Reinicie Apache para que la nueva configuración tome efecto.

/etc/init.d/apache2 reload

6) Compile e instalelos Plugins de Nagios

Extraiga los plugins de Nagios del archivo comprimido.

cd ~/downloads
tar xzf nagios-plugins-1.4.11.tar.gz
cd nagios-plugins-1.4.11

Compile e instale los plugins.

./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
make install

7) Start Nagios

Configure Nagios para que automaticamente se ejecute cuando el sistema inicie.

ln -s /etc/init.d/nagios /etc/rcS.d/S99nagios

Revise los archivos de configuración de ejemplo de Nagios.

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

Si no hay errores, inicie Nagios.

/etc/init.d/nagios start

8) Login a la interfaz WEB

Ahora usted podra accesar a la interfaz web de Nagios por medio de la dirección en la parte inferior. Le será solicitado el usuario (nagiosadmin) y la contraseña que especifico anteriormente.

http://localhost/nagios/

sudo apt-get install mailx

Usted necesita editar los comandos de Nagios para la notificación por correo electrónico localizados en /usr/local/nagios/etc/objects/commands.cfg y cambiar cualquier '/bin/mail' a '/usr/bin/mail'. Una vez hecho esto usted necesita reiniciar Nagios para que los cambios en la configuración tomen efecto.

sudo /etc/init.d/nagios restart

Configurar notificaciones por correo electrónico estan fuera de revisión en esta documentación. Verifique la documentación de su sistema, busque en la web, o vea en el NagiosCommunity wiki para instrucciones especificas en como configurar su sistema Ubuntu para enviar notificaciones por correo electrónico a direcciones externas.

openSUSE Guía Rápida (Quickstart)

2009-03-31T16:10:00.001-07:00

Introducción

Esta guía esta pensada para proveerle simples instrucciones de como instalara Nagios desde código fuente en Fedora y tener monitoreando su máquina local en 20 minutos. Opciones de instalación avanzadas no son discutidas aquí - solo lo básico que funcionara para el 95% de usuarios que desen empezar.

Estas instrucciones fueron escritas basadas en la distribución Linux openSUSE 10.2.

Paquetes Necesarios

Revise que tiene instalados los siguientes paquetes en su instalación de openSUSE antes de continuar. Puede utilizar yast para instalar los paquetes en openSUSE.

apache2

C/C++ librerias de desarrollo

1) Crean información de la cuenta

Cambiar a usuario root.

su -l

Crear una nuevo usuario nagios y asignarle una contraseña.

/usr/sbin/useradd -m nagios
passwd nagios

Crear un grupo nagios. Agregar el usuario nagios a este grupo.

/usr/sbin/groupadd nagios
/usr/sbin/usermod -G nagios nagios

Crear un nuevo grupo nagcmd para permitir que comandos externos sean ingresados por medio de la interfaz web. Agregar tanto el usuario nagios como el usuario apache al grupo.

/usr/sbin/groupadd nagcmd
/usr/sbin/usermod -G nagcmd nagios
/usr/sbin/usermod -G nagcmd wwwrun

2) Bajar Nagios y los Plugins

Crear un directorio para guardar los archivos.

mkdir ~/downloads
cd ~/downloads

wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.2.tar.gz
wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz

3) Compile e instale Nagios

Extraiga el código fuente del archivo comprimido de Nagios.

cd ~/downloads
tar xzf nagios-3.0.2.tar.gz
cd nagios-3.0.2

Ejecute el script de configuración de Nagios, pasando el nombre del grupo que usted creo anteriormente:

./configure --with-command-group=nagcmd

Compile el código fuente de Nagios.

make all

Instale los binarios, el script de inicio, archivos de configuración de ejemplo y otorge permisos en el directorio de comandos externos.

make install
make install-init
make install-config
make install-commandmode

No inicie Nagios todavia - hay más cosas que hacer antes de hacerlo...

4) Personalice la configuración

Archivos de configuración de ejemplo han sido instalados en el directorio /usr/local/nagios/etc. Estos archivos de ejemplo deben de trabajar adecuadamente para empezar a utilizar Nagios. Usted necesita realizar un cambio más antes de proceder...

Edite el archivo de configuración /usr/local/nagios/etc/objects/contacts.cfg su editor favorito y cambie la dirección de correo que esta asociada con el contacto nagiosadmin con la dirección de correo donde desea recibir las alertas.

vi /usr/local/nagios/etc/objects/contacts.cfg

5) Configure la interfaz WEB

Instale el archivo de configuración web en el directorio conf.d de Apache.

make install-webconf

Creamos la cuenta nagiosadmin para entrar a la interfaz web de Nagios. Recuerde la contraseña que asigno a esta cuenta - la necesitará después.

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

Reinicie Apache para que la nueva configuración tome efecto.

service apache2 restart

6) Compile e instalelos Plugins de Nagios

Extraiga los plugins de Nagios del archivo comprimido.

cd ~/downloads
tar xzf nagios-plugins-1.4.11.tar.gz
cd nagios-plugins-1.4.11

Compile e instale los plugins.

./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
make install

7) Inicie Nagios

Agregue a Nagios a la lista de servicios del sistema y asi se ejecute automaticamente cuando el sistema inicie.

chkconfig --add nagios
chkconfig nagios on

Revise los archivos de configuración de ejemplo de Nagios.

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

Si no hay errores, inicie Nagios.

service nagios start

9) Login a la interfaz WEB

Ahora usted podra accesar a la interfaz web de Nagios por medio de la dirección en la parte inferior. Le será solicitado el usuario (nagiosadmin) y la contraseña que especifico anteriormente.

http://localhost/nagios/

Abra el control center

Seleccione 'Open Administrator Settings' para abrir el YaST administrator control center

Seleccione 'Firewall' desde la categoria 'Security and Users'

De click en la opción 'Allowed Services' en la configuración del Firewall Configuration
Agregue 'HTTP Server' a la lista de servicios permitidos en la 'External Zone'

De click 'Next' y 'Accept' para activar las nuevas configuraciones del firewall

Configurar notificaciones por correo electrónico estan fuera de revisión en esta documentación. Verifique la documentación de su sistema, busque en la web, o vea en el NagiosCommunity wiki para instrucciones especificas en como configurar su sistema openSUSE para enviar notificaciones por correo electrónico a direcciones externas.

Fedora Guía Rápida (Quickstart)

2009-03-31T16:09:00.001-07:00

Introducción

Esta guía esta pensada para proveerle simples instrucciones de como instalara Nagios desde código fuente en Fedora y tener monitoreando su máquina local en 20 minutos. Opciones de instalación avanzadas no son discutidas aquí - solo lo básico que funcionara para el 95% de usuarios que desen empezar.

Estas instrucciones fueron escritas basadas en la distribución Linux Fedora Core 6.

Lo que usted logrará obtener

Si usted sigue estas instrucciones, esto es lo que lograra obtener:

Nagios y los plugins serán instalados bajo /usr/local/nagios

Nagios sera configurado para que empiece a monitorear algunos aspectos de su sistema local (carga de CPU, uso en disco, etc.)

La interfaz WEB de Nagios sera accesada en http://localhost/nagios/

Prerequisitos

En algunas etapas de la instalación usted necesitara acceso como root al equipo.

Revise que tenga los siguientes paquetes instalados en su instalación de Fedora antes de continuar.

Apache

Compilador GCC

GD librerias de desarrollo

Puede utilizar yum para instalar los siguientes paquetes con los comandos mencionados a continuación (como root):

yum install httpd
yum install gcc
yum install glibc glibc-common
yum install gd gd-devel

1) Crear información de la cuenta

Cambiar a usuario root.

su -l

Crear usuario nuevo nagios y proporcionarle una contraseña.

/usr/sbin/useradd -m nagios
passwd nagios

Crear un grupo nuevo nagcmd para permitir que comandos externos sean ingresados por medio de la interfaz web. Agregar tanto el usuario nagios como el usuario apache al grupo.

/usr/sbin/groupadd nagcmd
/usr/sbin/usermod -G nagcmd nagios
/usr/sbin/usermod -G nagcmd apache

2) Bajar Nagios y los Plugins

Crear un directorio para guardar los archivos.

mkdir ~/downloads
cd ~/downloads

wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.2.tar.gz
wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz

3) Compile e instale Nagios

Extraiga el código fuente del archivo comprimido de Nagios.

cd ~/downloads
tar xzf nagios-3.0.3.tar.gz
cd nagios-3.0.3

Ejecute el script de configuración de Nagios, pasando el nombre del grupo que usted creo anteriormente:

./configure --with-command-group=nagcmd

Compile el código fuente de Nagios.

make all

Instale los binarios, el script de inicio, archivos de configuración de ejemplo y otorge permisos en el directorio de comandos externos.

make install
make install-init
make install-config
make install-commandmode

vi /usr/local/nagios/etc/objects/contacts.cfg

5) Configure la interfaz WEB
Instale el archivo de configuración web en el directorio conf.d de Apache.

make install-webconf

Creamos la cuenta nagiosadmin para entrar a la interfaz web de Nagios. Recuerde la contraseña que asigno a esta cuenta - la necesitará después.

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

Reinicie Apache para que la nueva configuración tome efecto.

service httpd restart

6) Compile e instalelos Plugins de Nagios

Extraiga los plugins de Nagios del archivo comprimido.

cd ~/downloads
tar xzf nagios-plugins-1.4.11.tar.gz
cd nagios-plugins-1.4.11

Compile e instale los plugins.

./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
make install

7) Inicie Nagios

Agregue a Nagios a la lista de servicios del sistema y asi se ejecute automaticamente cuando el sistema inicie.

chkconfig --add nagios
chkconfig nagios on

Revise los archivos de configuración de ejemplo de Nagios.

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

Si no hay errores, inicie Nagios.

service nagios start

8) Modifique la configuración de SELinux

Fedora viene con SELinux (Security Enhanced Linux) instalado y en Enforcing mode por default. Esto puede mostrar el mensaje "Internal Server Error" cuando intente ingresar a los Nagios CGIs.

Verificar si SELinux está en modo Enforcing.

getenforce

Cambiar SELinux a modo Permissive.

setenforce 0

Para hacer este cambio permanente, usted necesita modificar la configuración en /etc/selinux/config y reiniciar.

En lugar de deshabilitar SELinux o configurarlo para modo permissive, usted puede utilizar el siguiente comando para ejecutar CGIs bajo SELinux modo enforcing/targeted:

chcon -R -t httpd_sys_content_t /usr/local/nagios/sbin/
chcon -R -t httpd_sys_content_t /usr/local/nagios/share/

Para información de como ejecutar Nagios CGIs bajo modo Enforcing con una poliza targeted, visite el wiki de NagiosCommunity.org en http://www.nagioscommunity.org/wiki.

9) Login a la interfaz WEB

Ahora usted podra accesar a la interfaz web de Nagios por medio de la dirección en la parte inferior. Le será solicitado el usuario (nagiosadmin) y la contraseña que especifico anteriormente.

http://localhost/nagios/

De click en el link navbar "Service Detail" para ver detalles de lo que esta siendo monitoreado en la máquina local. Tomara algunos minutos a Nagios para revisar todos los servicios asociados con su máquina, mientras las revisiones sean realizadas a su tiempo.
10) Otras Modificaciones

Asegurese que las reglas de firewall en su máquina estan configuradas para permitir el acceso al servidor web si desea que la interfaz de Nagios sea accesada remotamente.

Configurar notificaciones por correo electrónico estan fuera revisión en esta documentación. Mientras Nagios es actualmente configurado para enviar notificaciones por correo electrónico, su sistema tal vez no tenga un programa de correo instalado y configurado adecuadamente. Verifique la documentación de su sistema, busque en la web, o vea en el NagiosCommunity.org wiki para instrucciones especificas de como configurar su sistema para enviar correos electrónicos a direcciones externas. Mayor información en notificaciones pueden ser encontradas aquí.
11) Usted esta listo

Felicidades! usted acaba de instalar Nagios satisfactoriamente. Su viaje dentro del monitoreo apenas empieza. Tal vez no dude en monitorear más que su equipo local, por lo cual revise los siquientes documentos...

Monitoreando equipos con Windows

Monitoreando equipos con Linux/Unix

Monitoreando equipos con Novell Netware

Monitoreando impresoras

Monitoreando routers/switches

Monitoreando servicios publicamente disponibles (HTTP, FTP, SSH, etc.)

Guias de Instalación Rápida - Nagios 3.x

2009-03-31T16:08:00.000-07:00

Introducción

Estas guías (Quickstart) estan pensadas para proveerle instrucciones simples de como instalar Nagios desde código fuente y tener monitoreando la máquina local dentro de 20 minutos. Opciones de instalación avanzadas no son discutidas aquí - solo lo básico que funcionara para el 95% de usuarios que desen empezar.

Guias

Las guías de instalación rápida estan actualmente disponibles para las siguientes distribuciones de Linux:

Fedora Quickstart

openSUSE Quickstart

Ubuntu Quickstart

Usted puede encontrar guías rápidas adicionales en NagiosCommunity.org wiki. ¿No puede encontrar una guía para su SO en particular?, escriba una y añadala al wiki para beneficio de otros.

Si esta instalando Nagios en un sistema operativo o distribución de Linux que no esta listada arriba, lea la guía de Fedora para una revision de lo que usted necesita hacer. Comandos, rutas, etc. varian a traves de los diferentes SOs/distribuciones, por lo cual tal vez tenga que modificar un poco la forma de instalación que viene en los documentos para que funcione en su caso particular.

Modificaciones después de la instalación

Una vez que tenga Nagios instalado y corriendo adecuadamente, no dudamos que usted desee monitorear más que su máquina local. Por favor revise los siguientes documentos para saber como monitorear otras cosas...

Monitoreando equipos con Windows

Monitoreando equipos con Linux/Unix

Monitoreando equipos con Novell Netware

Monitoreando impresoras

Monitoreando routers/switches

Monitoreando servicios publicamente disponibles (HTTP, FTP, SSH, etc.)

Nagios via WEB

2009-03-31T16:07:00.003-07:00

Si, soy un "lazy admin" y?, bueno, para aquellos que son como yo aquí les va como configurar el paquete Fruity para hacer la configuración de su Nagios via WEB.

1.- Importante tener lo siguiente en nuestro servidor donde esta Nagios:
Apache. (yo tengo el 2)
PHP 5.x Esto por soporte orientado a objetos
- PHP MySQL
- PHP Session
MySQL
- 4.1 para arriba
Nagios 2.x

2.- Bajamos Fruity.
3.- Extraemos Fruity en nuestro directorio WEB (i.e. /var/www/htdocs/fruity).
4.- Creamos un symlink o copiamos el directorio de iconos de logos en el directorio fruity con el nombre de logos (i.e. /usr/local/nagios/share/images/logos).
5.- Creamos base de datos en MySQL (fruity) e importamos el archivo que esta en sqldata/fruity-mysql.sql.
6.- Configuramos el archivo config.inc en el directorio includes según nuestras necesidades ya que aqui va el path de fruity, el usuario, password y base de datos de MySQL.
7.- Vamos a /fruity/ de nuestro servidor para empezar a usar Fruity.

Esta versión es Beta, pero funciona, cualquier comentario que tengan sobre esta aplicación haganla llegar.

External Command File

2009-03-31T16:07:00.001-07:00

En este apartado les explicaré brevemente que hace este archivo, ya que realicé una migración de Nagios a otro servidor y no me acordaba de este archivo.

El External Command File es un archivo externo el cual Nagios revisa por comandos externos a procesar. El commando CGI escribe directamente al archivo. Es creado cuando Nagios es ejecutado y es destruido cuando Nagios deja de ejecutarse. Su definición esta en nagios.cfg.

Format: command_file=
Example: command_file=/usr/local/nagios/var/rw/nagios.cmd

Ahora, vamos a arreglar todo para que no tengamos problemas al querer ejecutar comandos desde la página WEB de Nagios.

Primero verificamos en que grupo corre nuestro servidor WEB (nobody, apache, etc), que usuario esta ejecutando Nagios (por lo regular es nagios) y debemos crear un grupo para Nagios, puede ser nagios o nagioscmd, en este ejemplo usamos nagios, por lo regular según tu instalación ya estará creado.

Si no esta creado ejecutamos el siguiente commando.


isuraeru@isuraeru:~> /usr/sbin/groupadd nagios

Despues agregamos el grupo WEB al grupo de Nagios


isuraeru@isuraeru:~> /usr/sbin/usermod -G nagios apache

Despues verificamos si existe el directorio rw en nuestro directorio var:

i.e. /usr/local/nagios/var/rw

Si no existe adivinen que, pues lo creamos.

En caso de que ya exista confirmamos que tenga los siguientes permisos:


isuraeru@isuraeru:~> drwxrws---   2 nagios nagios     1024 Aug 11 16:30 rw

Si no existe hacemos estos movimientos:


isuraeru@isuraeru:~> mkdir /usr/local/nagios/var/rw
isuraeru@isuraeru:~> chown nagios.nagios /usr/local/nagios/var/rw
isuraeru@isuraeru:~> chmod u+rwx /usr/local/nagios/var/rw
isuraeru@isuraeru:~> chmod g+rwx /usr/local/nagios/var/rw
isuraeru@isuraeru:~> chmod g+s /usr/local/nagios/var/rw

Verificamos los permisos


isuraeru@isuraeru:~> drwxrws---   2 nagios nagios    1024 Aug 11 16:30 rw

Reiniciamos el servidor WEB y listo, solo vamos a cualquier equipo y en la sección de Host Commands podemos ejecutar cualquiera, tambien en los servicios.

NRPE

2009-03-31T16:05:00.000-07:00

Introducción

Este pequeño daemon te permite ejecutar plugins locales en equipos remotos de equipos Linux, como es esto, el plugin check_nrpe es llamado por Nagios y hace las peticiones de los plugins hacia el equipo remoto, requiere que NRPE este siendo ejecutado en ese equipo como un standalone daemon o como un servicio en inetd, tambien soporta encriptación nativa de SSL/TLS.
Hay una versión para Win2 pero la verdad opte por nsclient o nc_net.

NOTA - La última versión es la 2.0 y es incompatible con las versiones 1.x, tanto para clientes como servidores.

Aquí explicare de manera básica sus archivos y su funcionamiento.

En el paquete de NRPE pueden encontrar los siguientes archivos:

NRPE - Este es el programa que se ejecuta como proceso en el background en los equipos remotos y procesa las peticiones de ejecución de comandos del plugin check_nrpe del equipo donde esta Nagios. Recibe la petición del equipo autorizado, procesa la información del command line asociado con el comando que recibe y envia la información solicitada al plugin check_nrpe.

check_nrpe - Este es el plugin que se ejecuta en el equipo donde esta Nagios y es utilizado para contactar el proceso NRPE en los equipos remotos. Este plugin solicita al plugin remoto a ejecutarse en el equipo y espera que el proceso de NRPE se ejcuta y regrese la informacion solicitada.

Compilar

Sencillo, simplemente descompriman el paquete y ejecuten:


isuraeru@localhost$ ./configure
isuraeru@localhost$ make all

IMPORTANTE - El daemon NRPE debe ser compilado en el equipo remoto.

Instalación

Solo copiar el archivo check_nrpe en /usr/local/nagios/plugins o dependiendo donde tengan sus plugins.
En el caso del equipo remoto deben tener el daemon NRPE en donde tienen sus daemons i.e. /etc/rc.d/nrpe y tambien el archivo nrpe.cfg i.e. /etc/nrpe.cfg.

Ejecutando bajo inetd o xinetd

Asi es como lo tengo configurado y me funciona muy bien tenemos que ejecutar nrpe bajo inetd o xinetd y hacemos uso de los TCP wrappers, realizamos lo siguiente:

1.- Agregamos una linea en /etc/services como la siguiente:

nrpe 5666/tcp # NRPE

2.- Despues configuramos las entradas del daemon NRPE ya sea en inetd o xinetd, yo utilice inetd
NOTA - Si ejecutamos nrpe en inetd o xinetd, las variables server_port y allowed_hosts en el archivo de configuración del nrpe serán ignoradas.

Inetd

Si nuestro sistema utiliza inetd CON tcpwrappers agregamos la siguiente entrada en /etc/inetd.conf:

nrpe stream tcp nowait [user] /usr/sbin/tcpd [nrpebin] -c [nrpecfg] --inetd

Si nuestro sistema utiliza inetd SIN tcpwrappers agregamos la siguiente entrada en /etc/inetd.conf:

nrpe stream tcp nowait [user] [nrpebin] -c [nrpecfg] --inetd

Solamente reemplazamos user por el usuario que el servidor nrpe sera ejecutado. i.e. nagios.

nrpebin con el path del binario de nrpe i.e. /usr/local/nagios/nrpe

nrpecfg con el path del archivo de configuracion de nrpe i.e. /usr/local/nagios/nrpe.cfg o /etc/nrpe.cfg.

Xinetd

Si nuestro sistema utiliza xinetd en vez de inetd creamos un archivo llamado nrpe en /etc/xinetd.d conteniendo lo siguiente:


# default: on
        # description: NRPE
        service nrpe
        {
                flags           = REUSE
                socket_type     = stream
                wait            = no
                user            = [user]
                server          = [nrpebin]
                server_args     = -c [nrpecfg] --inetd
                log_on_failure  += USERID
                disable         = no
                only_from       = [ipaddress1] [ipaddress2] ...
        }

Reemplazamos user por el usuario que el servidor nrpe sera ejecutado. i.e. nagios.

nrpebin con el path del binario de nrpe i.e. /usr/local/nagios/nrpe

nrpecfg con el path del archivo de configuracion de nrpe i.e. /usr/local/nagios/nrpe.cfg o /etc/nrpe.cfg

ipaddress con las direcciones IP de los equipos qu deseamos sean aceptados para conectarse al daemon NRPE. Esto funciona solamente si xinetd fue compilado con soporte para tcpwrappers.

3.- Reiniciamos inetd o xinetd i.e.

isuraeru@localhost# /etc/rc.d/init.d/inet restart

isuraeru@localhost# /etc/rc.d/init.d/xinetd restart

4.- Agregamos entradas en nuestros archivos /etc/hosts.allow y /etc/hosts.deny para habilitar protección TCP wrapper para el servicio nrpe, es opcional pero altamente recomendado.

IMPORTANTE - Los plugins que se deseen ejecutar en el equipo remoto forzosamente deben estar en ese equipo por i.e. yo tengo un equipo que ejecuto check_procs, check_users y check_cpu los cuales los tengo en /usr/local/nagios/libexec y deben de ser propiedad de nagios.nagios.

OK, todo esto fue para los equipos remotos o clientes, ahora vamos a configurar el equipo donde esta Nagios.

Configuración equipo Nagios

Primeramente ya contamos con un archivo de configuracion nrpe.cfg de ejemplo incluido en el paquete de nrpe el cual va en los equipos remotos ahora definiremos el comando para nrpe ya sea en checkcommands.cfg o commands.cfg dependiendo d cual esten utilizando, el cual podemos declararlo así

define command{
        command_name    check_nrpe
        command_line    /usr/local/nagios/libexec/check_nrpe -H $HOSTADDRESS$ -c $ARG1$
        }

Ahora, para ejecutar este comando en los equipos remotos debemos de crear un servicio para tales equipos por ejemplo

define service{
        host_name               someremotehost
        service_description     someremoteservice
        check_command           check_nrpe!yourcommand
        ... etc ...
        }

En donde yourcommand es el comando que deseamos ejecutar en el equipo remoto i.e. check_procs.

Y listo.
Dudas, ya saben a donde escribir. Saludos.

SNMP

2009-03-31T16:04:00.001-07:00

Introduccion

El Simple Network Managment Protocol (SNMP) es un protocolo de la capa de aplicacion el cual facilita el intercambio de informacion entre los dispositivos de la red, es parte del Transmission Control Protocol/Internet Protocol (TCP/IP).
El protocolo SNMP fue desarrollado en 1988 y se ha convertido en el estandar por defecto para el manejo de la comunicacion. Debido a que es sencillo y facil de desarrollar aplicaciones para el los proveedores de dispositivos pueden facilmente agregar agentes SNMP a sus productos.

Actualmente hay dos versiones de SNMP : SNMP version 1 (SNMPv1) y SNMP version 2 (SNMPv2), las cuales son similares, pero la version 2 tiene mejoras en cuanto a operaciones del protocolo, hay una tercera version la cual tiene pendiente la estandarizacion SNMP Version 3 (SNMPv3), por lo cual nos enfocaremos solo a las primeras versiones.

Componentes basicos y arquitecturas de manejo de red.

Una red manejada por SNMP cuenta con tres componentes clave para su funcionamiento : Dispositivos manejados (Managed Devices), Agentes (Agents) y Sistemas de manejo de red (network-management systems (NMSs)).

Un managed device es un nodo en la red el cual contiene un agente SNMP, pueden colectar y guardar informacion de manejo y ponen esta informacion disponible a los NMS de la red usando SNMP, estas entidades pueden ser Bridges, hubs, switches, servidores de red, etc. estos son unos ejemplos y tambien suelen ser llamados elementos de red.

Un Agent es un modulo de software de manejo de red que esta en un managed device, tiene conocimiento local de informacion de manejo y traduce esa informacion en forma compatible para SNMP.

Un NMS ejecuta aplicaciones que monitorean y controlan los managed devices. NMS provee la informacion de los recursos de procesamiento y de memoria que son requeridos para el manejo de la red. Uno o mas pueden coexistir en la red.

Ok, como utilizo esto en Nagios?

Bueno, ahora vamos a la mejor parte, como utilizar nuestro SNMP en Nagios, no voy a entrar al tema de como configurar el SNMP en Linux.

Primero que nada debemos saber nuestros OIDs (Object Identifiers) para lo que deseamos monitorear, esto lo podemos obtener por medio de un MIB Browser (Managment Information Base), con esto podemos saber lo que deseemos de nuestros equipos, vamos a poner un ejemplo:
Tengo un servidor Windows 2003 Server y quiero saber solamente su uptime, podemos hacer lo siguiente:
1.- Habilitar el servicio de SNMP en el servidor, asignarle nuestra comunidad y permisos necesarios para que solamente nosotros tengamos acceso a esa información.
2.- Agregamos el servicio en Nagios


define service{
         use                             generic-service
         host_name                       myserver
         service_description             Uptime
         is_volatile                     0
         check_period                    24x7
         max_check_attempts              4
         normal_check_interval           8
         retry_check_interval            1
         contact_groups                  nt-admins
         notification_interval           120
         notification_period             24x7
         notification_options            c,r
         check_command                   check_snmp!.1.3.6.1.2.1.1.3.0 # Este es el OID del uptime
        }

3.- Declaramos nuestro comando check_snmp


define command{
command_name    check_snmp
command_line    $USER1$/check_snmp -H $HOSTADDRESS$ -C readonly -o $ARG1$
}

¿Como funciona el comando?, primero le indicamos de que host deseamos la información, la comunidad (-C) y el OID (-o) el cual viene como argumento ($ARG1$), esto quiere decir que puedo declarar otro servicio SNMP y utilizar el mismo comando, solo cambiando el OID o argumento.

Verificamos que no haya ningún error en la configuración y reseteamos el proceso de Nagios.
Y eso estodo, es solamente de jugar con los OIDs.

APAN

2009-03-31T16:02:00.001-07:00

Ahora hablaremos de APAN el cual es una herramienta para ser integrada en Nagios y poder utilizarla para obtener estadísticas del desempeño de nuestros equipos, todo esto en forma gráfica y vía WEB.

Obteniendo Apan y requerimientos previos.

Previamente necesitamos RRDTool instalado para poder continuar, ya que RRDTool es una herramienta para guardar y desplegar datos de tiempo-serie (ejemplo: ancho de banda de una red, temperatura de una maquina en un cuarto, etc., lo bueno de este software es que guarda la información en una forma muy compacta y que a la larga no se expande demasiado y puede usarse vía scripts o frontends.
RRD significa Round Robin Database.

Instalando Apan

Para instalar Apan hacemos lo siguiente

Vamos a nuestro directorio de Nagios (i.e. /usr/local/nagios) y extraemos el archivo de Apan.
Un nuevo directorio es creado llamado apan, solo verificamos que el usuario de Nagios tenga privilegios en
el directorio y que pueda ejecutar el archivo apan-sql.sh

Copiamos los archivos apan-sql.cgi y generate-sql.cgi a el directorio cgi-bin de Nagios (i.e. /usr/local/nagios/sbin), los cuales hacemos ejecutables para el servidor WEB.

Copiamos el archivo graph.png al directorio logos de Nagios (i.e. /usr/local/nagios/share/images/logos).

Configurando Apan.

Primero configuramos el entorno:

Modificamos apan.defs a nuestras necesidades, si tenemos Apan en otro directorio que no sea el /usr/local/nagios/apan-sql tenemos que poner el path de apan.defs en los archivos apan-sql.sh, apan-sql.cgi, generate.cgi y apanconf-sql.
Creamos la base de datos, Apan esta preconfigurado para MySQL pero puede ser portado a otra base modificando sql.conf y createdb.sh.
Debemos tener funcionando MySQL y entramos al mismo como superusuario o usamos cualquier frontend de MySQL como phpMyAdmin, MysqlBrowser, etc. y ejecutamos los siguientes comandos:
create database nagios;
grant all on nagios.* to nagios@localhost identified by 'nagios123';
podemos usar nuestro propio nombre de la base de datos, usuario y contraseña.

Actualizamos el archivo sql.conf con los datos que nosotros proporcionamos en el paso anterior.

Creamos la base de datos ejecutando el archivo createdb.sh

Con Apan viene el script apanconf-sql el cual podemos usarlo para manejar los servicios de Apan, antes de usarlo ocupamos modificarlo a nuestras necesidades:

NAGIOSUSERGROUP : Usuario y grupo de Nagios (default: nagios / nagios)

EXTINFOFILE : El archivo donde serviceextinfo esta guardado. Serviceextinfo es usado para poner un enlace y un icono a un lado del servicio en la interfaz WEB de Nagios. El archivo debe de estar configurado en el archivo cgi.cfg de Nagios usalmente podemos usar el mismo serviceextinfo que ya esta en el directorio etc.

CGIURL: El directorio CGI de Nagios usalmente localizado en nagios/cgi-bin o /usr/local/nagios/sbin.

RRDDIR: El directorio donde estan guardados los archivos RRD generados usualmente en $NAGIOSDIR/rrd. RRDSTEP, RRDDSMIN, RRDDSMAX, RRDDRAWTYPE: Especifica el intervalo base en segundos en el cual los datos seran agregados en los archivos RRD, valores mínimos y máximos y el tipo de línea utlizada para las gráficas. Default 60,0, U y Line2. Para mayor referencia ve el Manual de RRDTool.

RRAS: Archivos Round-Robin predeterminados para nuevos archivos RRD. Valores predeterminados son: RRA:AVERAGE:0.5:1:50400 RRA:AVERAGE:0.5:60:43800
Esto significa un archivo con un promedio de 1 minuto de los ultimos 35 dias y un archivo con promedios de 1 hora de los ultimos 5 años.

HINTS: Para que sea mas facil apanconf despliega los ultimos valores de graph-label, graph-unit y extra arguments de rrdtool, podemos copiarlos y pegarlos cuando queramos crear nuevos servicios. El valor 0 desactiva la funcion.

Asi nos quedaria el check-command para Apan:

Añadiendo Servicios.

Ahora viene lo interesante, agregar servicios de Apan a Nagios.

Para agregar servicios a Nagios hacemos lo siguiente:
Definimos el servicio por ejemplo ping y load:
define service {
host_name server1,server2
service_description Ping
check_command apan-sql!ping!100.0,20%!500.0,60%
name Ping
use generic-service
normal_check_interval 1
}

define service {
host_name server3,server4
service_description Load
check_command apan-sql!load!70!90
use generic-test
normal_check_interval 1
}

Ahora agregamos los servicios en Apan ejecutando apanconfig-sql:
1. Seleccionamos 1 (Agregar nuevo servicio).
2. Escribimos el nombre del equipo (Igual que en Nagios, es sensible mayúsculas y minúsculas).
3. Escribimos el nombre del servicio (El mismo que en service_description en Nagios).
4. Escribimos comentarios adicionales (opcional).
5. Escribimos el nombre del archivo RRD o aceptamos el que esta propuesto.
6. Escribimos el encabezado de la gráfica (graph-label).
7. Escribimos el encabezado de las unidades (graph-unit).
8. Escribimos el valor de los pasos para el RRD o aceptamos el valor propuesto.
9. Escribimos los argumentos extras para rrdtool, por ejemplo "-b 1024" escalara la gráfica a unidades de 1024 en vez de 1000,
"-10" hara que el eje de las y empiecen en cero. Para más referencia de estos valores checa el manual antes mencionado de RRTool.
10. Escribimos un argumento para el plugin (hay ejemplos abajo).
11. Escribimos el nombre del DS que corresponda para el argumento de arriba por ejemplo c-used.
12. Escribimos el tipo de DS el cual puede ser 1 para GAUGE y 2 para COUNTER.
13. Escribimos los valores del heartbeat,min,max y drawing-type o simplemente aceptamos los valores.
14. Escribimos el nombre de el siguiente argumento para ir al paso 11 o simplemente presionamos 11 si ya terminamos.

Para que se entienda mejor esta información, a continuación estan unos ejemplos.

Ejemplos:
Monitorear el uso en disco del drive C en un equipo con Windows.
define service {
host_name winsrv1
service_description Disk usage
check_command apan-sql!disk_by_snmp!90!95
use service-template
}
Ejecutamos apanconf-sql, seleccionamos 1 e introducimos los siguientes valores:
Hostname: winsrv
Service: Disk usage
Graph-label: Disk usage
Graph-unit: %
Argument #1: C
DS-name: C
DS-type: 1
Y presionamos enter cuando nos solicite el sergundo argumento.

Monitorear el trafico de red en un equipo.
Agregamos el servicio a Nagios:
define service {
host_name server2
service_description Net usage
check_command apan-sql!snmpget!10!20
use generic-hl
notifications_enabled service-template
}
Ejecutamos apanconf-sql, seleccionamos 1 e introducimos los siguientes valores:
Hostname: server2
Service: Net usage
Graph-label: Network throughput
Graph-unit: Bytes/sec
Argument #1: public:.1.3.6.1.2.1.2.2.1.16.2
DS-name: IN
DS-type: 2
Argument #2 public:.1.3.6.1.2.1.2.2.1.10.2
DS-name: OUT
DS-type: 2
Cuando solicite el tercer argumento presionamos enter.

Agregamos un icono y un enlace en el archivo serviceextinfo.cfg:
define serviceextinfo{
host_name server
service_description Ping
notes_url /nagios/cgi-bin/apan.cgi?host=server&service=Ping
icon_image graph.png
icon_image_alt View graphs
}

Eso es todo, ya tienen funcionando Apan para crear graficas como esta:

Recuerden que no inmediatamente apareceran datos, se tienen que ir llenando las bases rrd que crearon, pero si alcabo de el tiempo que ustedes especificaron no obtienen información es importante ver si el usuario Nagios tiene permisos en el directorio y archivos de rrd.

Si tienen preguntas envienme un correo, esto me lo avente lo más rápido que pude y todavia no esta completo, faltan más ejemplos.

svc_event_handler-speechd

2009-03-31T16:01:00.005-07:00

#!/bin/sh

#########################################
# Nagios Global Service Event Handler by Isuraeru
# For audio using speechd
# Arguments:
#
# $1 = host short name
# $2 = host alias (long name)
# $3 = service description
# $4 = state
# $5 = state type (HARD or SOFT)
# $6 = current attempt number
#
#########################################

echocmd="/bin/echo"
festivaldev="/dev/speech"

case $5 in
HARD)
case $4 in
OK)
$echocmd "Good news! Service $3 on $2 has RECOVERED!" > $festivaldev
;;
CRITICAL)
$echocmd "Attention... Service $3 on $2 is in a $4 state. Please check service!" > $festivaldev
;;
WARNING)
$echocmd "Attention... Service $3 on $2 is in a $4 state. Please check service!" > $festivaldev
;;
UNKNOWN)
$echocmd "Attention... Service $3 on $2 is in a $4 state. Please check service!" > $festivaldev
;;
esac
;;
SOFT)
# Ignore soft error states
;;
esac

exit 0

svc_event_handler

2009-03-31T16:01:00.003-07:00

#!/bin/sh

#########################################
# Nagios Global Service Event Handler by Isuraeru
# For audio using Festival
# Arguments:
#
# $1 = host short name
# $2 = host alias (long name)
# $3 = service description
# $4 = state
# $5 = state type (HARD or SOFT)
# $6 = current attempt number
#
#########################################

echocmd="/bin/echo"
festival="/path/to/festival/bin/festival"

case $5 in
HARD)
case $4 in
OK)
$echocmd "Good News,,, Service $3 on $2 has RECOVERED" | $festival --tts
;;
CRITICAL)
$echocmd "Attention,,,, Service $3 on $2 is in a $4 state. Please check service!" | $festival --tts
;;
WARNING)
$echocmd "Attention,,,, Service $3 on $2 is in a $4 state. Please check service!" | $festival --tts
;;
UNKNOWN)
$echocmd "Attention,,,, Service $3 on $2 is in a $4 state. Please check service!" | $festival --tts
;;
esac
;;
SOFT)
# Ignore soft error states
;;
esac

exit 0

hst_event_handler-speechd

2009-03-31T16:01:00.001-07:00

#!/bin/sh

#########################################
# Nagios Global Service Event Handler by Isuraeru
# For audio using Speechd
# Arguments:
#
# $1 = host short name
# $2 = host alias (long name)
# $3 = state
# $4 = state type (HARD or SOFT)
# $5 = current attempt number
#
#########################################

echocmd="/bin/echo"
festivaldev="/dev/speech"

case $4 in
HARD)
case $3 in
UP)
$echocmd "Good news! Host $2 has RECOVERED!" > $festivaldev
;;
DOWN)
$echocmd "Attention... Host $2 is $3. This is a critical state. Please check host status!" > $festivaldev
;;
UNREACHABLE)
$echocmd "Attention... Host $2 is $3. This is a critical state. Please check network connectivity!" > $festivaldev
;;
esac
;;
SOFT)
# Ignore soft error states
;;
esac

exit 0

hst_event_handler

2009-03-31T15:59:00.002-07:00

#!/bin/sh

#########################################
# Nagios Global Host Event Handler by Isuraeru
# For Audio Using Festival
#
# Arguments:
#
# $1 = host short name
# $2 = host alias (long name)
# $3 = state
# $4 = state type (HARD or SOFT)
# $5 = current attempt number
#
#########################################

echocmd="/bin/echo"
festival="/path/to/festival/bin/festival"

case $4 in
HARD)
case $3 in
UP)
$echocmd "Host, , , $2 has RECOVERED!" | $festival --tts
;;
DOWN)
$echocmd "Attention, , , , Host $2 is $3. This is a critical state. Please check host status!" | $festival --tts
;;
UNREACHABLE)
$echocmd "Attention, , , , Host $2 is $3. This is a critical state. Please check network connectivity!" | $festival --tts
;;
esac
;;
SOFT)
# Ignore soft error states
;;
esac

exit 0

Instalar NAS

2009-03-31T15:59:00.001-07:00

Copyright (c) 2005 Israel Ochoa .
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License"

Instalar NAS (Network Audio System) en Linux y Windows(se da el caso :P) para su uso con festival

Lo bajamos de aquì:

http://radscan.com/nas.html

No hay mayor problema para la instalacion, si tienen Linux solo deben de tener X11

en la linea de comandos ejecutan:

$ xmkmf

cuando termine ejecutamos:

$ make World (tal y como esta, esa mayuscula si la lleva)

Si todo sale bien podemos ejecutar:

# make install

Si quieren el man:

# make install.man

Listo, solo asegurense de que tienen estos archivos instalados:

/usr/include/audio/Afuncproto.h Header files
/usr/include/audio/Afuncs.h
/usr/include/audio/Amd.h
/usr/include/audio/Aos.h
/usr/include/audio/Aosdefs.h
/usr/include/audio/Aproto.h
/usr/include/audio/audio.h
/usr/include/audio/Alibint.h
/usr/include/audio/Alibnet.h
/usr/include/audio/Xtutil.h
/usr/include/audio/audiolib.h
/usr/include/audio/audioutil.h
/usr/include/audio/snd.h
/usr/include/audio/wave.h
/usr/include/audio/voc.h
/usr/include/audio/aiff.h
/usr/include/audio/sound.h
/usr/include/audio/soundlib.h
/usr/include/audio/fileutil.h
/usr/include/audio/8svx.h
/usr/include/audio/Astreams.h

/usr/bin/X11/auconvert Sample programs
/usr/bin/X11/auctl
/usr/bin/X11/audemo
/usr/bin/X11/audial
/usr/bin/X11/auedit
/usr/bin/X11/auinfo
/usr/bin/X11/aupanel
/usr/bin/X11/auplay
/usr/bin/X11/aurecord
/usr/bin/X11/autool
/usr/bin/X11/auwave
/usr/bin/X11/auphone
/usr/bin/X11/auscope
/usr/bin/X11/soundtoh
/usr/bin/X11/issndfile
/usr/bin/X11/playbucket
/usr/bin/X11/checkmail

/usr/man/mann/*.n Client, server, and misc
man pages
/usr/man/man3/*.3 API man pages

/usr/lib/libaudio.[a|so] API library
/usr/lib/X11/AuErrorDB Error database

/usr/bin/X11/nasd NAS server for your
hardware (voxware,
sun, hpux and sgi)
Y ahora si a utilizarlo:
$ nasd -aa & # Esto es para que cualquier equipo de la red pueda utilizar este audio server
$ export AUDIOSERVER="hostname:0"
$ auinfo # para ver la informacion y pues todo debe indicar que esta bien.

y listo, ya lo pueden utilizar con festival.

En el caso de Windows lo bajamos de aqui:

http://nas.intra-links.net/

Para el caso de windows es importante tener Cygwin www.cygwin.com con lo mas basico pero importante
que este el Xorg (X11).

Descomprimen el paquete en el directorio de instalacion de cygwin en bin.

e.g. c:\cygwin\bin

Si no tienen un directorio dev en cygwin tienen que crearlo

e.g. c:\cygwin\dev

ejecutan cygwin

y levantan el servidor NAS, importante que dejen abierto cygwin (pues claro duh!!!).

$ nasd -aa &

y Listo

Instalar Festival

2009-03-31T15:58:00.001-07:00

Copyright (c) 2005 Israel Ochoa .
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License"

Instalar Festival y configurarlo para el uso en nagios.

Necesitamos:
Una maquina con Unix o Linux
Compilador C++
GNU Make
Audio Hardware

Bajamos los siguientes paquetes que es lo mas basico para tener trabajando festival

http://festvox.org/festival/downloads.html

festival-VERSION-release.tar.gz
System Source

speech_tools-VERSION-release.tar.gz
Edinburgh Speech Tools Library

festlex_CMU.tar.gz
festlex_OALD.tar.gz
festlex_POSLEX.tar.gz
festvox_don.tar.gz
festvox_kedlpc16k.tar.gz
festvox_rablpc16k.tar.gz

los descomprimimosen donde queramos (pero que sepamos donde estan para poder utilizarlos despues)
y quedan dos directorios:

/festival
/speech_tools

Instalar primero speech tools (Edinburgh Speech Tools)
(Noten que lo pueden instalar donde sea pero que ustedes sepan donde van a estas localizados los ejecutables).
$./configure

Nos crea un archivo config en config/config
Lo editamos para descomentar la opcion de NAS (Network Audio System) esto para utilizar el soporte para la red.
## NCD's network audio system, This is recommended.
INCLUDE_MODULES += NAS_AUDIO
y para utilizar las librerias compartidas (Esto es por que solamente vamos a usar speech_tools
y festival para ejecutarlos, descomentamos la linea:
# SHARED = 1

Hacemos:

$ gmake
$ gmake test

Y si al final dice que OK, listo ya tenemos Edinburgh Speech Tools instalado.

ahora a instalar Festival

Nos fijamos en los requerimientos que este todo completo y descomprimidos los archivos en festival
Podemos hacer varias modificaciones en la configuracion, pero solo para el uso que le vamos a dar
asi dejamos todo y solo ejecutamos
$ ./configure
$ gmake
y listo

solo exportamos el NAS server a la variable AUDIOSERVER, para esto ya debe estar ejecutandose el NAS en
la otra maquina (ver el apartado instalacion de NAS), esto mas que nada es cuando desean usar el audio por la red,
si lo desean utilizar en la maquina donde esta instalado festival lo dejan como esta.

$ export AUDIOSERVER:ip:0

Probamos festival entrando al ejecutable,

$ bin/festival
Festival Speech Synthesis System 1.4.3:release Jan 2003
Copyright (C) University of Edinburgh, 1996-2003. All rights reserved.
For details type `(festival_warranty)'
festival>

dentro de festival para probarlo tienen que escribir:
festival> (intro)

Si aparece Can't access NAS Server pues revisen su NAS y verifiquen la variable AUDIOSERVER

Y logicamente si escuchan la voz pues ya la armaron.

Audio en Nagios

2009-03-31T15:57:00.000-07:00

Es cierto que no siempre vas a estar pegado a la pantalla viendo Nagios para darte cuenta cuando algo este mal, esto por que estas ocupado en un proyecto, estas jugando (no nos hagamos :P) o simplemente tuviste una noche o día muy pesado y no estas al 100% y te andas durmiendo, para eso Nagios puede manejar Audio y te despierta por que te despierta, lo podemos hacer de la forma tradicional (ejecutar los wav's que vienen con Nagios) o de la forma "Quiero impresionar a mis jefes y compañeros de trabajo" usando festival, choose your destiny!!!!.

Ejecutando Wav's como alarma de audio.

Vamos a ejecutar unos archivos de sonido .wav cada vez que exista un problema en Nagios, esto es a la forma simple y rápida, lo implementamos verificando que tengamos descomentado lo siguiente en el archivo cgi.cfg
(esto esta al final del archivo):

host_unreachable_sound=hostdown.wav
   host_down_sound=hostdown.wav
   service_critical_sound=critical.wav
   service_warning_sound=warning.wav
   service_unknown_sound=warning.wav

Listo, ya tenemos audio alarmas en Nagios listas para indicarnos cuando exista algún problema, este sonido se ejecutara en el cliente (máquina donde abrimos la página de nagios) o sea que ese cliente debe de tener bocinas, audio habilitado y tener abierto siempre el navegador. Los archivos wav ya vienen incluidos con la instalación de Nagios.

Usando Festival para alarmarnos

Pues este es un interesante apartado, "Usando Festival para alarmarnos" y se preguntarán los newbies ¿Qué es Festival?, unos contestaran, "Es como el carnaval de Veracruz o un InstallFest", pues no!!! jajajaja (un pequeño chiste), Festival es un proyecto del Centro de investigación de Tecnología del Habla
de la Universidad de Edinburgh, el cual permite convertir el texto simple en audio (a grandes rasgos)
y ¿Para qué nos sirve a nosotros?, podemos enviar texto de Nagios a Festival e imaginense los resultados :).

Ok, ¿Qué ocupamos hacer?

Debemos ver la forma en que vamos a ejecutar los sonidos, esto es si el servidor de Nagios lo va a hacer
o si los vamos a ejecutar en otra máquina (por RED).

Lo queremos para un servidor en producción (en alguna empresa), para un servidor de prueba o de nuestra propia red en casa o algún otro lugar.

Como en todo, siempre hay ventajas y desventajas:

Ventajas:

Inmediatamente recibimos el audio si alguna falla ocurre en nuestra red.

Sabremos con exactitud que servicio y que equipo esta abajo.

No ocupas tener el navegador abierto.

Impresionaremos a nuestros jefes y colegas :D.

Desventajas:

Desperdicio de recursos y más si lo emplementamos en red (para algunos casos, para otros no).

Nos puede asustar, jejejeje, esto si estas solo en tu cuarto (casa, trabajo, etc.) en la noche, creeme
que te puedes asustar si te quedas medio dormido (ya me ha sucedido :P).

Si estan concientes de esto y lo desean implementar no perdamos tiempo.

Instalando Festival, NAS y configurando todo.

Como les comente podemos ejecutar el audio ya sea en el servidor de Nagios o en otra máquina

Primero que nada ocupamos instalar Speechd el cual es un demonio para ejecutar
el audio directamente de un texto a /dev/speech, el cual es muy útil.

Despues instalamos Festival, aquí esta un pequeño How to para hacerlo.

E instalamos el NAS (Network Audio System) también con su respectivo How to para hacerlo.

Ya tenemos instalado el software necesario, ahora tenemos que configurar a Nagios para poder utilizar Festival:

Vamos a configurar las alarmas en forma global para esto descomentamos las siguientes líneas en el archivo nagios.cfg:

global_host_event_handler=global-hst-event-handler
global_service_event_handler=global-svc-event-handler

Despues agregamos los siguientes comandos en checkcommands.cfg:

define command{ command_name global-hst-event-handler command_line $USER1$/eventhandlers/hst_event_handler $HOSTNAME$ "$HOSTALIAS$" $HOSTSTATE$ $HOSTSTATETYPE$ $HOSTATTEMPT$ } define command{ command_name global-svc-event-handler command_line $USER1$/eventhandlers/svc_event_handler $HOSTNAME$ "$HOSTALIAS$" "$SERVICEDESC$" $SERVICESTATE$ $SERVICESTATETYPE$ $SERVICEATTEMPT$ }

Listo, ahora solo nos faltan los scripts para poder usar estos comandos, encontraran unos de ejemplo:
svc_event_handler-speechd, svc_event_handler, hst_event_handler-speechd, hst_event_handler. Noten que puse unos para usarlos con Festival directamente y otros para usar el /dev/speech.

NOTA: Es importante que especifiquen el nombre correcto de los scripts para que tengan ningún problema.

Si todo salió bien entonces puedes parar algún servicio para probar esta configuración.

Lo malo que solo lo tengo implementado para manejar audio en inglés.

Mapas y configuración adicional

2009-03-31T15:56:00.000-07:00

Pues aquí viene lo interesante, como ver los mapas en Nagios con esto nos percatamos en forma gr? fica de cualquier falla ocurrida y alguna configuración adicionales para gráficos e información alterna.

El archivo cgi.cfg

En este archivo podemos configurar varias cosas entre ellas el modo en que se va a ver el mapa del status de Nagios (statusmap.cgi), primero que nada ocupamos localizar la siguiente sección:

# DEFAULT STATUSMAP LAYOUT METHOD
   # This option allows you to specify the default layout method
   # the statusmap CGI should use for drawing hosts.  If you do
   # not use this option, the default is to use user-defined   # coordinates.  Valid options are as follows:
   #       0 = User-defined coordinates
   #       1 = Depth layers
   #       2 = Collapsed tree
   #       3 = Balanced tree

   #       4 = Circular
   #       5 = Circular (Marked Up)
   default_statusmap_layout=0

Y aquí podemos modificar la vista del mapa, como pueden ver en este ejemplo las coordenadas nosotros las definimos (User-defined coordinates 0), estas coordenas las especificamos en el archivo hostextinfo.cfg el cual explicaremos a posteriormente.

En este archivo también podemos cambiar el fondo (background) de nuestro mapa 2D, esto lo hacemos de la siguiente forma:

Descomentamos la linea

statusmap_background_image=miimagen.gd2

En este caso las imagenes tienen que se .gd2 por lo cual creamos nuestro propio fondo lo grabamos como .png y utilizamos la herramienta png2gd2 para poder convertirla en gd2:

isuraeru@localhost$ png2gd2 imagen.png /usr/local/nagios/share/images/miimagen.gd2 1 1

Es importante dejar los parametros 1 1 al final ya que son indispensables para la creación de estos archivos y listo ya tenemos nuestro fondo personalizado.

El archivo hostextinfo.cfg

Aquì es donde va la información de nuestros equipos para el aspecto gráfico (que icono va a tener, en que posición de mapa va a estar, etc.):

define hostextinfo{

   # Este es el nombre del equipo que se especificó en hosts.cfg.
   host_name       windows2003
   # La imagen que aparecera a un lado del nombre del equipo.
          icon_image      windows.png 
   # La imagen que aparecera en el mapa 2D.
   statusmap_image windows.gd2

   # Coordenadas para el mapa 2D.
          2d_coords       250,350    
   # La imagen que aparecera en el mapa 3D (utilicé jpg por que se ve mejor).
          vrml_image      windows.jpg
   # Coordenadas para el mapa 3D, las cuales deben estar en float (punto flotante, me traume con programación)
   # 0.0,0.0,0.0 lo cual es lògicamente x,y,z
   3d_coords       20.0,30.0,6.0

   # Y si queremos agregar mayor información a nuestro host por ejemplo saber donde esta ubicado, una foto, etc.
   # Esto lo podemos hacer con la siguiente propiedad la cual nos dirige a una p? gina web
   # para ver esta información adicional, en este ejemplo este equipo lo tiene en nagiosserver/windows2003/info.html
   notes_url  http://nagiosserver/windows2003/info.html

   }

define hostextinfo{
          host_name       windows2000
          icon_image      windows.png
   2d_coords       320,350 
          statusmap_image windows.gd2
          vrml_image      windows.jpg

   3d_coords 50.0,40.0,10.0
   notes_url  http://nagiosserver/windows2000/info.html
          }

Agregamos la información para cada uno de los equipos.

El archivo hostextinfo.cfg

Este archivo tambien nos sirve para agregar gráficos a los servicios que tenemos en el sistema, una configuración ejemplo seria así:


   # La configuración es parecida al hostextinfo.cfg
   # Digamos que tenemos un servidor web linux

   define serviceextinfo{
   # Primero indicamos el nombre del equipo definido en hosts.cfg.

          host_name               slackwebserver
   # Descripción del servicio.
          service_description     Servidor Apache en Slackware
   # Página de información adicional
          notes_url               http://nagiosserver/slackwebserver/info.html
   # Imagen que aparecera en dicho servicio.

          icon_image              apache.png
   # En caso de no localizar la imagen es desplegara este texto o podemos indicar otra imagen.
          icon_image_alt          Web Service
   }

Como pueden observar agregue comentarios en cada uno de los puntos para que sea más rápida la referencia, con esta informacián agregamos los demas equipos y listo, si nos dirigimos a nuestra página de Nagios podremos ver los cambios ocurridos.

NOTA: Es importante que todas las imagenes que utilicemos esten en el directorio share/images de nuestro directorio de Nagios.

Los mapas 2D y 3D

Bueno, ya tenemos configurado todo para poder ver los equipos en los mapas, ya podemos entrar a Status Map en nuestra página de Nagios, pero si queremos entrar a 3-D Status Map nos va a querer grabar el archivo y no lo va abrir,
¿Por qué?, simple, no tenemos instalado un cliente VRML (Virtual Reality Modeling Language) para nuestro navegador, para esto podemos utilizar los siguientes:

Windows
Cortona VRML Client

Linux
FreeWRL
VREng
OpenVRML

La verdad a mi el que me gusto fue el de Cortona, se me hace un muy buen software para el caso de Windows,
pero para linux las opciones libres son amplias, si ninguna de estas les convence pues entren a Freshmeat
o Sourceforge y bajen las que m? s les sea de su agrado, incluso hay especiales para Gnome, etc.

Y con esto ya tenemos a Nagios con m? s información sobre los equipos y servicios que estamos monitoreando y nos permite en forma visual percatarnos de cualquier falla.

Configurando Nagios 2.x

2009-03-31T15:45:00.000-07:00

Ya que tenemos instalado Nagios y podemos accesar vía Web tenemos que configurar Equipos y Servicios para monitorear. Los archivos de configuración para Slackware estan en /etc/nagios/ (o donde lo hayan especificado) y pueden sacar plantillas de los archivos bigger.cfg y minimal.cfg, es importante que tengan todos los archivos (contacts, contactgroups, escalations, host, hostgroups, services, servicegroups, checkcommands, misccommands, timeperiod, etc) hay m? s pero trabajaremos por mientras con estos.

¿Qué ocupamos monitorear?

Para esto hacemos nuestra lista de Equipos y Servicios, en este caso dare unos ejemplos:

2 servidores Windows 2 servidores Linux 1 router 1 switch 2 paginas Web y Nuestro Nagios

¿Qué ocupamos saber de cada uno?

Servidor Windows 2003 (windows2003-192.168.0.10) : DNS, Host Alive, disk_usage y load. Servidor Windows 2000 (windows2000-192.168.0.11): SQL. Servidor Linux (linuxs-192.168.0.12): Squid. Servidor Linux (linuxw-192.168.0.13): HTTP. Cisco (cisco-192.168.0.14): FastEthernet, UPtime, Serial Switch (switch-192.168.0.15): Ping, Uptime. Pagina 1 (paginac-): www.cisco.com Pagina 2 (paginag-): www.google.com Nagios (nagios-192.168.0.15): En este caso en particular monitoreo la temperatura del equipo.

Son pocos pero sustanciosos, con estos trabajaremos para hacer nuestra configuración.

Agregando Contactos

Inicialmente empezaremos a agregar nuestros contactos, editamos contacts.cfg,
con nuestro editor favorito (el mío vi :)).
define contact{ contact_name tobi alias Nagios Super Admin contactgroups nt-admins ;podemos agregar desde aquí los grupos service_notification_period 24x7 host_notification_period 24x7 service_notification_options w,u,c,r host_notification_options d,u,r service_notification_commands notify-by-email host_notification_commands host-notify-by-email email correo@dominio.com } define contact{ contact_name superman alias Nagios Super Admin contactgroups linux-admins ;podemos agregar desde aquí los grupos service_notification_period 24x7 host_notification_period 24x7 service_notification_options w,u,c,r host_notification_options d,u,r service_notification_commands notify-by-email host_notification_commands host-notify-by-email email correo@dominio.com } define contact{ contact_name batman alias Nagios Super Admin contactgroups network-admins ;podemos agregar desde aquí los grupos service_notification_period 24x7 host_notification_period 24x7 service_notification_options w,u,c,r host_notification_options d,u,r service_notification_commands notify-by-email host_notification_commands host-notify-by-email email correo@dominio.com }
Lo grabamos y listo, tenemos algunos contactos, podemos agregar cuantos queramos.

Agregando Grupos de Contactos

Ahora editamos el contactgroups.cfg y podemos agregar los contactos en los grupos:

# 'linux-admins' contact group definition define contactgroup{ contactgroup_name linux-admins alias Linux Administrators members superman, batman } # 'nt-admins' contact group definition define contactgroup{ contactgroup_name nt-admins alias NT Administrators members tobi } # 'network-admins' contact group definition define contactgroup{ contactgroup_name network-admins alias Network Administrators members batman } # 'web-admins' contact group definition define contactgroup{ contactgroup_name web-admins alias WEB Administrators members batman, tobi, superman }

Grabamos y ya llevamos 2 archivos de configuracion.

Se preguntaran por que hicimos esta configuracion primero y no nos fuimos al grano o sea a a los equipos,
bueno en esta version 2 de Nagios en las directivas de host se agrego a la configuracion de cada equipo la linea contact_groups,
esto quiere decir que cada equipo tiene su grupo de contacto definido,
anteriormente estaban declarados los contact_groups en el archivo hostgroups.cfg.

Agregando Equipos

A continuación esta la configuración de hosts.cfg:
# Generic host definition template define host{ name generic-host ; The name of this host template - referenced in other host definitions, used for template recursion/res olution notifications_enabled 1 ; Host notifications are enabled event_handler_enabled 1 ; Host event handler is enabled flap_detection_enabled 1 ; Flap detection is enabled process_perf_data 1 ; Process performance data retain_status_information 1 ; Retain status information acro ss program restarts retain_nonstatus_information 1 ; Retain non-status information across program restarts register 0 ; DONT REGISTER THIS DEFINITION - ITS NOT A REAL HOST, JUST A TEMPLATE! } define host{ use generic-host host_name windows2003 alias NT 2003 Server address 192.168.0.10 check_command check-host-alive contact_groups nt-admins max_check_attempts 10 notification_interval 480 notification_period 24x7 notification_options d,u,r } define host{ use generic-host host_name windows2000 alias NT 2000 Server address 192.168.0.11 check_command check-host-alive contact_groups nt-admins max_check_attempts 10 notification_interval 480 notification_period 24x7 notification_options d,u,r }

Y asi sucesivamente vamos agregando y grabamos nuestro archivo hosts.cfg

Agregando Grupos de Equipos

Ahora creamos o editamos el archivo hostgroups.cfg, la forma como agrupemos los equipos aquí
se veran en la página de Nagios en la opción de hosts overview.

define hostgroup{ hostgroup_name webpages alias Web Pages members paginac,paginag } define hostgroup{ hostgroup_name winservers alias Windows Servers members windows2003,windows2000 }

Agregamos los demas y grabamos el archivo.

Agregando Servicios

Creamos o editamos services.cfg:

define service{
          use                             generic-service
   host_name                       windows2003
          service_description             DNS Service
          is_volatile                     0
          check_period                    24x7
          max_check_attempts              4
          normal_check_interval           5
          retry_check_interval            2
          contact_groups                  nt-admins
          notification_interval           120
          notification_period             24x7
          notification_options            w,u,c,r
          check_command                   check_dns
          }
define service{
        host_name                       paginac,paginag
        service_description             PING
        is_volatile                     0
        check_period                    24x7
        max_check_attempts              4
        normal_check_interval           5
        retry_check_interval            1
        contact_groups                  web-admins
        notification_interval           240
        notification_period             24x7
        notification_options            c,r
        check_command                   check_ping!1050.0,30%!1550.0,60%
        }

Después se explicará como agregar más plugins y su configuración, esto es solo para que puedan
entender el funcionamiento de Nagios en una forma rápida y no muy a fondo por el momento.

Grabamos y salimos.

Agregando Grupos de Servicios

Agregamos un grupo de servicio (Ping) para varios hosts, esto en el archivo servicegroups.cfg
(Este archivo también es una de las nuevas características de la versión 2 de Nagios).

define servicegroup{
        servicegroup_name       pingservices
        alias                   Ping Services
        members                 paginac,Ping Service,paginag,Ping Service,switch,Ping Service
        }

Grabamos y listo ya tenemos la configuración mínima para echar a andar a Nagios, hay otro archivo
que es el serviceextinfo.cfg pero ese se explicará después.

Verificando que todo funcione adecuadamente

Para verificar si todo esta funcionando como debe de ser, ejecutamos lo siguiente:

isuraeru@localhost# /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg

y si todo termina así:

Total Warnings: 0 Total Errors: 0 Things look okay - No serious problems were detected during the pre-flight check

Perfecto podemos daemonizar a Nagios:

isuraeru@localhost# /etc/rc.d/nagios start Starting network monitor: nagios PID TTY TIME CMD 29864 ? 00:00:00 nagios

Y ya tenemos a Nagios trabajando, solo es cuestión de entrar a nuestra página y ver como funciona.

NOTA: Aquí solo se mostro la configuración de algunos equipos para dar una idea de como hacerlo, para
monitorear más equipos o servicios los tenemos que ir agregando.

Instalando Nagios 2.x

2009-03-31T15:42:00.000-07:00

Aquí esta indicado como instalar Nagios desde las fuentes, esto lo podran realizar automáticamente para Slackware bajando el paquete en este Sitio, usando las fuentes se realizará según este How To (lo he instalado en Slackware, Red Hat, Mandrake y Debian).

Proceso de Instalación

Si queremos ulitizar SNMP tenemos que instalar el net_snmp el cual lo podemos bajar de LinuxPackages para Slackware, si quieren el source está en esta página o instalenlo con el rpm de su distro.

Obtenemos Nagios y los plugins de Nagios Download

Descomprimimos Nagios:

isuraeru@localhost$ tar xvfz nagios-2.0b2.tar.gz

Creamos un usuario y grupo de nombre nagios:

isuraeru@localhost# groupadd nagios
isuraeru@localhost# adduser nagios -g nagios

Listo, podemos agregar un grupo para ejecutar comandos con Nagios, pero utilizaremos el grupo nagios:

isuraeru@localhost# usermod -G nagios (usuario de apache)

Ejecutamos el script de configuración:

isuraeru@localhost$ ./configure --prefix=prefix --with-cgiurl=cgiurl --with-htmurl=htmurl --with-nagios-user=someuser --with-nagios-grp=somegroup --with-command-grp=cmdgroup

prefix default es /usr/local/nagios.
cgiurl default es /nagios/cgi-bin.
htmlurl default es /nagios/.
someuser default es nagios.
somegroup default es nagios.
cmdgroup default es nagios.

Recordemos que en esta versión 2 ya no se utiliza la base de datos y es mejor para el caso de los newbies. Realmente pueden configurar Nagios con solo ejecutar configure, pero si lo quieren personalizado pueden cambiar las variables.

Compilamos:

isuraeru@localhost$ make all

Instalamos binarios y los archivos HTML:

isuraeru@localhost# make install

Instalamos el script de iniciacion:

isuraeru@localhost# make install-init

De una vez instalamos los archivos de configuracion de ejemplo:

isuraeru@localhost# make install-config

Lo cual instalara los archivos .cfg en /usr/local/nagios/etc. Importante que todos los archivos en /usr/local/nagios incluyendo el directorio Nagios tengan como usuario y grupo a nagios:

isuraeru@localhost# chown -R nagios.nagios nagios/

y listo, ya tenemos instalado Nagios y si nos dirigimos a /usr/local/nagios encontraremos:

Sub-directorio Contenido
bin/ Programa Nagios
etc/ Los archivos de configuracion como Main, resource, object, y CGI van aqui.
sbin/ CGIs
share/ Archivos HTML
var/ Directorio vacío para log file, status file, retention file, etc.
var/archives Directorio vacío para los logs
var/rw Directorio vacío para el archivo external command

Posteriormente instalamos los plugins basicos, los cuales usualmente van en libexec/ en el directorio de Nagios.

Después tenemos que configurar la interfaz Web:
Editamos nuestro archivo /etc/apache/httpd.conf (Recuerden que esto esta enfocado a Slackware) y agregamos:

Para nuestros CGI's:

ScriptAlias /nagios/cgi-bin /usr/local/nagios/sbin
           

               AllowOverride AuthConfig
               Options ExecCGI
               Order allow,deny
               Allow from all

Para las paginas HTML agregamos:

Alias /nagios /usr/local/nagios/share
           
               Options None
               AllowOverride AuthConfig
               Order allow,deny
               Allow from all

Ojo primero va el ScriptAlias y después el Alias.
Para Slackware ya viene un archivo en /etc/apache/nagios.conf solo hay que agregarlo al httpd.conf.

Grabamos los cambios y reiniciamos el Web Server:

isuraeru@localhost# apachectl restart

Solamente nos dirigimos a http://tumaquina/nagios/ y debemos ver Nagios funcionando.

Si lo deseamos con Autentificacion Web hacemos lo siguiente:

Creamos un archivo .htaccess en el raíz del directorio CGI o HTML (/usr/local/nagios/sbin y /usr/local/nagios/share)

isuraeru@localhost# cat <<>> .htaccess
           > AuthName "Acceso a Nagios"
           > AuthType Basic
           > AuthUserFile /usr/local/nagios/etc/htpasswd.users
           > require valid-user
           > KO
           isuraeru@localhost#

Luego agregamos el valid-user (eso lo pueden cambiar):

isuraeru@localhost# htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin

Y si quieren agregar más solo ejecutan:

isuraeru@localhost# htpasswd /usr/local/nagios/etc/htpasswd.users

Y listo, Nagios ya esta instalado y lo pueden ver vía Web, pero todavía nos falta para tenerlo funcionando realmente, por lo cual pasamos a la siguiente sección.

Nueva casa (¿otra?) de Nagios en Español

2009-03-31T15:33:00.000-07:00

Si, otra casa para Nagios en Español, lo bueno que tengo respaldada toda la información, por lo cual la ire agregando poco a poco en este blog.

Saludos!