xymongen - Online în cloud

PROGRAM:

NUME

xymongen - generator de pagini web Xymon

REZUMAT

ximongen -?
ximongen --Ajutor
ximongen --versiune
ximongen [Opțiuni] [directorul de ieșire]
(Consultați secțiunea OPȚIUNI pentru o descriere a opțiunilor disponibile pentru linia de comandă).

DESCRIERE

ximongen generează paginile web de prezentare generală pentru monitorul Xymon. Acestea sunt paginile web
care arată starea generală a gazdelor dvs., nu paginile detaliate de stare pentru fiecare test.

Notă: Datele pentru paginile web sunt preluate din xymond(8) daemon și utilizări xymongen
valorile variabilelor de mediu XYMSRV / XYMSERVERS pentru a determina rețeaua
adresa unde se poate ajunge la xymond. Dacă aveți mai multe servere listate în
XYMSERVERS, asigurați-vă că primul este serverul Xymon local - acesta este cel care
xymongen va cere date.

OPŢIUNI

xymongen are un număr mare de opțiuni de linie de comandă. Opțiunile pot fi folosite pentru a schimba
comportamentul lui xymongen și afectează paginile web generate de acesta.

GENERAL OPŢIUNI

--ajutor sau -?
Furnizați un rezumat al opțiunilor disponibile pentru linia de comandă.

--versiune
Imprimă numărul versiunii xymongen

--docurl=URL
Această opțiune este depreciată, utilizați setarea HOSTDOCURL în xymonserver.cfg(5)
in schimb.

--doccgi=URL
Această opțiune este depreciată, utilizați setarea HOSTDOCURL în xymonserver.cfg(5)
in schimb.

--doc-window
Face ca linkurile către documentația pentru gazde și servicii să se deschidă într-o fereastră nouă. The
implicit este afișarea documentației în aceeași fereastră de browser ca și starea Xymon.

--htmlextension=.EXTENSION
Setează extensia numelui de fișier utilizată pentru paginile web generate de xymongen. De
implicit, este folosită o extensie „.html”. Rețineți că trebuie să specificați „punctul”.

--report[=COLUMNNAME]
Cu această opțiune, xymongen va trimite un mesaj de stare cu detalii despre câte
au fost procesate gazde, câte pagini au fost generate, eventualele erori care au apărut
în timpul alergării și câteva statistici de sincronizare. Numele de coloană implicit este „xymongen”.

--htaccess[=htaccess-filename]
Creați fișiere .htaccess atunci când sunt create directoare de pagini web noi. Conținutul de
fișierele .htaccess sunt determinate de variabila de mediu XYMONHTACCESS (pentru
directorul de nivel superior cu xymon.html și nongreen.html); langa
variabila XYMONPAGEHTACCES (pentru directoarele la nivel de pagină); iar de către
Variabila XYMONSUBPAGEHTACCESS pentru directoarele la nivel de subpagină și subparent. The
numele de fișier al fișierelor .htaccess este implicit „.htaccess” dacă nu este dat niciun nume de fișier
această opțiune. Variabila XYMONHTACCESS este copiată textual la nivelul superior
fișier .htaccess. Variabila XYMONPAGEHTACCESS poate conține un „%s” unde numele
a paginii este inserat. Variabila XYMONSUBPAGEHTACCESS poate conține două „%s”
cazuri: primul este înlocuit cu numele paginii, al doilea cu
subpagină.

--max-eventcount=N
Limitați jurnalul de evenimente de pe pagina „Toate non-verzi” la numai N evenimente. Implicit: 100.

--max-eventtime=N
Limitați jurnalul de evenimente de pe pagina „Toate non-verzi” la evenimentele care au avut loc în cadrul
ultimele N minute. Implicit: 240.

--no-eventlog
Dezactivează jurnalul de evenimente afișat în mod normal pe pagina „Toate non-verzi”.

--max-ackcount=N
Limitați jurnalul de confirmare de pe pagina „Toate non-verzi” la numai N evenimente. Mod implicit:
25.

--max-acktime=N
Limitați jurnalul de confirmare de pe pagina „Toate non-verzi” la confirmările care au avut loc
în ultimele N minute. Implicit: 240.

