Origo OS

<header>Ayuda de MON sobre las Definiciones de Servicios</header>

<p>Esta es la segunda y ?ltima etapa en la configuraci?n de MON.

<p>Se muestran los valores por defecto para los servicios obligatorios 

<marcado en color ROJO>. Vea el tema de ayuda correspondiente a continuaci?n 

para m?s ayuda acerca de las Definiciones de Servicios.

<p>Para <b>"mail.alert"</b>, aseg?rese de que el demonio <b>"sendmail"</b>

est? iniciado en la m?quina.

<H3>Definiciones de Servicios</H3>

<P>

<DL COMPACT>

<DT><B>service</B><I> servicename</I>

<DD>

Una definici?n de servicio comienza por la palabra clave <B>service</B>

seguida de una palabra, que es la etiqueta de este servicio.

<P>

Los componentes de un servicio son un intervalo, un monitor y una o m?s

definiciones de periodos de tiempo, como se definen a continuaci?n.

<P>

Si se define un nombre de servicio "default" dentro de un grupo

de coincidencia llamada "dafault" (ver arriba), entonces se usar?

la definici?n "por defecto/por defecto" para el manejo de eventos de MON

desconocidos.

<P>

<DT><B>interval</B><I> timeval</I>

<DD>

La palabra clave <B>interval</B> seguida por un valor de tiempo especifica

la frecuencia con que se activar? un gui?n de monitorizaci?n. Los valores

de tiempo se definen como "30s", "5m", "1h", 

o "1d", significando 30 segundos, 5 minutos, 1 hora, o 1 d?a. La

parte num?rica puede ser una fracci?n, como "1.5h" o una hora y

media. Este formato para especificar tiempo lo conoceremos como <I>timeval</I>.

<P>

<DT><B>traptimeout</B><I> timeval</I>

<DD>

Esta palabra clave tiene como argumento la misma especificaci?n de tiempo

que <B>interval</B><I>,</I> y hace que el servicio espere un evento desde

una fuente externa al menos con esa frecuencia, de lo contrario se

anotar? un fallo. Esto se usa para un servicio tipo heartbit.

<P>

<DT><B>trapduration</B><I> timeval</I>

<DD>

Si se recibe un evento, habitualmente el estado del servicio al que se

dirige dicho evento permanecer? constante. Si se especifica <B>trapduration</B>

el servicio se mantendr? en estado fallido el tiempo indicado por 

<I>timeval</I>, para a continuaci?n cambiar a &quot;success&quot;.

<P>

<DT><B>randskew</B><I> timeval</I>

<DD>

M?s que planificar la ejecuci?n del gui?n de monitorizaci?n al inicio de

cada intervalo, ajustar aleatoriamente el intervalo especificado por el

par?metro <B>interval</B> hasta <B>randskew</B> unidades en cualquier sentido.

El valor de la deriva se especific como el del par?metro <B>interval</B>: 

&quot;30s&quot;, &quot;5m&quot;, etc... Por ejemplo, si <B>interval</B> es

1m, y <B>randskew</B> es &quot;5s&quot;, entonces <I>mon</I> planificar? el

gui?n de monitorizaci?n para ejecutarse con entre 55 y 65 segundos de

intervalo. La intenci?n es ayudar a distribuir la carga del servidor cuando

se monitorizan muchos servicios con los mismos intervalos.

<P>

<DT><B>monitor</B><I> nombre-monitor [arg...]</I>

<DD>

La palabra clave <B>monitor</B> seguida de un nombre de gui?n y sus

argumentos especifica el monitor que ejecutar cuando expire el

temporizador. Se mantienen las convenciones del int?rprete de comandos en

cuanto al "quoting" de los argumentos que pasar al gui?n de monitorizaci?n.

El gui?n se lanza desde el directorio indicado por el argumento <B>-s</B>,

y las siguientes palabras proporcionadas son los argumentos del programa de

monitorizaci?n, seguidos de la lista de m?quinas en el grupo a que hace

referencia el grupo de vigilancia actual. Si la l?nea de monitor acaba con

un ";;" como palabra separada, no se a?aden los grupos de

m?quinas a la lista de argumentos cuando se lanza el programa.

<P>

<DT><B>allow_empty_group</B>

<DD>

La opci?n <B>allow_empty_group</B> permite lanzar un monitor incluso cuando

el grupo de m?quinas de esta vigilancia est? vac?o por estar desactivadas

las m?quinas. El comportamiento por defecto es no lanzar el monitor cuando

todas las m?quinas de un grupo est?n desactivadas.

<P>

<DT><B>description</B><I> descriptiontext</I>

<DD>

El texto a continuaci?n de <B>description</B> lo consultan los programas

cliente, y se le pasa a las alertas y monitores a trav?s de una variable de

entorno. Deber?a contener una breve descripci?n del servicio, adecuada para

