Origo OS

<header>Ajuda de les Definicions de Serveis de MON</header>

<p>Aquest ?s el segon i ?ltim pas de la configuraci? de MON.

<p>Els valors per defecte dels Serveis obligatoris es mostren

<marcats amb vermell>. Mira el tema d'ajuda corresponent per a m?s

informaci? sobre les Definicions de Serveis.

<p>Per a <b>"mail.alert"</b>, assegura't que sendmail est? configurat

i el dimoni <b>"sendmail"</b> est? en execuci? a la m?quina hoste.

<H3>Definicions de Servei</H3>

<P>

<DL COMPACT>

<DT><B>service</B><I> nom</I>

<DD>

La definici? d'un servei comen?a amb la paraula clau

<B>service</B>

seguida d'una paraula que ?s l'etiqueta d'aquest servei.

<P>

Els components d'un servei s?n un interval, monitor i un o m?s

per?odes de temps, tal i com es defineix m?s avall.

<P>

Si es defineix un nom de servei "default"  dins d'un

grup d'observaci? anomenat "default" (vegeu m?s amunt),

llavors la definici? default/default s'utilitzar? per a manipular

trampes desconegudes de mon.

<P>

<DT><B>interval</B><I> temps</I>

<DD>

La paraula clau

<B>interval</B>

seguida d'un valor de temps especifica la freq??ncia amb qu? es dispara

un script de monitoritzaci?.

Els valors de temps es defineixen com a "30s", "5m",

"1h", o "1d", que vol dir 30 segons, 1 hora o 1 dia.

La part num?rica pot ser una fracci?, com ara "1.5h" o b? una

hora i mitja. Aquest format d'una especificaci? de temps ser? referida

com a <I>temps</I>.

<P>

<DT><B>traptimeout</B><I> temps</I>

<DD>

Aquesta paraula clau pren el mateix argument d'especificaci? de temps

que <B>interval</B><I>,</I> i fa que el servei esperi una desviaci? d'una

font exterior al menys amb aquest freq??ncia, altrament s'enregistrar?

una fallada. Aix? s'utilitza per a serveis de l'estil de <i>hearbeat</i>.

<P>

<DT><B>trapduration</B><I> temps</I>

<DD>

Si es rep una desviaci?, l'estat del servei al qual s'ha lliurat la desviaci?,

romandr? normalment constant. Si s'especifica <B>trapduration</B>, l'estat

del servei romandr? en estat de fallada durant el temps especificat per

<I>temps</I>, i llavors es restaurar? a &quot;operatiu&quot;.

<P>

<DT><B>randskew</B><I> temps</I>

<DD>

Ajusta de forma aleat?ria l'interval especificat pel par?metre

<B>interval</B> amb m?s/menys <B>randskew</B>, m?s que no pas fer

que el script de monitoritzaci? s'executi al principi de cada interval.

El valor de trasllat s'especifica igual que el par?metre <B>interval</B>:

"30s", "5m", etc...

Per exemple, si <B>interval</B> ?s 1m i <B>randskew</B> ?s

&quot;5s&quot;, llavors <I>mon</I> programar? el script de monitoritzaci?

a un temps d'entre 55 segons i 65 segons. La intenci? ?s ajudar a distibuir

la c?rrega del servidor quan hi ha molts serveis programats als mateixos

intervals.

<P>

<DT><B>monitor</B><I> nom [arg...]</I>

<DD>

La paraula clau <B>monitor</B> seguida d'un nom de script i uns arguments

especifica el monitor que s'ha d'executar quan expira el cron?metre.

Quan s'especifiquen els arguments a enviar al script de monitoritzaci?,

se segueixen les convencions tipus shell per a les cometes. El script

s'invoca des del directori donat amb l'argument <B>-s</B>, i totes les

paraules seg?ents es passen com a argument al programa de monitoritzaci?,

seguides de la llista de hosts del grup referit pel grup d'observaci?

actual. Si la l?nia del monitor acaba amb ";;" com una paraula

separada, llavors no s'afegeixen els grups de hosts a la llista d'arguments

quan s'invoca el programa.

<P>

<DT><B>allow_empty_group</B>

<DD>

L'opci? <B>allow_empty_group</B> permetr? que s'invoqui un monitor fins i tot

quan el grup de hosts d'aquest observaci? estigui buit a causa dels hosts

desactivats. La conducta per defecte ?s no invocar el monitor quan tots els

hosts d'un grup han estat desactivats.

<P>

<DT><B>description</B><I> descripci?</I>

<DD>

El text que segueix a <B>description</B> ?s analitzat pels programes client

i passat a avisos i monitors a trav?s d'una variable d'entorn. Hauria de

contenir una descripci? breu del servei, apropiada per a incloure en un

correu electr?nic o una p?gina web.

<P>

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

<DD>