--nu-acklog
Dezactivați jurnalul de confirmare afișat în mod normal pe pagina „Toate non-verzi”.

--cricitcallog[=coloana jurnal critic]
Aceasta generează un jurnal bazat pe text cu ceea ce este afișat pe pagina de stare critical.html,
și trimite un mesaj de stare pentru serverul Xymon însuși, reflectând culoarea
Pagina de stare critică. Acest lucru vă permite să urmăriți când au apărut probleme pe
pagina de stare critică. Fișierul jurnal este stocat în $XYMONSERVERLOGS/criticalstatus.log

--loadhostsfromxymond
În loc să citească fișierul hosts.cfg, xymongen va încărca hosts.cfg
configurație de la demonul xymond. Acest lucru elimină nevoia de a citi
hosts.cfg, iar dacă aveți xymond și xymongen care rulează pe gazde diferite, de asemenea
elimină necesitatea copierii fișierului hosts.cfg între sisteme. Rețineți că
Opțiunea „dispinclude” din hosts.cfg este ignorată când această opțiune este activată.

PAGINĂ STRUCTURA OPŢIUNI

Aceste opțiuni afectează modul în care paginile web generate de xymongen apar în browser.

--pagini-ultimele
Pune link-uri de pagină și subpagină după gazde.

--paginile-întâi
Puneți link-uri de pagină și subpagini înaintea gazdelor (implicit).

Aceste două opțiuni decid dacă o pagină cu link-uri către subpagini și gazde au
mai întâi gazdele sau subpaginile.

--subpagecolumns=N
Determină numărul de coloane utilizate pentru link-uri către pagini și subpagini. Implicit
este N=1.

--maxrows=N
Titlurile coloanelor dintr-o pagină sunt afișate implicit doar la începutul unei pagini,
subpagină sau grup de gazde. Această opțiune face ca titlurile coloanelor să se repete pentru
fiecare N gazde afișate.

--showemptygroups

--no-showemptygroups
Când grupurile sunt create gazde, afișați tabelul și numele gazdelor, chiar dacă există
nu există teste pentru niciuna dintre gazdele în cauză. Folosiți --no-showemptygroups pentru
ascunde. (Implicit: da)

--pagetitle-links
În mod normal, doar „punctele” colorate de lângă o pagină sau o subpagină acționează ca link-uri către
pagina în sine. Cu această opțiune, titlul paginii va fi legat și de pagină.

--pagetext-headings
Utilizați textul descrierii din etichetele „pagină” sau „subpagină” ca titlu pentru
pagina, în loc de „Pagini găzduite local” sau alt titlu standard.

--fără-subliniere-titluri
În mod normal, titlurile paginilor sunt subliniate folosind o etichetă HTML „riglă orizontală”. Acest
opțiunea dezactivează sublinierea titlurilor.

--recentgifs[=MINUTES]
Utilizați imagini denumite COLOR-recent.gif pentru teste, în care starea testului s-a schimbat
în ultimele 24 de ore. Aceste fișiere GIF trebuie instalate în
directorul $XYMONHOME/www/gifs/. În mod implicit, pragul este setat la 24 de ore - dacă
vrei altfel, poți specifica și limita de timp. De exemplu
„--recentgifs=3h” va afișa GIF-urile recente pentru numai 3 ore după o schimbare de stare.

--sortare-numai-grupuri-articole
Într-o directivă normală „doar grup”, puteți specifica ordinea în care testele
sunt afișate, de la stânga la dreapta. Dacă preferați să aveți testele enumerate în
ordine alfabetică, utilizați această opțiune - pagina va genera apoi „numai pentru grup”
grupuri ca acesta generează grupuri normale și sortează testele alfabetic.

--dialupskin=URL
Dacă doriți să arătați vizual că un test este un test dialup, puteți utiliza o alternativă
set de pictograme pentru verde/roșu/galben>/etc. imagini prin specificarea acestei opțiuni. The
Parametrul URL specificat aici suprascrie setarea normală din XYMONSKIN
variabilă de mediu, dar numai pentru testele dialup.

--reverseskin=URL
La fel ca „--dialupskin”, dar pentru teste inverse (teste cu „!” în față).