incluirla en un correo electr?nico o en una p?gina web.

<P>

<DT><B>exclude_hosts</B><I> host [host...]</I>

<DD>

Cualquier m?quina listada a continuaci?n de <B>exclude_hosts</B> se

excluir? de la comprobaci?n del servicio.

<P>

<DT><B>exclude_period</B><I> periodspec</I>

<DD>

No ejecutar un monitor planificado durante el periodo de tiempo

identificado por <I>periodspec</I>.

<P>

<DT><B>depend</B><I> dependexpression</I>

<DD>

La palabra clave <B>depend</B> se usa para especificar una expresi?n de

dependencia, que eval?a a verdadero o falso, en sentido booleano. Las

dependencias son verdaderas expresiones de PERL, y como tales deben cumplir

todas sus reglas sint?cticas. Las expresiones se eval?an en su propio

espacio de paquete para que no tengan efectos laterales indeseados. Si se

encuentra un error de sintaxis durante la evaluaci?n de la expresi?n, se

registra tal hecho mediante syslog.

<P>

Antes de evaluar la expresi?n se llevan a cabo las siguientes sustituciones

en la expresi?n: las frases que parecen "grupo:servicio" se

sustituyen por el valor del estado operacional actual del servicio

especificado. Estos estados operacionales se calculan de manera recursiva,

de manera que si el servicio A depende del servicio B, y el servicio B

depende del C, entonces el servicio A depende del C. Los estados

operacionales exitosos (que eval?an a "1") son

"STAT_OK", "STAT_COLDSTART",

"STAT_WARMSTART", y "STAT_UNKNOWN". Se puede usar la 

palabra "SELF" (todo en may?sculas) en el grupo

("SELF:service"), y es una abreviatura del grupo de vigilancia

actual.

<P>

Puede usar esta caracter?stica para controlar las alertas de los servicios

que dependen de otros, por ejemplo, una prueba de SMTP que depende de que

la m?quina sea alcanzable mediante ping.

<P>

<DT><B>dep_behavior</B><I> {a|m}</I>

<DD>

La evaluaci?n de los grafos de dependencias pueden controlar la eliminaci?n

de alertas o invocaciones de monitores.

<P>

<B>Eliminaci?n de alertas</B>.

Cuando esta opci?n vale "a" la expresi?n de dependencias se

evaluar? despu?s de que el monitor del servicio termine o se reciba un

evento. S?lo se enviar? una alerta si la evaluaci?n tiene ?xito,

significando que ninguno de los nodos en el grafo de dependencias inform?

de fallo.

<P>

<B>Eliminaci?n de monitores</B>.

Cuando esta opci?n vale "m", la expresi?n de dependencias se

eval?a antes de que se ejecute el monitor del servicio. Si la evaluaci?n

tiene ?xito se ejecutar? el monitor. En cualquier otro caso, el monitor no

se ejecutar? y el estado del servicio permanecer? sin cambios.

<P>

</DL>

<A NAME="lbAO">&nbsp;</A>

<H3>Definiciones de Periodo</H3>

<P>

Se usan los periodos para definir las condiciones que deber?an permitir el

reparto de las alertas.

<P>

<DL COMPACT>

<DT><B>period</B><I> [label:] periodspec</I>

<DD>

Un periodo agrupa una o m?s alarmas y variables que controlan cu?n a menudo

sucede una alerta cuando sucede un fallo. La palabra clave <B>period</B>

tiene dos formas. La primera toma como argumento una especificaci?n de

periodo del m?dulo de PERL 5 de Patrick Ryan Time::Period. Consulte

"perldoc Time::Period" para m?s informaci?n.

<P>

La segunda forma necesita una etiqueta seguida de una especificaci?n de

periodo, definida arriba. La etiqueta consiste de caracteres alfab?ticos o

car?cter de subrayado seguido de cero o m?s caracteres alfanum?ricos o de

subrayado, terminados por un car?cter de dos puntos. Esta forma permite

m?ltiples periodos con la misma definici?n de periodo. Uno de los usos es

disponer de una definici?n de periodo que no tenga par?metros

<B>alertafter</B> o <B>alertevery</B> para un determinado periodo de

tiempo, y otra para el mismo periodo de tiempo con un conjunto diferente de

alertas que no contengan esos par?metros.

<P>

<DT><B>alertevery</B><I> timeval</I>

<DD>

La palabra clave <B>alertevery</B> (en el interior de una definici?n de 

<B>period</B>) toma el mismo tipo de argumento que la variable <B>interval</B>

y limita el n?mero de veces que se env?a una alerta cuando el servicio

permanece indisponible. Por ejemplo, si el intervalo es "1h", 

entonces las alertas en ese periodo s?lo se disparar?n una vez a la hora.

Si se omite la palabra clave <B>alertevery</B> en una entrada de periodo,

se enviar? una alerta cada vez que se detecte un fallo. Por defecto, si la

salida de dos fallos consecutivos cambia, entonces se ignorar? el intervalo

<B>alertevery</B>. Si la palabra &quot;summary&quot; es el ?ltimo

argumento, s?lo se considerar?n las l?neas de salida del resumen cuando se

compare la salida de fallos consecutivos.

<P>

<DT><B>alertafter</B><I> num</I>

<DD>

<P>

<DT><B>alertafter</B><I> num timeval</I>

<DD>

La palabra clave <B>alertafter</B> (en el interior de una secci?n 

<B>period</B>) tiene dos formas: s?lo con el argumento &quot;num&quot;, o

con los argumentos "num timeval". En la primera forma s?lo se

invocar? una alerta tras "num" fallos consecutivos.

<P>

En la segunda forma, los argumentos son un entero positivo seguido de un

intervalo, como se describi?n antes en la variable <B>interval</B>. Si se

especifican estos par?metros las alertas de ese periodo s?lo se llamar?n

despu?s de que sucedan tantos fallos durante ese intervalo. Por ejemplo, si

se indica <B>alertafter</B> con los argumentos &quot;3&nbsp;30m&quot;,

entonces la alerta se llamar? si suceden 3 fallos en 30 minutos.

<P>

<DT><B>numalerts</B><I> num</I>

<DD>

<P>

Esta variable le dice al servidor que no llame m?s de <I>num</I> alertas

durante un fallo. El contador de alertas es propio de cada periodo, y se

pone a cero tras cada ?xito.

<P>

<DT><B>comp_alerts</B>

<DD>

<P>

Si se especifica esta opci?n, entonces las "upalerts" s?lo se llamar?n si

la alerta "down" correspondiente ya ha sido llamada.

<P>

<DT><B>alert</B><I> alert [arg...]</I>

<DD>

Un periodo puede contener m?ltiples alertas, que se disparan cuando sucede

un fallo en el servicio. Una alerta se especifica con la palabra clave

<B>alert</B>, seguida de un par?metro <B>exit</B> opcional, y argumentos

que se interpretan de igual manera que en la definici?n de <B>monitor</B>,

pero sin la excepci?n del &quot;;;&quot;. El par?metro <B>exit</B> toma la

forma de <B>exit=x</B> o <B>exit=x-y</B> y tiene el efecto de que s?lo se

llame a la alerta si el estado de salida del gui?n de monitorizaci?n cae

dentro del rango del par?metro <B>exit</B>. Si, por ejemplo, la l?nea de la

alerta es <I>alert exit=10-20 mail.alert mis</I>, entonces

<I>mail-alert</I> s?lo se invocar? (con <I>mis</I> como argumentos) cuando

el valor de salida del programa sea entre 10 y 20. Esta caracter?stica

permite disparar diferentes alertas ante diferentes niveles de severidad

(como cuando el espacio libre en disco cae del 8% al 3%).

<P>

Vea la secci?n <B>PROGRAMAS DE ALERTA</B> anterior para una lista de los

par?metros que MON pasar? autom?ticamente para alertar a los programas.

<P>

<DT><B>upalert</B><I> alert [arg...]</I>

<DD>

Una <B>upalert</B> es lo contrario de una <B>alert</B>. Se llama a una

"upalert" cuando un servicio hace la transici?n desde un estado de fallo a

uno de funcionamiento. El gui?n <B>upalert</B> se llama proporcionando los

mismos par?metros que al gui?n <B>alert</B>, con el a?adido del par?metro 

<B>-u</B>, que permite indicar al gui?n de alerta que se le est? llamando

como un "upalert" Se pueden especificar m?ltiples "upalerts" en una

especificaci?n determinada de periodo. Dese cuenta de que el comportamiento

por defecto es que se enviar? un "upalert" sin importar si se enviaron

previamente alertas "down", puesto que las "upalerts" se disparan

en una transici?n de estados. Configure la opci?n por periodo 

<B>comp_alerts</B> para aparejar las "upalerts" con las alertas

"down".

<P>

<DT><B>startupalert</B><I> alert [arg...]</I>

<DD>

Una <B>startupalert</B> s?lo se llama cuando el servidor <B>mon</B> inicia

su ejecuci?n.

<P>

<DT><B>upalertafter</B><I> timeval</I>

<DD>

El par?metro <B>upalertafter</B> se especifica como una cadena de texto que

sigue la sintaxis del par?metro <B>interval</B> (&quot;30s&quot;,

&quot;1m&quot;, etc.), y controla la activaci?n de una <B>upalert</B>.

Si un servicio se recupera tras haber estado ca?do un tiempo igual o

superior al valor de esta opci?n se llamar? una <B>upalert</B>. Use esta

opci?n para evitar la llamada a los "upalerts" debidas a "blips"

(breves indisponibilidades del servicio).

<P>