xymongen - Online nel cloud

PROGRAMMA:

NOME

xymongen - Generatore di pagine web Xymon

SINOSSI

ximogene -?
ximogene --Aiuto
ximogene --versione
ximogene [opzioni] [cartella di destinazione]
(Vedi la sezione OPZIONI per una descrizione delle opzioni della riga di comando disponibili).

DESCRIZIONE

ximogene genera le pagine web di panoramica per il monitor Xymon. Queste sono le pagine web
che mostrano lo stato generale dei tuoi host, non le pagine di stato dettagliate per ogni test.

Nota: i dati per le pagine Web vengono recuperati dal xymond(8) demone, e utilizza xymongen
i valori delle variabili d'ambiente XYMSRV / XYMSERVERS per determinare la rete
indirizzo dove xymond può essere raggiunto. Se hai più di un server elencato in
XYMSERVERS, assicurati che il primo sia il server Xymon locale - questo è quello che
xymongen cercherà i dati.

VERSIONI

xymongen ha un gran numero di opzioni della riga di comando. Le opzioni possono essere utilizzate per modificare
il comportamento di xymongen e influenzare le pagine web da esso generate.

GENERALE VERSIONI

--aiuto o -?
Fornire un riepilogo delle opzioni della riga di comando disponibili.

--versione
Stampa il numero di versione di xymongen

--docurl=URL
Questa opzione è deprecata, usa l'impostazione HOSTDOCURL in xymonserver.cfg(5)
anziché.

--doccgi=URL
Questa opzione è deprecata, usa l'impostazione HOSTDOCURL in xymonserver.cfg(5)
anziché.

--doc-finestra
Fa sì che i collegamenti alla documentazione per host e servizi si aprano in una nuova finestra. Il
l'impostazione predefinita è mostrare la documentazione nella stessa finestra del browser dello stato di Xymon.

--htmlestensione=.ESTENSIONE
Imposta l'estensione del nome file utilizzata per le pagine Web generate da xymongen. Di
per impostazione predefinita, viene utilizzata un'estensione di ".html". Notare che è necessario specificare il "punto".

--report[=NOME COLONNA]
Con questa opzione, xymongen invierà un messaggio di stato con i dettagli di quanti
gli host sono stati elaborati, quante pagine sono state generate, eventuali errori che si sono verificati
durante la corsa e alcune statistiche sui tempi. Il nome della colonna predefinito è "xymongen".

--htaccess[=nomefile-htaccess]
Crea file .htaccess quando vengono create nuove directory di pagine web. Il contenuto di
i file .htaccess sono determinati dalla variabile d'ambiente XYMONHTACCESS (per
la directory di primo livello con xymon.html e nongreen.html); dal
variabile XYMONPAGEHTACCESS (per le directory a livello di pagina); e dal
Variabile XYMONSUBPAGEHTACCESS per directory a livello di sottopagina e sottoprincipale. Il
il nome file dei file .htaccess per impostazione predefinita è ".htaccess" se non viene fornito alcun nome file con
questa opzione. La variabile XYMONHTACCESS viene copiata letteralmente nel livello superiore
file .htaccess. La variabile XYMONPAGEHTACCESS può contenere un "%s" dove il nome
della pagina è inserita. La variabile XYMONSUBPAGEHTACCESS può contenere due "%s"
istanze: il primo viene sostituito con il nome della pagina, il secondo con il
nome della sottopagina.

--max-eventcount=N
Limita il registro eventi nella pagina "Tutti non verdi" a soli N eventi. Valore predefinito: 100.

--max-ora-evento=N
Limita il registro eventi nella pagina "Tutti non verdi" agli eventi che si sono verificati all'interno del
ultimi N minuti. Valore predefinito: 240.

--no-log-eventi
Disabilita il registro eventi normalmente visualizzato nella pagina "Tutti non verdi"

--max-account=N
Limita il registro di riconoscimento nella pagina "Tutti non verdi" a soli N eventi. Predefinito:
25