--tooltips=[intotdeauna,niciodata,principal]
Stabilește ce pagini folosesc sfaturi pentru a afișa descrierea gazdei (din
COMENTARIU intrarea în gazde.cfg(5) fişier). Dacă este setat la mereu, sfaturile instrumente sunt folosite pe toate
pagini. Dacă este setat la nu, sfaturile instrumente nu sunt niciodată folosite. Dacă este setat la principal, sunt folosite sfaturi
pe paginile principale, dar nu pe paginile „Toate non-verzi” sau „Sisteme critice”.

COLOANA SELECȚIE OPŢIUNI

Aceste opțiuni afectează ce coloane (teste) sunt incluse în paginile web generate de
ximongen.

--ignorecolumns=test[,test]
Coloanele date vor fi complet ignorate de xymongen atunci când generează pagini web.
Poate fi folosit pentru a genera rapoarte în care eliminați unele dintre testele mai zgomotoase,
ca „ms-uri”.

--doar-roșii-critice
Doar coloanele roșii de stare vor fi incluse în pagina Critică. În mod implicit,
Pagina critică va conține gazde cu stare roșie, galbenă și clară.

--nongreen-colors=CULOARE[,CULOARE]
Definește ce culori cauzează apariția unui test pe pagina de stare „Toate non-verde”.
CULOAREA este roșu, galben sau violet. Implicit este să le includă pe toate trei.

--nongreen-ignorecolumns=test[,test]
La fel ca și coloanele --ignore, dar se aplică numai gazdelor din pagina „Toate care nu sunt verzi”.

--nonverde-ignora violetele
Depreciat, utilizați în schimb „--nongreen-colors”.

--nongreen-ignorediaups
Ignorați toate gazdele dialup de pe pagina „Toate care nu sunt verzi”, inclusiv jurnalul de evenimente.

--nu-pagini
Nu generați paginile normale (utilizate în mod normal pentru a genera numai paginile non-verzi
pagină).

--nu-neverde
Nu generați pagina „Toate care nu sunt verzi”.

--includecolumns=test[,test]
Includeți întotdeauna aceste coloane pe pagina „Toate care nu sunt verzi” Va include anumite coloane
pe pagina nongreen.html, indiferent de culoarea acesteia. În mod normal, nongreen.html picături a
coloană-test, dacă toate testele sunt verzi. Acesta poate fi folosit, de exemplu, pentru a avea întotdeauna un link către
coloana tendințe (cu graficele RRD) din pagina dvs. nongreen.html.

--eventignore=test[,test]
Ignorați aceste teste în afișarea jurnalului de evenimente „Toate non-verzi”.

STAREA PROPAGARE OPŢIUNI

Aceste opțiuni suprimă propagarea normală a unei stări în sus în ierarhia paginii.
Astfel, poți avea un test cu stare galben sau roșu, dar totuși să ai întreaga pagină verde.
Este util pentru testele care nu trebuie să provoace o alarmă, dar în care doriți totuși să știți
starea reală. Aceste opțiuni stabilesc valori implicite globale pentru toate gazdele; puteți folosi NOPROPRED
și etichetele NOPROPYELLOW în gazde.cfg(5) fișier pentru a aplica limite similare pe o gazdă
bază.

--nopropyellow=test[,test] sau --noprop=test[,test]
Dezactivați propagarea stării în sus când este GALBEN. Opțiunea „--noprop” este depreciată
și nu trebuie utilizat.

--noproppurple=test[,test]
Dezactivați propagarea stării în sus când PURPLE.

--nopropred=test[,test]
Dezactivați propagarea stării în sus când este ROȘU sau GALBEN.

--nopropack=test[,test]
Dezactivați propagarea stării în sus când starea a fost confirmată. Daca vrei
pentru a dezactiva toate testele confirmate de a fi propagate, utilizați „--nopropack=*”.

PURPLE STAREA OPŢIUNI

Stările violet apar atunci când raportarea stării unui test se oprește. O stare de testare este valabilă pentru a
perioadă limitată de timp - în mod normal 30 de minute - și după acest timp, testul devine
Violet.

--purplelog=NUME FIȘIER
Generați un fișier jurnal cu toate mesajele de stare violet.

ALTERNATIV PAGESET OPŢIUNI

