Translations of this page:

Osmius

Agente de Osmius para IP Wikipedia: IP
Nombre del agente: osm_ag_IPINST01 Código de agente: IPINST01
Contenido: Manual de usuario del agente de Osmius para IP
Fecha de creación: 10/07/2007 Fecha de revisión: 07/09/2007

Información General

Este agente puede monitorizar diversos parámetros de una instancia IP. Ha sido probado en situaciones reales. Sin embargo es altamente recomendable comprobar su funcionalidad antes de implantarlo en un entorno de producción.

El agente de IP ha sido desarrollado usando las funcionalidades y mejoras del framework de Osmius y de las librerías de ACE, por tanto se hace necesaria la instalación de las librerías de ACE para la correcta instalación y funcionamiento del agente de Osmius para IP. Vea el capítulo de instalación.

El agente IPINST01 proporciona hasta nueve eventos básicos con parámetros de configuración para permitir el escalado de una manera muy sencilla. Los eventos han sido seleccionados por el grupo de Investigación y Desarrollo de Osmius como los más interesantes para este primer desarrollo.

Todos los eventos son remotos, y están basados en solicitudes realizadas a través de sockets. El agente comprueba la información devuelta por la instancia IP y elabora una respuesta.

Instancia IP

Como norma general cada agente de Osmius puede monitorizar un tipo de instancia. Si no te resultan familiares estos conceptos consulta el glosario. Cada instancia se define individualmente en el fichero de configuración (si quieres ampliar esta información vete a agentes e instancias); dependiendo de cada agente hay que definir el tipo de instancia y dependiente de la instancia es la información de conexión.

CONNECTION_INFO

El connection_info o información de conexión es la información que el agente necesita saber para conectarse a la instancia. (Mira un poco más sobre el connection_info)

En el caso del agente de Osmius para IP el prototipo del connection_info sería:

CONNECTION_INFO= -i HOST

Donde reemplazaremos en cada instancia declarada:

  • HOST: IP a monitorizar (o nombre del host si tu DNS es capaz de resolverlo). Obligatorio

Un ejemplo podría ser:

CONECTION_INFO = -i 192.168.16.178
CONECTION_INFO = -i osmius.net

NOTA: Comprueba si el servidor DNS configurado en la máquina donde se instalará el agente es capaz de resolver los nombres de host en cuya monitorización está interesado.

TYPE

El type o tipo define el tipo de instancia que se va a monitorizar. Todas las instancias que se declaren deben de llevar asociado un tipo como puedes ver aquí

En el caso del agente para IP:

TYPE= IPINST01

Tabla-resumen de eventos para IP

A continuación te mostramos de forma breve las capacidades de este agente, más abajo en esta misma página se describirá cada uno de los eventos de manera más detallada.

EVENTO DESCRIPCIÓN c w a tsegundos Parámetros extra / Observaciones
AVAILABL Disponibilidad del dispositivo IP 0 2000 4000 300 Modo silencioso ( -s) recomendado
IPHTTPUP Existencia de respuesta HTTP 1 0 0 900 [-U url] [-P puerto]
Modo silencioso ( -s) recomendado
IPCFTPUP Existencia de respuesta FTP 1 0 0 1800 [-P puerto]
Modo silencioso ( -s) recomendado
IPTELNET Existencia de respuesta telnet 1 0 0 7200 [-P puerto]
Modo silencioso ( -s) recomendado
IPCSSHUP Existencia de respuesta ssh 1 0 0 1800 [-P puerto]
Modo silencioso ( -s) recomendado
IPSMTPUP Existencia de respuesta SMTP 1 0 0 1800 [-P puerto]
Modo silencioso ( -s) recomendado
IPCHKPOP Análisis de respuesta POP 1 0 0 1800 [-U usuario -K contraseña][ -P puerto]
Modo silencioso ( -s) recomendado
IPCHKIMP Análisis de respuesta IMAP 1 0 0 1800 [-U usuario -K contraseña][ -P puerto]
Modo silencioso ( -s) recomendado
IPCHKDNS Comprueba la resolución de un nombre de host 1 0 0 1800 -H nombre_host
Modo silencioso ( -s) recomendado

Eventos de información

Los eventos de información (Info Events) recuperar información genérica de la instancia que no suele variar con el tiempo. Este tipo de eventos carecen de criticidad, simplemente ofrecen detalles de la instancia.

EVENTO DESCRIPCIÓN tsegundos Observaciones
IPINFIPA Dirección IP o nombre de host 86400 (1 día) La IP o nombre de host suelen ser únicos, este evento nos permitirá identificar la instancia de manera única

Eventos del agente IPINST01

AVAILABL