Tots els hosts llistats despr?s de <B>exclude_hosts</B> seran exclosos 

de la comprovaci? del servei.

<P>

<DT><B>exclude_period</B><I> per?ode</I>

<DD>

No executar un monitor programat durant el temps identificat per <I>per?ode</I>.

<P>

<DT><B>depend</B><I> expressi?</I>

<DD>

La paraula clau <B>depend</B> s'utilitza per especificar una expressi? de

depend?ncia que s'avalua a veritat o fals, en el sentit boole?. Les 

depend?ncies s?n, de fet, expressions Perl, i n'han d'obeir totes les

regles sint?ctiques. Les expressions s'avaluen en l'espai del seu propi

paquet, per evitar efectes secundaris no desitjats. Si es troba un error

de sintaxi en avaluar l'expressi?, s'enregistra a trav?s de syslog.

<P>

Abans de l'avaluaci?, s'efectuen les seg?ents substitucions a l'expressi?:

les frases del tipus "group:service" se substitueixen amb el valor

de l'estat actual d'operaci? del servei especificat. Aquestes substitucions

de l'estat d'operaci? es calculen de forma recursiva, de manera que si el

servei a dep?n del servei B, i el servei B dep?n del servei C, llavors el

servei A dep?n del servei C. Els estats d'operaci? correctes (que s'avaluen

a "1") s?n "STAT_OK", "STAT_COLDSTART", 

"STAT_WARMSTART", i "STAT_UNKNOWN". Es pot utilitzar

la paraula "SELF" (tot en maj?scules) per al grup (p. ex.,

"SELF:service"), i ?s un abreujament del grup d'observaci? actual.

<P>

Aquesta caracter?stica es pot utilitzar per controlar els avisos dels

serveis que depenen d'altres serveis. p. ex., una prova SMTP que dep?n

de la m?quina a la qual es fa ping.

<P>

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

<DD>

L'avaluaci? dels grafs de depend?ncia pot controlar la supressi? d'avisos

o b? d'invocacions del monitor.

<P>

<B>Supressi? d'av?s</B>.

Si s'estableix aquesta opci? a "a", llavors l'expressi? de

depend?ncia s'avaluar? despr?s que s'executi el monitor d'aquest servei

o despr?s de rebre una desviaci?. Nom?s s'enviar? un av?s si l'avaluaci?

re?x, volent dir que cap dels nodes del graf de depend?ncia indica fallada.

<P>

<B>Supressi? de monitor</B>.

Si s'estableix a "m", llavors l'expressi? de depend?ncia 

s'avaluar? abans que s'executi el monitor d'aquest servei. Si l'avaluaci?

re?x, llavors el monitor s'executar?. Altrament, el monitor no s'executar?

i l'estat del servei romandr? igual.

<P>

</DL>

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

<H3>Definicions de Per?ode</H3>

<P>

Els per?odes s'utilitzen per definir les condicions que han de permetre

el lliurament dels avisos.

<P>

<DL COMPACT>

<DT><B>period</B><I> [etiqueta:] per?ode</I>

<DD>

Un per?ode agrupa un o m?s avisos i variables que controlen amb quina 

freq??ncia se succeeix un av?s quan hi ha una fallada.

La paraula clau <B>period</B> t? dues formes. La primera pren un argument

que ?s una especificaci? de per?ode del m?dul Perl Time::Period de Patrick

Ryan. Vegeu "perldoc Time::Period" per a m?s informaci?.

<P>

La segona forma necessita una etiqueta seguida d'una especificaci? de

per?ode, tal i com es defineix abans. L'etiqueta ?s un car?cter alfab?tic

o subgui? (_) seguit de zero o m?s car?cters alfanum?rics o subguions i 

acabada amb dos punts (:). Aquesta forma permet per?odes m?ltiples amb

la mateixa definici? de per?ode. Un ?s ?s tenir una definici? de per?ode 

que no t? cap par?metre <B>alertafter</B> ni <B>alertevery</B> per a un

per?ode de temps particular, i un altre per al mateix per?ode de temps 

amb un conjunt d'avisos diferents que s? contenen aquests par?metres.

<P>

<DT><B>alertevery</B><I> temps</I>

<DD>

La paraula clau <B>alertevery</B> (en una definici? <B>period</B>)

pren el mateix tipus d'arguments que la variable <B>interval</B>,

i limita el nombre de vegades que s'envia un av?s quan el servei

segueix fallant. Per exemple, si l'interval ?s "1h", llavors

nom?s els avisos de la secci? del per?ode s'enviaran cada hora.

Si en una entrada de per?ode s'omet la paraula clau <B>alertevery</B>,

s'enviar? un av?s cada cop que es detecti una fallada. Per defecte, 

si canvia la sortida de dues fallades successives, llavors s'ignora