--pageset=PAGESETNAME
Creați pagini web pentru un set de pagini alternativ decât cel prestabilit. Consultați secțiunea PAGESETS
de mai jos.

--template=Șablon
Utilizați un șablon alternativ pentru fișierele antet și subsol. Folosit de obicei împreună
opțiunea „--pagesset”; vezi secțiunea PAGESETS de mai jos.

ALTERNATIV REZULTATE FORMATE

--wml[=test1,test2,...]
Această opțiune determină xymongen să genereze un set de fișiere „card” WML care pot fi
accesat de un dispozitiv WAP (telefon mobil, PDA etc.) Fișierele generate conțin
gazdele care au starea ROȘU sau GALBEN la testele specificate. Această opțiune poate defini
testele implicite să includă - valorile implicite pot fi înlocuite sau modificate folosind
Etichetele „WML:” sau „NK:” în gazde.cfg(5) fişier. Dacă nu sunt specificate teste, toate testele
vor fi incluse.

--nstab=NUME FIȘIER
Generați un fișier HTML potrivit pentru o intrare din bara laterală Netscape 6/Mozilla. De fapt
permiteți utilizatorilor dvs. să obțină o astfel de intrare în bara laterală, aveți nevoie de acest cod Javascript
o pagină web (de exemplu, o puteți include în fișierul $XYMONHOME/web/stdnormal_header):


<!--
funcția addNetscapePanel() {
if ((tip de fereastră.sidebar == „obiect”) &&
(typeof window.sidebar.addPanel == „funcție”))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html","");
altfel
alert(„Bara laterală numai pentru Mozilla sau Netscape 6+”);
}
// ->


și apoi puteți include un link „Adăugați acest lucru în bara laterală” folosind acesta ca șablon:

Adăugați în bara laterală

sau dacă preferați să aveți butonul standard „Adăugați filă” Netscape, ați face-o
cu


<IMG SRC="/gifs/add-button.gif" HEIGHT=45 WIDTH=100
ALT="[Adăugați bară laterală]" STYLE="border:0">


„add-button.gif” este disponibil de la Netscape la
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Dacă FILENAME nu începe cu o bară oblică, fișierul din bara laterală Netscape este plasat în
directorul $XYMONHOME/www/.

--nslimit=CULOARE
Culoarea minimă care trebuie inclusă în bara laterală Netscape - implicit este „roșu”, adică
sunt incluse doar alertele critice. Dacă doriți să includeți și avertismente, utilizați
„--nslimit=galben”.

--rss Generați fluxul de livrare de conținut RSS/RDF al alertelor dvs. Xymon. Acest format de ieșire
poate fi încorporat dinamic în alte pagini web, la fel ca deseori fluxurile de știri live
văzute pe site-uri web. Vor fi generate două fișiere RSS, unul reflectă „Toate non-
verde", celălalt reflectă pagina "Critică". Vor fi în
fișierele „nongreen.rss” și, respectiv, „critical.rss”. În plus, un fișier RSS
va fi generat pentru fiecare pagină și/sau subpagină care listează gazdele prezente pe aceasta
pagină sau subpagină.
Parametrul FILENAME permis anterior pentru opțiunea --rss este acum învechit.
Pentru mai multe informații despre fluxurile de conținut RSS/RDF, consultați
http://www.syndic8.com/.

--rssextension=.EXTENSIUNE
Setează extensia numelui de fișier utilizată pentru fișierele RSS generate de xymongen. De
implicit, este folosită o extensie „.rss”. Rețineți că trebuie să specificați „punctul”.

--rssversion={0.91|0.92|1.0|2.0}
Formatul de ieșire dorit al fluxului RSS/RDF. Versiunea 0.91 pare a fi cea mai mare
format utilizat în mod obișnuit și este implicit dacă această opțiune este omisă.

--rsslimit=CULOARE
Culoarea minimă de inclus în fluxul RSS - implicit este „roșu”, adică numai
sunt incluse alertele critice. Dacă doriți să includeți și avertismente, utilizați
„--rsslimit=galben”.

OPŢIUNI FOLOSIT BY CGI FRONȚE