--max-tempo di risposta=N
Limita il registro di riconoscimento nella pagina "Tutti non verdi" agli ack che si sono verificati
negli ultimi N minuti. Valore predefinito: 240.

--no-riconoscimento
Disabilitare il registro di riconoscimento normalmente visualizzato nella pagina "Tutti non verdi".

--cricitcallog[=Colonna registro critico]
Questo genera un registro testuale di ciò che viene mostrato nella pagina di stato di critical.html,
e invia un messaggio di stato per il server Xymon stesso che riflette il colore del
Pagina di stato critico. Ciò consente di monitorare quando sono comparsi problemi sul
pagina di stato critico. Il file di registro è memorizzato in $XYMONSERVERLOGS/criticalstatus.log

--loadhostsfromxymond
Invece di leggere il file hosts.cfg, xymongen caricherà il file hosts.cfg
configurazione dal demone xymond. Questo elimina la necessità di leggere il
host.cfg, e se hai xymond e xymongen in esecuzione su host diversi, anche questo
elimina la necessità di copiare il file hosts.cfg tra i sistemi. Nota che il
L'opzione "disinclude" in hosts.cfg viene ignorata quando questa opzione è abilitata.

PAGINA LAYOUT VERSIONI

Queste opzioni influenzano il modo in cui le pagine Web generate da xymongen vengono visualizzate nel browser.

--ultima pagina
Metti i link di pagine e sottopagine dopo gli host.

--pagine-prima
Metti i collegamenti alle pagine e alle sottopagine prima degli host (impostazione predefinita).

Queste due opzioni decidono se una pagina con collegamenti a sottopagine e host ha il
host o prima le sottopagine.

--subpagecolumns=N
Determina il numero di colonne utilizzate per i collegamenti a pagine e sottopagine. Il predefinito
è N=1.

--maxrighe=N
Le intestazioni di colonna su una pagina vengono visualizzate per impostazione predefinita solo all'inizio di una pagina,
sottopagina o gruppo di host. Questa opzione fa sì che le intestazioni delle colonne si ripetano per
ogni N host mostrati.

--showgruppi vuoti

--no-showgruppi vuoti
Quando i gruppi sono host vengono creati, visualizza la tabella e i nomi degli host anche se ce ne sono
nessun test presente per nessuno degli host in questione. Usa --no-showemptygroups per
nascondere. (Predefinito: sì)

--pagetitle-link
Normalmente, solo i "puntini" colorati accanto a una pagina o sottopagina fungono da link al
pagina stessa. Con questa opzione, anche il titolo della pagina si collegherà alla pagina.

--pagetext-intestazioni
Usa il testo della descrizione dai tag "pagina" o "sottopagina" come intestazione per il
pagina, invece di "Pagine ospitate localmente" o di un'altra intestazione standard.

--no-sottolineatura-intestazioni
Normalmente, le intestazioni delle pagine sono sottolineate utilizzando un tag HTML "righello orizzontale". Questo
opzione disabilita la sottolineatura delle intestazioni.

--recentgifs[=MINUTI]
Usa immagini denominate COLOR-recent.gif per i test, in cui lo stato del test è cambiato
nelle ultime 24 ore. Questi file GIF devono essere installati nel
$XYMONHOME/www/gifs/ directory. Per impostazione predefinita, la soglia è impostata su 24 ore - se
se lo vuoi in modo diverso, puoi specificare anche il limite di tempo. Per esempio
"--recentgifs=3h" mostrerà le GIF recenti solo per 3 ore dopo un cambiamento di stato.

--sort-solo-gruppo-elementi
In una normale direttiva "group-only", puoi specificare l'ordine in cui i test
vengono visualizzati, da sinistra a destra. Se preferisci avere i test elencati in
ordine alfabetico, usa questa opzione - la pagina genererà quindi "solo gruppo"
groups come genera gruppi normali e ordina i test in ordine alfabetico.

--dialupskin=URL
Se vuoi mostrare visivamente che un test è un dialup-test, puoi usare un'alternativa
set di icone per il verde/rosso/giallo>/ecc. immagini specificando questa opzione. Il
Il parametro URL specificato qui sovrascrive l'impostazione normale di XYMONSKIN
variabile d'ambiente, ma solo per i test di accesso remoto.