l'interval <b>alertevery</b>.

Si el darrer argument ?s la paraula "summary", llavors nom?s

es tindran en compte les l?nies de sortida del resum en comparar la

sortida de les successives fallades.

<P>

<DT><B>alertafter</B><I> n?m</I>

<DD>

<P>

<DT><B>alertafter</B><I> n?m temps</I>

<DD>

La paraula clau <B>alertafter</B> (en una secci? <B>period</B>) t? dues

formes: nom?s amb l'argument "n?m", o amb els arguments

"n?m temps". Amb la primera forma, nom?s s'invocar? un av?s

despr?s de "n?m" fallades consecutives.

<P>

Amb la segona forma, els arguments s?n un enter positiu seguit d'un interval,

tal i com  es descriu a la variable <B>interval</B> m?s amunt.

Si s'especifiquen aquests par?metres, llavors els avisos d'aquest per?ode

nom?s es cridaran despr?s que s'esdevingui aquest nombre de fallades en

aquest interval. Per exemple, si es donen a <B>alertafter</B> els arguments

"3 30m", llavors l'av?s es cridar? si se succeeixen 3

fallades en 30 minuts.

<P>

<DT><B>numalerts</B> <I>n?m</I>

<DD>

<P>

Aquesta variable diu al servidor que no cridi m?s de <I>n?m</I> avisos

durant una fallada. El comptador d'avisos es mant? en base al per?ode,

i es reinicia despr?s de cada pas a operatiu.

<P>

<DT><B>comp_alerts</B>

<DD>

<P>

Si s'especifica aquesta opci?, llavors nom?s es cridaran els avisos

<b>upalert</b> si s'ha cridat l'av?s &quot;down&quot; corresponent.

<P>

<DT><B>alert</B><I> av?s [arg...]</I>

<DD>

Un per?ode pot contenir m?ltiples avisos, que es disparen en cas de 

fallada del servei. Un av?s s'especifica amb la paraula clau

<B>alert</B>, seguida d'un par?metre <B>exit</B> opcional, i els 

arguments que s'interpreten igual que la definici? <B>monitor</B>,

per? sense l'excepci? &quot;;;&quot;. El par?metre <B>exit</B>

pren la forma <B>exit=x</B> o <B>exit=x-y</B> i per efecte que 

l'av?s nom?s es cridi si l'estat de sortida del script de monitoritzaci?

?s dins del rang del par?metre <B>exit</B>. Si, per exemple, la l?nia 

d'av?s ?s <I>alert exit=10-20 mail.alert mis</I>, llavors

<I>mail-alert</I> nom?s s'invocar? amb <I>mis</I> com a arguments

si el valor de retorn del programa monitor est? entre 10 i 20.

Aquesta caracter?stica permet disparar avisos diferents en diferents

nivells de severitat (com ara quan l'espai lliure del disc passa del

8% al 3%).

<P>

Vegeu la secci? <B>PROGRAMES D'AV?S</B> m?s amunt per a una llista de

par?metres que mon passar? autom?ticament als programes d'av?s.

<P>

<DT><B>upalert</B><I> av?s [arg...]</I>

<DD>

<B>upalert</B> ?s el complement de <B>alert</B>.

Es crida quan un servei fa la transici? d'estat de fallada a operatiu.

El script <B>upalert</B> es crida subministrant els mateixos par?metres

que el script <B>alert</B>, amb l'addici? del par?metre <B>-u</B>,

que s'utilitza per deixar que un script d'av?s s?piga que

est? essent cridat com a <B>upalert</B>. Es poden especificar avisos

m?ltiples per a cada definici? de per?ode. Tingues en compte que la

conducta per defecte ?s que s'envi? un av?s <B>upalert</B> independentment

de si s'han enviat abans avisos "down", ja que "down"

es dispara durant una transici? d'estat. Estableix l'opci? d'avisos per

per?ode <B>comp_alerts</B> per aparellar els avisos <B>upalert</B> amb

els avisos "down".

<P>

<DT><B>startupalert</B><I> av?s [arg...]</I>

<DD>

<B>startupalert</B> nom?s es crida quan el servidior <B>mon</B> inicia

la seva execuci?.

<P>

<DT><B>upalertafter</B><I> temps</I>

<DD>

El par?metre <B>upalertafter</B> s'especifica com una cadena que segueix

la sintaxi del par?metre <B>interval</B> (&quot;30s&quot;, &quot;1m&quot;,

etc.), i controla l'execuci? de <B>upalert</B>.

Si un servei torna a estar operatiu despr?s de fallar durant un temps

m?s gran o igual que el valor d'aquesta opci?, llavors es cridar? un

<B>upalert</B>. Utilitza aquesta opci? per evitar que es cridi

un <B>upalert</B> a causa de  &quot;blips&quot; (petits talls).

<P>