--reportopts=START:END:DYNAMIC:STYLE
Invocați xymongen în modul de generare a rapoartelor. Acesta este folosit în mod normal de către
raport.cgi(1) Script CGI, dar poate fi folosit și direct la generare prealabilă
rapoarte. Parametrul START este ora de pornire a raportului în Unix time_t
format (secunde de la 1 ianuarie 1970 00:00 UTC); END este ora de încheiere a raportului;
DYNAMIC este 0 pentru un raport predefinit și 1 pentru un raport dinamic (on-line); STIL este
„crit” pentru a include numai evenimentele critice (roșu), „nongr” pentru a include toate evenimentele non-verzi
evenimente și „toate” pentru a include toate evenimentele.

--csv=NUME FIȘIER
Folosit împreună cu --reportopts, acest lucru face ca xymongen să genereze o disponibilitate
raport sub forma unui fișier cu valori separate prin virgulă (CSV). Acest format este de obicei
utilizat pentru importarea în foi de calcul pentru procesare ulterioară.
Fișierul CSV include marcaje temporale Unix. Pentru a le afișa ca timpi citibili de om în
Excel, formula =C2/86400+DATEVALUE(1-ian-1970) (dacă aveți marcajul de timp Unix
în celula C2) pot fi utilizate. Celula rezultată trebuie formatată ca dată/oră
camp. Rețineți că marcajele de timp sunt în UTC, așa că poate fi necesar să vă ocupați și local
problemele de fus orar și ora de oră.

--csvdelim=DELIMITER
În mod implicit, o virgulă este utilizată pentru a delimita câmpurile din ieșirea CSV. Unele non-engleze
foile de calcul folosesc un delimitator diferit, de obicei punct și virgulă. Pentru a genera un CSV
fișier cu delimitatorul corespunzător, puteți utiliza această opțiune pentru a seta caracterul utilizat
ca delimitator. De exemplu, „--csvdelim=;” - rețineți că, în mod normal, aceasta ar trebui să fie în dublu
ghilimele, pentru a împiedica shell-ul Unix să interpreteze caracterul delimitator ca a
delimitator de linie de comandă.

--snapshot=TIME
Generați un instantaneu al paginilor Xymon, așa cum au apărut la TIME. TIMPUL este dat ca
secunde de la 1 ianuarie 1970 00:00 UTC. Utilizat în mod normal prin intermediul instantaneu.cgi(1) CGI
script-ul.

DEBUGARE OPŢIUNI

--depanare
Determină xymongen să arunce cantități mari de ieșire de depanare în stdout, dacă a fost
compilat cu -DDEBUG activat. Când raportați o problemă cu xymongen, vă rugăm
încercați să reproduceți problema și furnizați rezultatul rulării xymongen cu aceasta
opțiune.

--sincronizare
Transferați informații despre timpul petrecut de diferite părți ale xymongen la stdout. Acest
este util pentru a vedea ce parte a procesării este responsabilă de durata de rulare a
ximongen.
Notă: Aceste informații sunt furnizate și în rezultatul trimis pe afișajul Xymon
când utilizați opțiunea „--report”.

BUILDING ALTERNATIV PAGESETS

Cu versiunea 1.4 a xymongen vine posibilitatea de a genera mai multe seturi de pagini din
aceleași date.
Să presupunem că aveți două grupuri de persoane care se uită la paginile web Xymon. Grupul A vrea
au gazdele grupate după client, cărora le aparțin. Iată cum ați configurat Xymon -
setul de pagini implicit. Acum grupul B vrea să aibă gazdele grupate după sistemul de operare -
să-i numim setul „os”. Apoi ați adăuga aspectul paginii la hosts.cfg astfel:

ospage win Microsoft Windows
ossubpage win-nt4 MS Windows NT 4
Servere de fișiere osgroup NT4
servere de e-mail osgroup NT4
ossubpage win-xp MS Windows XP
ospage unix Unix
subpagina unix-sun Solaris
ossubpage unix-linux Linux

Aceasta definește un set de pagini cu o pagină de nivel superior (pagina xymon.html), două pagini
legat de la xymon.html (win.html și unix.html), iar de la pagina win.html există
subpaginile win-nt4.html și win-xp.html
Sintaxa este identică cu directivele normale „pagină” și „subpagină” din hosts.cfg, dar
directiva este prefixată cu numele setului de pagini. Nu puneți nicio gazdă între pagină
și directivele de subpagină - doar adăugați toate directivele în partea de sus a fișierului hosts.cfg.
Atunci cum adaugi gazde la pagini? Simplu - puneți doar o etichetă „OS:win-xp” pe gazdă
linie de definiție. „OS” trebuie să fie același cu prefixul folosit pentru numele setului de pagini, dar în
majuscule. „win-xp” trebuie să se potrivească cu una dintre paginile sau subpaginile definite în aceasta
set de pagini. De exemplu

207.46.249.190 www.microsoft.com # OS:win-xp http://www.microsoft.com/
64.124.140.181 www.sun.com # OS:unix-sun http://www.sun.com/

Dacă doriți ca gazda să apară într-un grup definit pe pagina respectivă, trebuie să identificați
grupați după număr, începând cu 1. De exemplu, pentru a pune o gazdă în grupul „Servere de e-mail NT4”.
în exemplul de mai sus, utilizați „OS:win-nt4,2” (al doilea grup de pe pagina „win-nt4”).
Dacă doriți ca gazda să apară pe prima pagină în loc de o subpagină, utilizați „OS:*” .

Toate acestea definesc doar aspectul noului set de pagini. Pentru a-l genera, trebuie să rulați
xymongen o dată pentru fiecare set de pagini pe care îl definiți - adică creați un script de extensie ca acesta:

#!/ Bin / sh

XYMONWEB="/xymon/os" $XYMONHOME/bin/xymongen \
--pageset=os --template=os \
$XYMONHOME/www/os/

Salvați acest lucru în $XYMONHOME/ext/os-display.sh și setați-l să ruleze ca extensie Xymon;
aceasta înseamnă adăugarea unei secțiuni suplimentare la tasks.cfg pentru a-l rula.

Aceasta generează paginile. Există câteva opțiuni importante folosite aici:
* XYMONWEB="/xymon/os" variabila de mediu și
Opțiunea „$XYMONHOME/www/os/” lucrează împreună și plasează
fișiere HTML pentru set de pagini noi într-un subdirector în afara normalului
Xymon webroot. Dacă accesați în mod normal paginile Xymon ca
"http://xymon.acme.com/xymon/", vei accesa apoi
noul set de pagini ca „http://xymon.acme.com/xymon/os/"
NB: Directorul dat ca XYMONWEB trebuie să conțină un simbol
link către directorul $XYMONHOME/www/html/ sau linkuri către
mesajele individuale de stare nu vor funcționa. Link-uri similare
ar trebui să fie făcute pentru gif-uri/, ajutor/ și note/
directoare.
* „--pageset=os” îi spune xymongen să structureze paginile web
folosind aspectul „os”, în loc de aspectul implicit.
* „--template=os” îi spune xymongen să folosească un set diferit de
șabloane pentru antet și subsol. În mod normal, xymongen folosește
șablon standard în $XYMONHOME/web/stdnormal_header și
.../stdnormal_footer - cu această opțiune, va folosi în schimb
fișierele „os_header” și „os_footer” din
directorul $XYMONHOME/web/. Acest lucru vă permite să personalizați
anteturi și subsoluri pentru fiecare set de pagini. Dacă vrei doar
pentru a utiliza șablonul normal, puteți omite această opțiune.

UTILIZAREA XYMONGEN PENTRU RAPOARTE

Raportarea xymongen este implementată prin înlocuiri directe pentru Xymon standard
scripturi de raportare (report.sh și reportlog.sh) instalate în serverele dvs. web cgi-bin
director.

Aceste două scripturi shell au fost înlocuite cu două script-uri shell foarte mici, adică doar
configurați variabilele de mediu Xymon și invocați raport.cgi(1) or reportlog.cgi(1)
scripturi în $XYMONHOME/bin/

Puteți utiliza opțiunile din linia de comandă xymongen atunci când generați rapoarte, de exemplu pentru a exclude anumite
tipuri de teste (de ex. „--ignorecolumns=msgs”) din rapoarte, pentru a specifica numele
coloane de tendințe și informații care nu ar trebui să fie în raport sau pentru a formata raportul
diferit (de ex. „--subpagecolumns=2”). Dacă doriți ca anumite opțiuni să fie utilizate atunci când a
raportul este generat din interfața web, puneți aceste opțiuni în dvs
Fișierul $XYMONHOME/etc/xymonserver.cfg în variabila de mediu XYMONGENREPOPTS.

Fișierele de raport generate de xymongen sunt stocate în directoare individuale (unul per
raport) sub directorul $XYMONHOME/www/rep/. Acestea ar trebui curățate automat
- pe măsură ce sunt generate rapoarte noi, cele vechi sunt eliminate.

După instalare, încercați să generați un raport. Probabil veți vedea că linkurile din
colțul din stânga sus (la ack.html, nongreen.html etc.) nu mai funcționează. Pentru a le remedia, schimbați
fișierul dvs. $XYMONHOME/web/repnormal_header, astfel încât aceste linkuri nu se referă la „&XYMONWEB”, ci
la prefixul URL normal pentru paginile dvs. Xymon.

SLA RAPORTAREA

raportarea xymongen permite generarea unui adevărat SLA (Service Level Agreement)
rapoarte, de asemenea pentru perioadele de service care nu sunt 24x7. Acest lucru este activat prin definirea unui
Eticheta „REPORTTIME:timespec” pentru gazde pentru a defini perioada de serviciu și, opțional, a
Eticheta „WARNPCT:level” pentru a defini disponibilitatea convenită.

Notă: vezi gazde.cfg(5) pentru sintaxa exactă a acestor opțiuni.

„REPORTTIME:timespec” specifică ora din zi la care se așteaptă ca serviciul să fie activ și
alergare. În mod implicit, acesta este 24 de ore pe zi, în toate zilele săptămânii. Dacă SLA acoperă numai
Luni-Vineri 7:8 - 0700:2000, definiți acest lucru ca „REPORTTIME=W:XNUMX:XNUMX”, iar generatorul de rapoarte
va calcula apoi atât disponibilitatea normală 24x7, cât și o „disponibilitate SLA” care
ia în considerare doar statutul gazdei în perioada SLA.

Parametrul DOWNTIME:timespec afectează calculul disponibilității SLA. Dacă o întrerupere
are loc în timpul definit ca posibil „DOWNTIME”, apoi defecțiunea este raportată cu a
statutul de „albastru”. (Aceeași culoare este folosită dacă „dezactivați”, apoi găzduiți folosind Xymon
funcția „dezactivare”). Ora în care starea testului este „albastru” nu este inclusă în SLA
calcul, nici în intervalul de timp în care gazda este considerată în jos, nici în
perioada totală de timp pe care o acoperă raportul. Deci, timpul „albastru” este efectiv ignorat de către
Calculul disponibilității SLA, permițându-vă să aveți timpi de nefuncționare planificați fără a afecta
a raportat disponibilitatea SLA.

Exemplu: o gazdă are „DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200” deoarece este repornită
în fiecare zi între orele 7:7.30 și 6:10, dar serviciul trebuie să fie disponibil între orele XNUMX:XNUMX și XNUMX:XNUMX. Pentru
în ziua raportului, acesta a scăzut de la 7:10 la 7:15 (repornirea planificată), dar și
de la 9:53 până la 10:15. Deci, evenimentele zilei sunt:

0700: verde timp de 10 minute (600 de secunde)
0710: albastru timp de 5 minute (300 de secunde)
0715: verde timp de 14 ore 38 minute (52680 secunde)
2153: roșu timp de 22 de minute (1320 de secunde)
2215 : verde

Serviciul este disponibil pentru 600+52680 = 53280 secunde. Este în jos (roșu) timp de 420 de secunde
(ora de la 21:53 până la 22:00 când se încheie perioada SLA). Timpul total inclus în
raportul este de 15 ore (7:10 - 5:53700), cu excepția celor XNUMX minute albastru = XNUMX secunde. Deci, SLA
disponibilitatea este 53280/53700 = 99,22%

Eticheta „WARNPCT:level” este acceptată în fișierul hosts.cfg, pentru a seta disponibilitatea
prag pe bază de gazdă cu gazdă. Acest prag determină dacă un test este raportat ca
verde, galben sau roșu în rapoarte. O valoare implicită poate fi setată pentru toate gazdele cu via
variabila de mediu XYMONREPWARN, dar suprascrisă de această etichetă. Nivelul este dat ca
un procent, de exemplu „WARNPCT:98.5”

PREGENERATE RAPOARTE

În mod normal, xymongen produce rapoarte care leagă la pagini web generate dinamic cu
starea detaliată a unui test (prin script-ul CGI reportlog.sh).

Este posibil ca xymongen să producă un raport fără aceste legături dinamice, deci
raportul poate fi exportat pe alt server. De asemenea, poate fi util să pre-generați
rapoarte, pentru a reduce încărcătura prin faptul că mai mulți utilizatori generează aceleași rapoarte.

Pentru a face acest lucru, trebuie să rulați xymongen cu opțiunea „--reportopts” pentru a selecta ora
intervalul pe care îl acoperă raportul, stilul de raportare (critic, non-verde sau toate evenimentele),
și să solicite să nu fie generate pagini dinamice.

Sintaxa este:

xymongen --reportopts=starttime:endtime:nodynamic:style

„starttime” și „endtime” sunt specificate ca valori Unix time_t, adică secunde de la 1 ianuarie
1970 00:00 GMT. Din fericire, acest lucru poate fi calculat cu ușurință cu utilitarul de dată GNU dacă dvs
utilizați opțiunea de ieșire „+%s”. Dacă nu aveți utilitarul de date GNU, alegeți-l
de pe www.gnu.org; sau puteți folosi utilitarul „etime” în același scop, adică
disponibil din arhiva la www.deadcat.net.

„nodinamic” este fie 0 (pentru pagini dinamice, implicit) fie 1 (pentru nu dinamic, adică pre-
generate, pagini).

„stil” este fie „crit” (include numai evenimentele critice, adică roșii), „nongr” (include toate
evenimente non-verzi) sau „toate” (include toate evenimentele).

Alte opțiuni xymongen pot fi utilizate, de exemplu „--ignorecolumns” dacă doriți să excludeți anumite
teste din raport.

În mod normal, va trebui, de asemenea, să specificați variabila de mediu XYMONWEB (trebuie să se potrivească
URL-ul de bază de unde va fi accesibil raportul) și un director de ieșire
unde sunt salvate fișierele de raport. Dacă specificați XYMONWEB, probabil că ar trebui și
definiți variabilele de mediu XYMONHELPSKIN și XYMONNOTESSKIN. Acestea ar trebui să indice
adresa URL în care se află fișierele dvs. de ajutor și note Xymon; dacă nu sunt definite,
link-urile către fișierele de ajutor și note vor indica în directorul de raport și probabil vor
nu funcționează.

Deci, o invocare tipică a xymongenului pentru un raport static ar fi:

START=`data +%s --date="22 iunie 2003 00:00:00"`
END=`date +%s --date="22 iunie 2003 23:59:59"`
XYMONWEB=/reports/bigbrother/daily/2003/06/22 \
XYMONHELPSKIN=/xymon/help \
XYMONNOTESSKIN=/xymon/note \
xymongen --reportopts=$START:$END:1:crit \
--subpagecolumns=2 \
/var/www/docroot/reports/xymon/daily/2003/06/22

Setarea „XYMONWEB” înseamnă că raportul va fi disponibil cu o adresă URL de
"http://www.server.com/reports/xymon/daily/2003/06/22„. Raportul conține interne
link-uri care folosesc această adresă URL, deci nu poate fi mutată cu ușurință într-o altă locație.

Ultimul parametru este directorul fizic corespunzător de pe serverul dvs. web care se potrivește cu
Adresa URL XYMONWEB. Desigur, puteți crea fișierele de raport oriunde doriți - poate și pe
altă mașină - și apoi mutați-le pe serverul web mai târziu.

Rețineți cum data(1) utilitarul este utilizat pentru a calcula parametrii de început și de sfârșit.

MEDIUL VARIABILE

BOARDFILTER
Filtru folosit pentru a selecta ce gazde/teste sunt incluse în paginile web, prin filtrare
datele preluate de la xymond prin comanda xymondboard. Vedea ximon(1) pentru detalii
pe sintaxa filtrului. În mod implicit, nu se face nicio filtrare.

Utilizați xymongen online folosind serviciile onworks.net