El evento AVAILABL comprueba si existe conexión con la instancia IP.
Para ello ejecuta un comando “ping” contra el elemento de red.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 NO disponible
X Tiempo medio de respuesta al ping en ms

Parámetros recomendados:

Tipo de comparación Directa. Cuanto más alta el valor más crítico el estado (-c 0)
Intervalo de monitorización 60 segundos – 1 hora –> depende de la importancia de la instancia
Umbral de warning Depende del tiempo de respuesta medio de cada elemento
Umbral de alerta Depende del tiempo de respuesta medio de cada elemento

Ejemplo de parametrización:

AVAILABL = -t 600 -c 0 -w 1000 -a 3500 -T "disp. y ping - servidor de correo"

Observaciones: Ninguna

IPHTTPUP

El evento IPHTTPUP comprueba la disponibilidad de respuesta de un servidor web.

Parámetros extra:
Este evento necesita parámetros adicionales para cumplir su objetivo:

PARÁMETRO SIGNIFICADO Obligatorio
-U -U url
Con este parámetro se puede definir una url específica para realizar la consulta.
Si no se define se usará la información de conexión.
No.
-P -P puerto
Puerto de comunicaciones con el servidor web.
Si no se define ninguno se usará el puerto 80.
No.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 Fallo. Hay respuesta pero no es satisfactoria.
1 OK. Hay respuesta adecuada. Código 200

Parámetros recomendados:

Tipo de comparación Inversa. Cuanto más bajo el valor más crítico el estado (-c 1)
Intervalo de monitorización 60 segundos – 1 hora –> depende de la importancia de la instancia
Umbral de warning 0
Umbral de alerta 0

Ejemplo de parametrización:

IPHTTPUP = -t 60 -c 1 -w 0 -a 0 -T "conexion HTTP" -U http://webserver/page.php -P 8080

Observaciones: Resulta útil para comprobar si un servidor web está respondiendo correctamente a las peticiones sobre una página en concreto.

IPCFTPUP

El evento IPCFTPUP establece una conexión con un servidor FTP y comprueba su disponibilidad.

Parámetros extra:
Este evento necesita parámetros adicionales para cumplir su objetivo:

PARÁMETRO SIGNIFICADO Obligatorio
-P -P puerto
Puerto de comunicaciones con el servidor FTP.
Si no se define ninguno se usará el puerto 21.
No.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 Fallo. Se ha obtenido una respuesta incorrecta
1 OK. Se ha recibido una respuesta correcta

Parámetros recomendados:

Tipo de comparación Inversa. Cuanto más bajo el valor más crítico el estado (-c 1)
Intervalo de monitorización 60 segundos – 1 hora –> depende de la importancia de la instancia
Umbral de warning 0
Umbral de alerta 0

Ejemplo de parametrización:

IPCFTPUP = -t 60 -c 1 -w 0 -a 0 -T "conexion FTP"

Observaciones: Ninguna

IPTELNET

El evento IPTELNET establece una conexión con un servidor TELNET y comprueba su disponibilidad.

Parámetros extra:
Este evento necesita parámetros adicionales para cumplir su objetivo:

PARÁMETRO SIGNIFICADO Obligatorio
-P -P puerto
Puerto de comunicaciones con el servidor telnet.
Si no se define ninguno se usará el puerto 23.
No.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 Fallo. Se ha obtenido una respuesta incorrecta
1 OK. Se ha recibido una respuesta correcta

Parámetros recomendados:

Tipo de comparación Inversa. Cuanto más bajo el valor más crítico el estado (-c 1)
Intervalo de monitorización 60 segundos – 2 horas –> depende de la importancia de la instancia
Umbral de warning 0
Umbral de alerta 0

Ejemplo de parametrización:

IPTELNET = -t 60 -c 1 -w 0 -a 0 -T "puerto 23"

Observaciones: Este evento se puede utilizar para comprobar la disponibilidad de cualquier puerto.

IPCSSHUP

El evento IPCSSHUP establece una conexión con un servidor SSH y comprueba su disponibilidad.

Parámetros extra:
Este evento necesita parámetros adicionales para cumplir su objetivo:

PARÁMETRO SIGNIFICADO Obligatorio
-P -P puerto
Puerto de comunicaciones con el servidor SSH.
Si no se define ninguno se usará el puerto 22.
No.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 Fallo. Se ha obtenido una respuesta incorrecta
1 OK. Se ha recibido una respuesta correcta

Parámetros recomendados:

Tipo de comparación Inversa. Cuanto más bajo el valor más crítico el estado (-c 1)
Intervalo de monitorización 60 segundos – 1 hora –> depende de la importancia de la instancia
Umbral de warning 0
Umbral de alerta 0