--reverseskin=URL
Uguale a "--dialupskin", ma per i test inversi (test con '!' davanti).

--tooltips=[sempre,mai,principale]
Determina quali pagine utilizzano i suggerimenti per mostrare la descrizione dell'host (da
COMMENTO entrata nel host.cfg(5) file). Se impostato su sempre, i tooltip sono usati su tutti
pagine. Se impostato su mai, le descrizioni comandi non vengono mai utilizzate. Se impostato su principale, vengono utilizzati i tooltip
nelle pagine principali, ma non nelle pagine "Tutti i non verdi" o "Sistemi critici".

COLONNA SELEZIONE VERSIONI

Queste opzioni influenzano quali colonne (test) sono incluse nelle pagine web generate da
ximogene.

--ignorecolonne=test[,test]
Le colonne fornite verranno completamente ignorate da xymongen durante la generazione di pagine web.
Può essere utilizzato per generare report in cui si eliminano alcuni dei test più rumorosi,
come "messaggi".

--critical-red-only
Nella pagina Critico verranno incluse solo le colonne di stato rosse. Per impostazione predefinita, il
La pagina critica conterrà host con stato rosso, giallo e chiaro.

--nongreen-colors=COLORE[,COLORE]
Definisce quali colori fanno apparire un test nella pagina di stato "Tutti non verdi".
COLORE è rosso, giallo o viola. L'impostazione predefinita è includere tutti e tre.

--nongreen-ignorecolumns=test[,test]
Uguale a --ignorecolumns, ma si applica solo agli host nella pagina "Tutti non verdi".

--nongreen-ignorepurples
Deprecato, usa invece "--nongreen-colors".

--nongreen-ignoredalups
Ignora tutti gli host dialup nella pagina "Tutti non verdi", incluso il registro eventi.

--no-pagine
Non generare le pagine normali (normalmente utilizzate per generare solo le pagine non verdi
pagina).

--no-nonverde
Non generare la pagina "Tutti non verdi".

--includecolumns=prova[,prova]
Includi sempre queste colonne nella pagina "Tutte le non verdi" Includerà determinate colonne
nella pagina nongreen.html, indipendentemente dal colore. Normalmente, nongreen.html rilascia a
colonna-test, se tutti i test sono verdi. Questo può essere usato ad esempio per avere sempre un collegamento a
la colonna delle tendenze (con i grafici RRD) dalla tua pagina nongreen.html.

--eventignore=prova[,prova]
Ignorare questi test nella visualizzazione del registro eventi "Tutti non verdi".

STATUS PROPAGAZIONE VERSIONI

Queste opzioni sopprimono la normale propagazione di uno stato verso l'alto nella gerarchia delle pagine.
Pertanto, puoi avere un test con stato giallo o rosso, ma avere ancora l'intera pagina verde.
È utile per i test che non devono causare un allarme, ma in cui si desidera comunque conoscere il
stato effettivo. Queste opzioni impostano i valori predefiniti globali per tutti gli host; puoi usare il NOPROPRED
e i tag NOPROPYELLOW nel host.cfg(5) file per applicare limiti simili su un host
base.

--nopropyellow=test[,test] o --noprop=test[,test]
Disabilita la propagazione dello stato verso l'alto quando è GIALLO. L'opzione "--noprop" è deprecata
e non dovrebbe essere utilizzato.

--noproppurple=prova[,prova]
Disabilita la propagazione dello stato verso l'alto quando VIOLA.

--nopropred=prova[,prova]
Disabilita la propagazione dello stato verso l'alto quando ROSSO o GIALLO.

--nopropack=prova[,prova]
Disabilita la propagazione dello stato verso l'alto quando lo stato è stato riconosciuto. Se vuoi
per disabilitare la propagazione di tutti i test confermati, utilizzare "--nopropack=*".

PURPLE STATUS VERSIONI

Gli stati viola si verificano quando la segnalazione di uno stato di test si interrompe. Uno stato di test è valido per a
tempo limitato - normalmente 30 minuti - e dopo questo tempo, il test diventa
viola.

--purplelog=NOMEFILE
Genera un file di registro di tutti i messaggi di stato viola.

ALTERNATIVA PAGINA VERSIONI

--pageset=NOMESETPAGINA
Crea pagine web per un set di pagine alternativo a quello predefinito. Vedi la sezione PAGESET
qua sotto.

--template=MODELLO
Usa un modello alternativo per i file di intestazione e piè di pagina. Tipicamente usato insieme al
l'opzione "--pageset"; vedere la sezione PAGESET di seguito.

ALTERNATIVA USCITA FORMATI

--wml[=prova1,prova2,...]
Questa opzione fa sì che xymongen generi un insieme di file "scheda" WML che possono essere
accessibile da un dispositivo WAP (cellulare, PDA ecc.) I file generati contengono i
host che hanno uno stato ROSSO o GIALLO sui test specificati. Questa opzione può definire
i test predefiniti da includere: i valori predefiniti possono essere sovrascritti o modificati utilizzando il pulsante
Tag "WML:" o "NK:" nel host.cfg(5) file. Se non viene specificato alcun test, tutti i test
sarà incluso.

--nstab=NOMEFILE
Genera un file HTML adatto a una voce della barra laterale di Netscape 6/Mozilla. In realtà
consentire ai tuoi utenti di ottenere una tale voce della barra laterale, è necessario questo codice Javascript in
una pagina web (ad esempio puoi includerla nel file $XYMONHOME/web/stdnormal_header):


<!--
funzione addNetscapePanel() {
if ((typeof window.sidebar == "oggetto") &&
(tipo di window.sidebar.addPanel == "funzione"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html","");
altro
alert("Sidebar solo per Mozilla o Netscape 6+");
}
// ->


e poi puoi includere un link "Aggiungi questo alla barra laterale" usando questo come modello:

Aggiungi alla barra laterale

o se preferisci avere il pulsante standard "Aggiungi scheda" di Netscape, lo faresti
con


<IMG SRC="/gifs/add-button.gif" ALTEZZA=45 LARGHEZZA=100
ALT="[Aggiungi barra laterale]" STYLE="bordo:0">


Il "add-button.gif" è disponibile da Netscape all'indirizzo
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Se FILENAME non inizia con una barra, il file della barra laterale di Netscape viene posizionato nel
directory $XYMONHOME/www/.

--nslimit=COLORE
Il colore minimo da includere nella barra laterale di Netscape - il valore predefinito è "rosso", che significa
sono inclusi solo gli avvisi critici. Se vuoi includere anche avvisi, usa
"--nslimit=giallo".

--rss Genera il flusso di distribuzione dei contenuti RSS/RDF dei tuoi avvisi Xymon. Questo formato di output
può essere incorporato dinamicamente in altre pagine Web, proprio come i feed di notizie dal vivo spesso
visto sui siti web. Verranno generati due file RSS, uno riflette l'opzione "Tutti non
verde", l'altra riflette la pagina "Critica". Saranno nella
rispettivamente i file "nongreen.rss" e "critical.rss". Inoltre, un file RSS
verrà generato per ogni pagina e/o sottopagina che elenca gli host presenti su quella
pagina o sottopagina.
Il parametro FILENAME precedentemente consentito sull'opzione --rss è ora obsoleto.
Per ulteriori informazioni sui feed di contenuti RSS/RDF, vedere
http://www.syndic8.com/.

--rsseextension=.ESTENSIONE
Imposta l'estensione del nome file utilizzata per i file RSS generati da xymongen. Di
per impostazione predefinita, viene utilizzata un'estensione di ".rss". Nota che è necessario specificare il "punto".

--rssversione={0.91|0.92|1.0|2.0}
Il formato di output desiderato del feed RSS/RDF. La versione 0.91 sembra essere la più
formato comunemente usato ed è l'impostazione predefinita se questa opzione viene omessa.

--rsslimit=COLORE
Il colore minimo da includere nel feed RSS - l'impostazione predefinita è "rosso", che significa solo
gli avvisi critici sono inclusi. Se vuoi includere anche avvisi, usa
"--rsslimit=giallo".

VERSIONI USATO BY CGI FRONT-END

--reportopts=INIZIO:FINE:DINAMICO:STILE
Richiama xymongen in modalità di generazione di report. Questo è normalmente utilizzato dal
report.cgi(1) Script CGI, ma può anche essere utilizzato direttamente durante la pre-generazione
rapporti. Il parametro START è l'ora di inizio del report in Unix time_t
formato (secondi dal 1 gennaio 1970 00:00 UTC); FINE è l'ora di fine del rapporto;
DYNAMIC è 0 per un report predefinito e 1 per un report dinamico (on-line); STILE è
"crit" per includere solo gli eventi critici (rossi), "nongr" per includere tutti gli eventi non verdi
eventi e "all" per includere tutti gli eventi.

--csv=NOMEFILE
Usato insieme a --reportopts, questo fa sì che xymongen generi una disponibilità
report sotto forma di file con valori separati da virgole (CSV). Questo formato è comunemente
utilizzato per l'importazione in fogli di calcolo per ulteriori elaborazioni.
Il file CSV include timestamp Unix. Per visualizzarli come tempi leggibili dall'uomo in
Excel, la formula =C2/86400+DATAVALORE(1-gen-1970) (se hai il timestamp Unix
nella cella C2) può essere utilizzato. La cella del risultato dovrebbe essere formattata come data/ora
campo. Nota che i timestamp sono in UTC, quindi potresti dover gestire anche local
problemi relativi al fuso orario e all'ora legale.

--csvdelim=DELIMITATORE
Per impostazione predefinita, viene utilizzata una virgola per delimitare i campi nell'output CSV. Alcuni non inglesi
i fogli di calcolo utilizzano un delimitatore diverso, in genere il punto e virgola. Per generare un CSV
file con il delimitatore appropriato, puoi usare questa opzione per impostare il carattere utilizzato
come delimitatore. Ad esempio "--csvdelim=" - nota che normalmente questo dovrebbe essere in doppio
virgolette, per impedire alla shell Unix di interpretare il carattere delimitatore come a
delimitatore della riga di comando.

--snapshot=TEMPO
Genera un'istantanea delle pagine Xymon, così come sono apparse alle ore TIME. TIME è dato come
secondi dal 1° gennaio 1970 00:00 UTC. Normalmente utilizzato tramite il istantanea.cgi(1) CGI
script.

DEBUG VERSIONI

- debug
Fa sì che xymongen scarichi grandi quantità di output di debug su stdout, se lo era
compilato con il -DDEBUG abilitato. Quando si segnala un problema con xymongen, per favore
prova a riprodurre il problema e fornisci l'output dall'esecuzione di xymongen con questo
opzione.

--temporizzazione
Scarica le informazioni sul tempo trascorso dalle varie parti di xymongen su stdout. Questo
è utile per vedere quale parte del trattamento è responsabile del runtime di
ximogene.
Nota: queste informazioni sono fornite anche nell'output inviato al display Xymon
quando si utilizza l'opzione "--report".

EDILIZIA ALTERNATIVA PAGESET

Con la versione 1.4 di xymongen arriva la possibilità di generare più set di pagine da
gli stessi dati.
Supponiamo di avere due gruppi di persone che guardano le pagine web di Xymon. Il gruppo A vuole
avere gli host raggruppati dal client a cui appartengono. Ecco come hai impostato Xymon -
il set di pagine predefinito. Ora il gruppo B vuole avere gli host raggruppati per sistema operativo -
chiamiamolo il set "os". Quindi aggiungeresti il ​​layout della pagina a hosts.cfg in questo modo:

ospage vincere Microsoft Windows
ossubpage win-nt4 MS Windows NT 4
osgroup NT4 File server
osgroup NT4 Server di posta
ossubpage win-xp MS Windows XP
pagina unix Unix
ossubpage unix-sun Solaris
ossubpage unix-linux Linux

Questo definisce un insieme di pagine con una pagina di primo livello (la pagina xymon.html), due pagine
linkati da xymon.html (win.html e unix.html), e ad esempio dalla pagina win.html ci sono
sottopagine win-nt4.html e win-xp.html
La sintassi è identica alle normali direttive "page" e "subpage" in hosts.cfg, ma
la direttiva è preceduta dal nome del set di pagine. Non inserire host tra la pagina
e le direttive delle sottopagine: basta aggiungere tutte le direttive all'inizio del file hosts.cfg.
Come si aggiungono host alle pagine, quindi? Semplice: basta inserire un tag "OS:win-xp" sull'host
linea di definizione. Il "SO" deve essere lo stesso del prefisso utilizzato per i nomi dei set di pagine, ma in
maiuscolo. Il "win-xp" deve corrispondere a una delle pagine o sottopagine definite all'interno di questo
insieme di pagine. Per esempio

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

Se vuoi che l'host appaia all'interno di un gruppo definito in quella pagina, devi identificare il
raggruppare per numero, a partire da 1. Es. per inserire un host all'interno del gruppo "NT4 Mail server" in
l'esempio sopra, usa "OS:win-nt4,2" (il secondo gruppo nella pagina "win-nt4").
Se vuoi che l'host venga visualizzato in prima pagina invece che in una sottopagina, usa "OS:*" .

Tutto questo definisce solo il layout del nuovo pageset. Per generarlo, devi eseguire
xymongen una volta per ogni pageset definito, ad esempio creare uno script di estensione come questo:

#!/bin/sh

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

Salvalo in $XYMONHOME/ext/os-display.sh e impostalo per l'esecuzione come estensione Xymon;
questo significa aggiungere una sezione extra a task.cfg per eseguirlo.

Questo genera le pagine. Ci sono alcune opzioni importanti utilizzate qui:
* Variabile d'ambiente XYMONWEB="/xymon/os" e il
L'opzione "$XYMONHOME/www/os/" funziona insieme e posiziona il
nuovi file HTML del set di pagine in una sottodirectory fuori dal normale
Xymon webroot. Se normalmente accedi alle pagine Xymon come
"http://xymon.acme.com/xymon/", quindi accederai
il nuovo pageset come "http://xymon.acme.com/xymon/os/"
NB: La directory indicata come XYMONWEB deve contenere un simbolico
link alla directory $XYMONHOME/www/html/ o link a
i messaggi di stato individuali non funzioneranno. Link simili
dovrebbe essere fatto per le gif/, l'aiuto/ e le note/
directory.
* "--pageset=os" dice a xymongen di strutturare le pagine web
utilizzando il layout "os", invece del layout predefinito.
* "--template=os" dice a xymongen di usare un diverso insieme di
modelli di intestazione e piè di pagina. Normalmente xymongen utilizza il
modello standard in $XYMONHOME/web/stdnormal_header e
.../stdnormal_footer - con questa opzione, utilizzerà invece
i file "os_header" e "os_footer" dal
$XYMONHOME/web/ directory. Questo ti permette di personalizzare
intestazioni e piè di pagina per ogni set di pagine. Se solo vuoi
per utilizzare il modello normale, puoi omettere questa opzione.

UTILIZZO XYMONGEN PER RAPPORTI

Il reporting xymongen è implementato tramite sostituzioni drop-in per lo standard Xymon
script di reporting (report.sh e reportlog.sh) installati nei tuoi server web cgi-bin
directory.

Questi due script di shell sono stati sostituiti con due script di shell molto piccoli, che semplicemente
impostare le variabili di ambiente Xymon e invocare il report.cgi(1) or reportlog.cgi(1)
script in $XYMONHOME/bin/

È possibile utilizzare le opzioni della riga di comando di xymongen durante la generazione di report, ad esempio per escludere alcuni
tipi di test (es. "--ignorecolumns=msgs") dai report, per specificare il nome del
colonne di tendenze e informazioni che non dovrebbero essere nel report o per formattare il report
in modo diverso (es. "--subpagecolumns=2"). Se si desidera utilizzare determinate opzioni quando a
il report viene generato dall'interfaccia web, inserisci queste opzioni nel tuo
$XYMONHOME/etc/xymonserver.cfg nella variabile di ambiente XYMONGENREPOPTS.

I file di report generati da xymongen sono memorizzati in directory individuali (una per
report) sotto la directory $XYMONHOME/www/rep/. Questi dovrebbero essere ripuliti automaticamente
- quando vengono generati nuovi rapporti, quelli vecchi vengono rimossi.

Dopo l'installazione, prova a generare un rapporto. Probabilmente vedrai che i link nel
l'angolo in alto a sinistra (a ack.html, nongreen.html ecc.) non funziona più. Per risolverli, cambia
il tuo file $XYMONHOME/web/repnormal_header in modo che questi collegamenti non facciano riferimento a "&XYMONWEB" ma
al normale prefisso URL per le tue pagine Xymon.

SLA REPORTING

Il reporting xymongen consente la generazione di veri SLA (Service Level Agreement)
report, anche per periodi di servizio non 24x7. Ciò è abilitato definendo a
Tag "REPORTTIME:timespec" per gli host per definire il periodo di servizio e, facoltativamente, a
Tag "WARNPCT:level" per definire la disponibilità concordata.

Nota: vedere host.cfg(5) per l'esatta sintassi di queste opzioni.

"REPORTTIME:timespec" specifica l'ora del giorno in cui il servizio dovrebbe essere attivo e
in esecuzione. Per impostazione predefinita, è 24 ore al giorno, tutti i giorni della settimana. Se il tuo SLA copre solo
Lun-ven 7:8 - 0700:2000, definisci questo come "REPORTTIME=W:XNUMX:XNUMX" e il generatore di report
calcolerà quindi sia la normale disponibilità 24x7 ma anche una "disponibilità SLA" che
tiene conto solo dello stato dell'host durante il periodo SLA.

Il parametro DOWNTIME:timespec influisce sul calcolo della disponibilità SLA. Se un'interruzione
si verifica durante il tempo definito come possibile "DOWNTIME", quindi il guasto viene segnalato con a
stato di "blu". (Lo stesso colore viene utilizzato se si "disabilita" quindi l'host utilizzando Xymon
funzione “disattiva”). Il tempo in cui lo stato del test è "blu" non è incluso nello SLA
calcolo, né nella quantità di tempo in cui l'ospite è considerato giù, né nella
tempo totale coperto dal rapporto. Quindi il tempo "blu" viene effettivamente ignorato dal
Calcolo della disponibilità SLA, che consente di avere tempi di fermo pianificati senza influire sul
disponibilità SLA segnalata.

Esempio: un host ha "DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200" perché è stato riavviato
tutti i giorni dalle 7:7.30 alle 6:10, ma il servizio deve essere disponibile dalle XNUMX:XNUMX alle XNUMX:XNUMX. Per
il giorno del rapporto, era sceso dalle 7:10 alle 7:15 (il riavvio pianificato), ma anche
dalle 9:53 alle 10:15. Quindi gli eventi della giornata sono:

0700 : verde per 10 minuti (600 secondi)
0710 : blu per 5 minuti (300 secondi)
0715 : verde per 14 ore 38 minuti (52680 secondi)
2153 : rosso per 22 minuti (1320 secondi)
2215: verde

Il servizio è disponibile per 600+52680 = 53280 secondi. È giù (rosso) per 420 secondi
(l'ora dalle 21:53 alle 22:00 quando termina il periodo SLA). Il tempo totale incluso nel
il rapporto è di 15 ore (7:10 - 5:53700) tranne i XNUMX minuti blu = XNUMX secondi. Quindi lo SLA
la disponibilità è 53280/53700 = 99,22%

Il tag "WARNPCT:level" è supportato nel file hosts.cfg, per impostare la disponibilità
soglia su base host per host. Questa soglia determina se un test è segnalato come
verde, giallo o rosso nei rapporti. È possibile impostare un valore predefinito per tutti gli host con via
la variabile di ambiente XYMONREPWARN, ma sovrascritta da questo tag. Il livello è dato come
una percentuale, ad es. "WARNPCT:98.5"

PRE-GENERATO RAPPORTI

Normalmente, xymongen produce report che si collegano a pagine Web generate dinamicamente con il
stato dettagliato di un test (tramite lo script CGI reportlog.sh).

È possibile fare in modo che xymongen produca un report senza questi collegamenti dinamici, quindi il
report può essere esportato su un altro server. Può anche essere utile pre-generare il
report, per ridurre il carico facendo in modo che più utenti generino gli stessi report.

Per fare ciò, devi eseguire xymongen con l'opzione "--reportopts" per selezionare l'ora
l'intervallo coperto dal report, lo stile di reporting (critico, non verde o tutti gli eventi),
e per richiedere che non vengano generate pagine dinamiche.

La sintassi è:

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

"starttime" e "endtime" sono specificati come valori Unix time_t, cioè secondi dal 1 gennaio
1970 00:00 GMT. Fortunatamente, questo può essere facilmente calcolato con l'utility GNU date se tu
usa l'opzione di output "+%s". Se non hai l'utilità per la data GNU, prendila
da www.gnu.org; oppure puoi usare l'utility "etime" per lo stesso scopo, che è
disponibile nell'archivio su www.deadcat.net.

"nodynamic" è 0 (per le pagine dinamiche, il valore predefinito) o 1 (per no dynamic, cioè pre-
generato, pagine).

"stile" è "crit" (includi critici cioè solo eventi rossi), "nongr" (includi all
eventi non verdi) o "tutti" (include tutti gli eventi).

È possibile utilizzare altre opzioni xymongen, ad esempio "--ignorecolumns" se si desidera escludere alcune
prove dal verbale.

Normalmente dovrai anche specificare la variabile d'ambiente XYMONWEB (deve corrispondere
l'URL di base da cui sarà reso accessibile il report) e una directory di output
dove vengono salvati i file di report. Se specifichi XYMONWEB, probabilmente dovresti anche
definire le variabili di ambiente XYMONHELPSKIN e XYMONNOTESSKIN. Questi dovrebbero puntare a
l'URL in cui si trovano i file della guida e delle note di Xymon; se non sono definiti, il
i collegamenti ai file di aiuto e note punteranno all'interno della directory dei report e probabilmente lo faranno
non funziona.

Quindi una tipica invocazione di xymongen per un report statico sarebbe:

INIZIO=`data +%s --data="22 giugno 2003 00:00:00"`
FINE=`data +%s --date="22 giugno 2003 23:59:59"`
XYMONWEB=/rapporti/fratello maggiore/giornaliero/2003/06/22 \
XYMONHELPSKIN=/xymon/aiuto \
XYMONNOTESSKIN=/xymon/note \
xymongen --reportops=$START:$END:1:crit \
--subpagecolumns=2 \
/var/www/docroot/reports/xymon/daily/2003/06/22

L'impostazione "XYMONWEB" significa che il rapporto sarà disponibile con un URL di
"http://www.server.com/reports/xymon/daily/2003/06/22". Il rapporto contiene interni
collegamenti che utilizzano questo URL, quindi non può essere facilmente spostato in un'altra posizione.

L'ultimo parametro è la directory fisica corrispondente sul tuo server web che corrisponde a
XYMONWEB URL. Ovviamente puoi creare i file di report ovunque tu voglia, forse su
un'altra macchina - e poi spostarli sul server web in un secondo momento.

Nota come quando(1) l'utilità viene utilizzata per calcolare i parametri dell'ora di inizio e di fine.

AMBIENTE VARIABILI

FILTRO SCHEDA
Filtro utilizzato per selezionare quali host/test sono inclusi nelle pagine Web, filtrando
i dati recuperati da xymond vi il comando xymondboard. Vedere ssimo(1) per dettagli
sulla sintassi del filtro. Per impostazione predefinita, non viene eseguito alcun filtro.

Usa xymongen online utilizzando i servizi onworks.net