Ejemplo de parametrización:

IPCSSHUP = -t 60 -c 1 -w 0 -a 0 -T "servidor SSH"

Observaciones: Ninguna

IPSMTPUP

El evento IPSMTPUP establece una conexión con un servidor SMTP y comprueba su disponibilidad.

Parámetros extra:
Este evento necesita parámetros adicionales para cumplir su objetivo:

PARÁMETRO SIGNIFICADO Obligatorio
-P -P puerto
Puerto de comunicaciones con el servidor SMTP.
Si no se define ninguno se usará el puerto 25.
No.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 Fallo. Se ha obtenido una respuesta incorrecta
1 OK. Se ha recibido una respuesta correcta

Parámetros recomendados:

Tipo de comparación Inversa. Cuanto más bajo el valor más crítico el estado (-c 1)
Intervalo de monitorización 60 segundos – 1 hora –> depende de la importancia de la instancia
Umbral de warning 0
Umbral de alerta 0

Ejemplo de parametrización:

IPSMTPUP = -t 60 -c 1 -w 0 -a 0 -T "servidor SMTP"

Observaciones: Ninguna

IPCHKPOP

El evento IPCHKPOP establece una conexión con un servidor POP y comprueba su disponibilidad.
Si además se suministra el nombre de usuario y la contraseña se realizará un chequeo completo de la respuesta POP, si no simplemente una solicitud de conexión y seguidamente una de desconexión.

Parámetros extra:
Este evento necesita parámetros adicionales para cumplir su objetivo:

PARÁMETRO SIGNIFICADO Obligatorio
-U -U “usuario”
Nombre de usuario de una cuenta POP activa.
No.
-K -K “contraseña”
Contraseña para el usuario arriba mencionado.
No.
-P -P puerto
Puerto de comunicaciones con el servidor POP.
Si no se define ninguno se usará el puerto 110.
No.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 Fallo. Se ha obtenido una respuesta incorrecta
1 OK. Se ha recibido una respuesta correcta

Parámetros recomendados:

Tipo de comparación Inversa. Cuanto más bajo el valor más crítico el estado (-c 1)
Intervalo de monitorización 600 segundos – 1 día –> depende de la importancia de la instancia
Umbral de warning 0
Umbral de alerta 0

Ejemplo de parametrización:

IPCHKPOP = -t 600 -c 1 -w 0 -a 0 -U "usuario" -K "password" -P 111 -T "mi servidor pop secreto"

Observaciones: Debido a que el nombre de usuario y contraseña se almacenan sin cifrar en el fichero de configuración se recomienda extremar las precauciones y aplicar los permisos necesarios al fichero, de manera que solo los usuarios autorizados puedan acceder a él.

IPCHKIMP

El evento IPCHKIMP establece una conexión con un servidor IMAP y comprueba su disponibilidad.
Si además se suministra el nombre de usuario y la contraseña se realizará un chequeo completo de la respuesta IMAP, si no simplemente una solicitud de conexión y seguidamente una de desconexión.

Parámetros extra:
Este evento necesita parámetros adicionales para cumplir su objetivo:

PARÁMETRO SIGNIFICADO Obligatorio
-U -U “usuario”
Nombre de usuario de una cuenta IMAP activa.
No.
-K -K “contraseña”
Contraseña para el usuario arriba mencionado.
No.
-P -P puerto
Puerto de comunicaciones con el servidor IMAP.
Si no se define ninguno se usará el puerto 143.
No.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 Fallo. Se ha obtenido una respuesta incorrecta
1 OK. Se ha recibido una respuesta correcta

Parámetros recomendados:

Tipo de comparación Inversa. Cuanto más bajo el valor más crítico el estado (-c 1)
Intervalo de monitorización 600 segundos – 1 día –> depende de la importancia de la instancia
Umbral de warning 0
Umbral de alerta 0

Ejemplo de parametrización:

IPCHKIMP = -t 600 -c 1 -w 0 -a 0 -U "usuario" -K "password" -T "servidor imap"

Observaciones: Debido a que el nombre de usuario y contraseña se almacenan sin cifrar en el fichero de configuración se recomienda extremar las precauciones y aplicar los permisos necesarios al fichero, de manera que solo los usuarios autorizados puedan acceder a él.

IPCHKDNS

El evento IPCHKDNS comprueba la correcta resolución de un nombre de host usando los servidores DNS de la máquina huésped.
Este evento ejecuta el comando “nslookup” para comprobar la resolución de nombres de máquinas.

Parámetros extra:
Este evento necesita un parámetro adicional para cumplir su objetivo:

PARÁMETRO SIGNIFICADO Obligatorio
-H -H “nombre_de_host”
Nombre sobre el cual se realizará la pregunta de resolución.
.

Valores devueltos:

VALOR SIGNIFICADO
-1 Error
0 Fallo. Se ha obtenido una respuesta incorrecta
1 OK. Se ha recibido una respuesta correcta

Parámetros recomendados:

Tipo de comparación Inversa. Cuanto más bajo el valor más crítico el estado (-c 1)
Intervalo de monitorización 600 segundos – 1 día –> depende de la importancia de la instancia
Umbral de warning 0
Umbral de alerta 0

Ejemplo de parametrización:

IPCHKDNS = -t 3600 -c 1 -w 0 -a 0 -H “osmius.net” -T "comprobando DNS"

Observaciones: Ninguno

Requisitos previos del agente de IP

Para poder compilar este agente se necesitan una serie de requisitos previos, que son genéricos para la compilación de cualquier agente de Osmius, puedes consultar cuales son en requisitos previos.

Asegúrese de disponer de un mapa de red actualizado y claro para poder planear adecuadamente la monitorización.

Makefiles y compilación del agente de IP

  • Osmius hace uso de Make Project Creator (MPC), para que la creación de los Makefiles sea una tarea trivial. Si quieres saber un poco más de MPC en Osmius consulta la sección de Makefiles en Osmius.
  • En el caso particular del agente de Osmius para IP podemos crear fácilmente el Makefile de la siguiente forma:

Desde el directorio del agente usando la consola o terminal.

Para Linux:

$ACE_ROOT/bin/mpc.pl -type make osm_ag_ip.mpc

Para HP-UX / Solaris:

$ACE_ROOT/bin/mpc.pl -type gnuace osm_ag_ip.mpc

Para Windows con Visual C 8:

%ACE_ROOT%\bin\mpc.pl -type vc8 osm_ag_ip.mpc
  • Ahora que está creado el Makefile compilar el agente es extremadamente sencillo.

Para Linux:

make -f Makefile.Osm_Ag_Ip_Osmius

Para HP-UX:

gmake -f Makefile.Osm_Ag_Ip_Osmius

Para Windows:

Doble click sobre Osm_Ag_Ip.vcproj y el proyecto se abrirá en Visual Studio. En la configuración de la solución selecciona Release. Presiona la opción Rebuild para compilar.

Los binarios se instalarán automáticamente en el directorio bin del directorio base OSM_ROOT.

Ejecutar el agente de IP

El agente de IP conserva las mismas características de ejecución del resto de los agentes que puedes consultar en la sección Arrancar y Parar agentes.

Para ejecutar el agente de IP sin usar la consola de Osmius:

osm_ag_IPINST01[.exe]1) -c osm_ag_IPINST01.ini -m MASTERAG -p 1950 -d [>> osm_ag_ipinst01.log]2)

Ejecución en modo standalone

El agente de Osmius para IP, al igual que el resto de los agentes de Osmius, permite la ejecución en modo standalone. Esta opción puede resultar especialmente útil cuando se está desarrollando un nuevo agente o para realizar las pruebas de concepto de determinado agente.

Básicamente debes de añadir un nuevo valor al fichero de configuración del agente de Osmius para IP (osm_ag_IPINST01.ini) llamado SNDCMD, tal y como se muestra aquí.

Luego deberás de ejecutar el agente de Osmius para IP poniendo el puerto de comunicaciones con el Agente Maestro a cero, por ejemplo:

osm_ag_IPINST01[.exe] -c osm_ag_IPINST01.ini -m 00000000 -p 0 -d

Listado de pruebas

Pruebas realizadas al agente de Osmius para IP.

Fecha: 07/12/2007
Prueba Resultado Observaciones
Creación de una instancia con todos sus eventos en modo silencioso OK N/A
Creación de una instancia con todos sus eventos con texto personalizado OK N/A
Creación de una instancia con todos sus eventos pero sin texto personalizado OK N/A
Declaración de 3 instancias con todos sus eventos a 3 segundos y mantenerlo
en ejecución durante 48 horas
OK Sin pérdidas de memoria
Declarar 2 instancias, provocar la desconexión de una y después volver a conectarlaOK N/A
Declarar 1 instancia y probar cada evento OK N/A
Eliminación de parámetro general y comprobar que no arranca OK N/A
Eliminación del CONN_INFO de la instancia y comprobar que no arranca OK N/A
1) En los sistemas Windows la extensión es .exe
2) Opcional, para guardar un fichero con los mensajes que pueda devolver el agente
 
agentes/ipinst01.txt · Última modificación: 2012/12/05 19:16 por osmius
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki