xymongen - Online in de cloud

PROGRAMMA:

NAAM

xymongen - Xymon-webpaginagenerator

KORTE INHOUD

xymongen -?
xymongen --help
xymongen --versie
xymongen [Opties] [uitvoermap]
(Zie het gedeelte OPTIES voor een beschrijving van de beschikbare opdrachtregelopties).

PRODUCTBESCHRIJVING

xymongen genereert de overzichtspagina's voor de Xymon-monitor. Dit zijn de webpagina's
die de algemene status van uw hosts tonen, niet de gedetailleerde statuspagina's voor elke test.

Let op: De gegevens voor de webpagina's worden opgehaald uit de xymond(8) daemon en xymongen gebruikt
de waarden van de XYMSRV / XYMSERVERS-omgevingsvariabelen om het netwerk te bepalen
adres waar xymond bereikbaar is. Als u meer dan één server heeft vermeld in
XYMSERVERS, zorg ervoor dat de eerste de lokale Xymon-server is - dit is degene die
xymongen zal naar gegevens opvragen.

OPTIES

xymongen heeft een groot aantal opdrachtregelopties. De opties kunnen worden gebruikt om te wijzigen
het gedrag van xymongen en beïnvloeden de webpagina's die erdoor worden gegenereerd.

ALGEMEEN OPTIES

--help of -?
Geef een overzicht van de beschikbare opdrachtregelopties.

--versie
Drukt het versienummer van xymongen af

--docrul=URL
Deze optie is verouderd. Gebruik de instelling HOSTDOCURL in xymonserver.cfg(5)
gebruiken.

--doccgi=URL
Deze optie is verouderd. Gebruik de instelling HOSTDOCURL in xymonserver.cfg(5)
gebruiken.

--doc-venster
Zorgt ervoor dat koppelingen naar documentatie voor hosts en services in een nieuw venster worden geopend. De
standaard is om documentatie in hetzelfde browservenster weer te geven als de Xymon-status.

--htmlextension=.EXTENSIE
Stelt de bestandsnaamextensie in die wordt gebruikt voor de webpagina's die door xymongen worden gegenereerd. Door
standaard wordt de extensie ".html" gebruikt. Merk op dat u de "punt" moet specificeren.

--rapport[=KOLOMNAAM]
Met deze optie verzendt xymongen een statusbericht met details over het aantal
hosts zijn verwerkt, hoeveel pagina's er zijn gegenereerd en eventuele fouten die zijn opgetreden
tijdens de run, en enkele timingstatistieken. De standaardkolomnaam is "xymongen".

--htaccess[=htaccess-bestandsnaam]
Maak .htaccess-bestanden wanneer er nieuwe webpaginamappen worden gemaakt. De inhoud van
de .htaccess-bestanden worden bepaald door de XYMONHTACCESS-omgevingsvariabele (voor
de map op het hoogste niveau met xymon.html en nongreen.html); Door de
XYMONPAGEHTACCESS variabele (voor de mappen op paginaniveau); en door de
XYMONSUBPAGEHTACCESS-variabele voor mappen op subpagina- en subbovenliggend niveau. De
bestandsnaam van de .htaccess-bestanden is standaard ".htaccess" als er geen bestandsnaam is opgegeven
deze optie. De XYMONHTACCESS-variabele wordt letterlijk gekopieerd naar het hoogste niveau
.htaccess-bestand. De XYMONPAGEHTACCESS-variabele kan een "%s" bevatten waar de naam
van de pagina wordt ingevoegd. De XYMONSUBPAGEHTACCESS-variabele kan twee "%s" bevatten
instances: De eerste wordt vervangen door de paginanaam, de tweede door de
subpaginanaam.

--max-eventcount=N
Beperk het gebeurtenislogboek op de pagina 'Alle niet-groen' tot slechts N gebeurtenissen. Standaard: 100.

--max-gebeurtenistijd=N
Beperk het gebeurtenislogboek op de pagina 'Alle niet-groene' tot gebeurtenissen die hebben plaatsgevonden binnen de
afgelopen N minuten. Standaard: 240.

--no-eventlog
Schakel het gebeurtenislogboek uit dat normaal wordt weergegeven op de pagina 'Alles niet groen'

--max-accountcount=N
Beperk het bevestigingslogboek op de pagina 'Alle niet-groen' tot slechts N gebeurtenissen. Standaard:
25.

--max-acktime=N
Beperk het bevestigingslogboek op de pagina 'Alle niet-groene' tot bevestigde bevestigingen
in de afgelopen N minuten. Standaard: 240.

--geen-bevestiging
Schakel het bevestigingslogboek uit dat normaal wordt weergegeven op de pagina 'Alles niet groen'.

--cricitcallog[=Kritische logkolom]
Dit genereert een op tekst gebaseerd logboek van wat er wordt weergegeven op de critical.html-statuspagina,
en verzendt een statusbericht voor de Xymon-server zelf, waarin de kleur van de
Kritieke statuspagina. Hiermee kunt u bijhouden wanneer er problemen zijn opgetreden op de
kritieke statuspagina. Het logbestand wordt opgeslagen in $XYMONSERVERLOGS/criticalstatus.log

--loadhostsvanxymond
In plaats van het bestand hosts.cfg te lezen, laadt xymongen het bestand hosts.cfg
configuratie van de xymond-daemon. Dit elimineert de noodzaak om de
hosts.cfg, en als je xymond en xymongen op verschillende hosts hebt draaien, ook
elimineert de noodzaak om het bestand hosts.cfg tussen systemen te kopiëren. Merk op dat de
De optie "dispinclude" in hosts.cfg wordt genegeerd wanneer deze optie is ingeschakeld.

PAGINA LAYOUT OPTIES

Deze opties beïnvloeden hoe de door xymongen gegenereerde webpagina's in de browser verschijnen.

--pagina's-laatste
Plaats pagina- en subpaginalinks na hosts.

--pagina's eerst
Plaats pagina- en subpaginalinks vóór hosts (standaard).

Deze twee opties bepalen of een pagina met links naar subpagina's en hosts de
hosts of de subpagina's eerst.

--subpaginakolommen=N
Bepaalt het aantal kolommen dat wordt gebruikt voor koppelingen naar pagina's en subpagina's. De standaard
isN=1.

--maxrijen=N
Kolomkoppen op een pagina worden standaard alleen aan het begin van een pagina weergegeven.
subpagina of groep hosts. Deze optie zorgt ervoor dat de kolomkoppen zich herhalen
elke N getoonde hosts.

--toonlegegroepen

--no-showlegegroepen
Wanneer groepen hosts zijn gemaakt, geeft u de tabel- en hostnamen weer, zelfs als die er zijn
er zijn geen tests aanwezig voor een van de hosts in kwestie. Gebruik --no-showemptygroups om
verbergen. (Standaard: ja)

--paginatitel-links
Normaal gesproken fungeren alleen de gekleurde "stippen" naast een pagina of subpagina als links naar de
pagina zelf. Met deze optie linkt de paginatitel ook naar de pagina.

--paginatekst-koppen
Gebruik de beschrijvende tekst uit de tags 'pagina' of 'subpagina' als kop voor de
pagina, in plaats van de 'Pagina's die lokaal worden gehost' of een andere standaardkop.

--geen-onderstrepen-koppen
Normaal gesproken worden paginakoppen onderstreept met behulp van een HTML-tag "horizontale liniaal". Dit
optie schakelt het onderstrepen van koppen uit.

--recentgifs[=MINUTES]
Gebruik afbeeldingen met de naam COLOR-recent.gif voor tests waarbij de teststatus is gewijzigd
in de afgelopen 24 uur. Deze GIF-bestanden moeten worden geïnstalleerd in de
map $XYMONHOME/www/gifs/. Standaard is de drempelwaarde ingesteld op 24 uur - als
Als u het anders wilt, kunt u ook de tijdslimiet opgeven. Bijv
"--recentgifs=3h" toont de recente GIF's slechts 3 uur na een statuswijziging.

--sorteer-alleen-items
In een normale "alleen-groep"-richtlijn kunt u de volgorde opgeven waarin de tests worden uitgevoerd
worden weergegeven, van links naar rechts. Als u er de voorkeur aan geeft dat de tests worden vermeld in
alfabetische volgorde, gebruik deze optie - de pagina genereert dan "alleen voor groepen"
groepen alsof het normale groepen genereert en de tests alfabetisch sorteert.

--dialupskin=URL
Als u visueel wilt laten zien dat een test een inbeltest is, kunt u een alternatief gebruiken
set iconen voor de groen/rood/geel>/etc. afbeeldingen door deze optie op te geven. De
De hier opgegeven URL-parameter overschrijft de normale instelling van XYMONSKIN
omgevingsvariabele, maar alleen voor inbeltests.

--reverseskin=URL
Hetzelfde als "--dialupskin", maar voor omgekeerde tests (tests met '!' ervoor).

--tooltips=[altijd,nooit,hoofd]
Bepaalt welke pagina's tooltips gebruiken om de beschrijving van de host weer te geven (uit het
COMMENTAAR vermelding in de gastheren.cfg(5) bestand). Indien ingesteld op altijd, tooltips worden op iedereen gebruikt
Pagina's. Indien ingesteld op nooit, tooltips worden nooit gebruikt. Indien ingesteld op hoofd-Er worden tooltips gebruikt
op de hoofdpagina's, maar niet op de pagina's 'Alle niet-groene' of 'Kritische systemen'.

COLUMN SELECTIE OPTIES

Deze opties beïnvloeden welke kolommen (tests) worden opgenomen in de webpagina's die worden gegenereerd door
xymongen.

--ignorecolumns=test[,test]
De opgegeven kolommen worden door xymongen volledig genegeerd bij het genereren van webpagina's.
Kan worden gebruikt om rapporten te genereren waarbij u enkele van de meer luidruchtige tests elimineert,
zoals "berichten".

--kritieke-rood-alleen
Op de pagina Kritiek worden alleen rode statuskolommen opgenomen. Standaard is de
De kritieke pagina bevat hosts met de rode, gele en duidelijke status.

--nongreen-colors=KLEUR[,KLEUR]
Definieert welke kleuren ervoor zorgen dat een test verschijnt op de statuspagina 'Allemaal niet groen'.
KLEUR is rood, geel of paars. De standaardinstelling is om ze alle drie op te nemen.

--nongreen-ignorecolumns=test[,test]
Hetzelfde als de --ignorekolommen, maar is alleen van toepassing op hosts op de pagina "Alle niet-groen".

--niet-groen-paars negeren
Verouderd, gebruik in plaats daarvan "--nongreen-colors".

--nongreen-ignoredialups
Negeer alle inbelhosts op de pagina 'Alle niet-groen', inclusief het gebeurtenislogboek.

--geen pagina's
Genereer niet de normale pagina's (normaal gesproken gebruikt om alleen de niet-groene pagina's te genereren).
pagina).

--geen-niet-groen
Genereer niet de pagina 'Allemaal niet-groen'.

--includecolumns=test[,test]
Neem deze kolommen altijd op op de pagina 'Alle niet-groene'. Bevat bepaalde kolommen
op de nongreen.html-pagina, ongeacht de kleur. Normaal gesproken laat nongreen.html een
testkolom, als alle tests groen zijn. Dit kunt u bijvoorbeeld gebruiken om altijd een link naar te hebben
de trendskolom (met de RRD-grafieken) van uw nongreen.html-pagina.

--eventignore=test[,test]
Negeer deze tests in het gebeurtenislogboekscherm 'Alles niet groen'.

STATUS VOORTPLANTING OPTIES

Deze opties onderdrukken de normale verspreiding van een status naar boven in de paginahiërarchie.
Zo kunt u een toets hebben met status geel of rood, maar toch de hele pagina groen hebben.
Het is handig voor tests die geen alarm hoeven te veroorzaken, maar waarvan u toch wel het alarm wilt weten
huidige status. Deze opties stellen algemene standaardwaarden in voor alle hosts; U kunt de NOPROPRED gebruiken
en NOPROPYELLOW-tags in de gastheren.cfg(5) bestand om vergelijkbare limieten toe te passen op een per-host
basis.

--nopropgeel=test[,test] of --noprop=test[,test]
Schakel opwaartse statusdoorgifte uit wanneer GEEL. De optie "--noprop" is verouderd
en mag niet worden gebruikt.

--noproppurple=test[,test]
Schakel opwaartse statusdoorgifte uit wanneer PAARS.

--nopropred=test[,test]
Schakel opwaartse statusvoortplanting uit wanneer ROOD of GEEL.

--nopropack=test[,test]
Schakel opwaartse statusdoorgifte uit wanneer de status is bevestigd. Als je wil
Om te voorkomen dat alle goedgekeurde tests worden doorgegeven, gebruikt u "--nopropack=*".

PAARS STATUS OPTIES

Paarse statussen treden op wanneer het melden van een teststatus stopt. Een teststatus is geldig voor a
beperkte hoeveelheid tijd - normaal gesproken 30 minuten - en na deze tijd wordt de test uitgevoerd
Purper.

--purplelog=BESTANDSNAAM
Genereer een logbestand van alle paarse statusberichten.

WISSEL PAGINASET OPTIES

--pageset=PAGINASETNAAM
Bouw webpagina's voor een alternatieve paginaset dan de standaardpaginaset. Zie de sectie PAGINASETS
hieronder.

--sjabloon=SJABLOON
Gebruik een alternatieve sjabloon voor kop- en voettekstbestanden. Meestal samen gebruikt
de optie "--paginaset"; zie het gedeelte PAGINASETS hieronder.

WISSEL OUTPUT FORMATS

--wml[=test1,test2,...]
Deze optie zorgt ervoor dat xymongen een set WML-kaartbestanden genereert die kunnen worden gebruikt
toegankelijk via een WAP-apparaat (mobiele telefoon, PDA enz.) De gegenereerde bestanden bevatten de
hosts die een RODE of GELE status hebben op de gespecificeerde tests. Deze optie kan definiëren
de standaardtests die moeten worden opgenomen - de standaardwaarden kunnen worden overschreven of aangepast met behulp van de
"WML:"- of "NK:"-tags in de gastheren.cfg(5) bestand. Als er geen tests zijn gespecificeerd, alle tests
zal erbij in zitten.

--nstab=BESTANDSNAAM
Genereer een HTML-bestand dat geschikt is voor een item in de zijbalk van Netscape 6/Mozilla. Naar eigenlijk
Om uw gebruikers in staat te stellen een dergelijk zijbalkitem te verkrijgen, heeft u deze Javascript-code nodig
een webpagina (u kunt deze bijvoorbeeld opnemen in het bestand $XYMONHOME/web/stdnormal_header):


<!--
functie addNetscapePanel() {
if ((typevanvenster.zijbalk == "object") &&
(typeof window.sidebar.addPanel == "functie"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html","");
anders
alert("Zijbalk alleen voor Mozilla of Netscape 6+");
}
// ->


en dan kun je een link 'Voeg dit toe aan zijbalk' toevoegen, waarbij je dit als sjabloon gebruikt:

Toevoegen aan zijbalk

of als u liever de standaard Netscape "Tabblad toevoegen"-knop heeft, kunt u dat ook doen
Met


<IMG SRC="/gifs/add-button.gif" HOOGTE=45 BREEDTE=100
ALT="[Zijbalk toevoegen]" STYLE="border:0">


De "add-button.gif" is verkrijgbaar bij Netscape op
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Als FILENAME niet met een schuine streep begint, wordt het Netscape-zijbalkbestand in de
map $XYMONHOME/www/.

--nslimit=KLEUR
De minimale kleur die moet worden opgenomen in de Netscape Sidebar - standaard is "rood", wat betekent
alleen kritische waarschuwingen zijn opgenomen. Als u ook waarschuwingen wilt opnemen, gebruikt u
"--nslimit=geel".

--rss Genereer een RSS/RDF-inhoudsstroom van uw Xymon-waarschuwingen. Dit uitvoerformaat
kan dynamisch worden ingebed in andere webpagina's, net zoals vaak de live nieuwsfeeds
gezien op websites. Er worden twee RSS-bestanden gegenereerd, één weerspiegelt de "Alle niet-
groene" pagina, de andere weerspiegelt de "Critical" pagina. Ze staan ​​in de
respectievelijk de bestanden "nongreen.rss" en "critical.rss". Daarnaast een RSS-bestand
wordt gegenereerd voor elke pagina en/of subpagina met een lijst van de hosts die daarop aanwezig zijn
pagina of subpagina.
De FILENAME-parameter die voorheen was toegestaan ​​voor de --rss-optie, is nu verouderd.
Voor meer informatie over RSS/RDF-inhoudsfeeds, zie
http://www.syndic8.com/.

--rssextension=.EXTENSIE
Stelt de bestandsnaamextensie in die wordt gebruikt voor de RSS-bestanden die door xymongen worden gegenereerd. Door
standaard wordt de extensie ".rss" gebruikt. Merk op dat u de "punt" moet specificeren.

--rssversie={0.91|0.92|1.0|2.0}
Het gewenste uitvoerformaat van de RSS/RDF-feed. Versie 0.91 lijkt het meest te zijn
veelgebruikte indeling en is de standaard als deze optie wordt weggelaten.

--rsslimit=KLEUR
De minimale kleur die in de RSS-feed moet worden opgenomen. De standaardkleur is 'rood', wat alleen betekent
kritische waarschuwingen zijn inbegrepen. Als u ook waarschuwingen wilt opnemen, gebruikt u
"--rsslimit=geel".

OPTIES GEBRUIKT BY CGI VOORKANTEN

--reportopts=START:END:DYNAMIC:STIJL
Roep xymongen aan in de modus voor het genereren van rapporten. Normaal gesproken wordt dit gebruikt door de
rapport.cgi(1) CGI-script, maar kan ook direct worden gebruikt bij het vooraf genereren
rapporten. De START-parameter is de starttijd voor het rapport in Unix time_t
formaat (seconden sinds 1 januari 1970 00:00 UTC); END is de eindtijd van het rapport;
DYNAMISCH is 0 voor een kant-en-klaar rapport en 1 voor een dynamisch (online) rapport; STIJL is
"crit" om alleen kritieke (rode) gebeurtenissen op te nemen, "nongr" om alle niet-groene gebeurtenissen op te nemen
gebeurtenissen en 'alles' om alle gebeurtenissen op te nemen.

--csv=BESTANDSNAAM
In combinatie met --reportopts zorgt dit ervoor dat xymongen een beschikbaarheid genereert
rapport in de vorm van een bestand met door komma's gescheiden waarden (CSV). Dit formaat is gebruikelijk
gebruikt voor het importeren in spreadsheets voor verdere verwerking.
Het CSV-bestand bevat Unix-tijdstempels. Om deze weer te geven als voor mensen leesbare tijden in
Excel, de formule =C2/86400+DATUMWAARDE(1-jan-1970) (als je de Unix-tijdstempel hebt
in cel C2) kan worden gebruikt. De resultaatcel moet worden opgemaakt als een datum/tijd
veld. Houd er rekening mee dat de tijdstempels in UTC zijn, dus u moet mogelijk ook lokaal omgaan
tijdzone- en zomertijdproblemen zelf oplossen.

--csvdelim=DELIMITER
Standaard wordt een komma gebruikt om velden in de CSV-uitvoer af te bakenen. Sommige niet-Engels
spreadsheets gebruiken een ander scheidingsteken, meestal een puntkomma. Om een ​​CSV te genereren
bestand met het juiste scheidingsteken, kunt u deze optie gebruiken om het gebruikte teken in te stellen
als scheidingsteken. Bijvoorbeeld "--csvdelim=;" - merk op dat dit normaal gesproken dubbel moet zijn
aanhalingstekens, om te voorkomen dat de Unix-shell het scheidingsteken interpreteert als een
scheidingsteken op de opdrachtregel.

--momentopname=TIJD
Genereer een momentopname van de Xymon-pagina's, zoals ze om TIME verschenen. TIJD wordt gegeven als
seconden sinds 1 januari 1970 00:00 UTC. Normaal gesproken gebruikt via de momentopname.cgi(1) CGI
scripts.

DEBUGEN OPTIES

--debuggen
Zorgt ervoor dat xymongen grote hoeveelheden foutopsporingsuitvoer naar stdout dumpt, als dat het geval was
gecompileerd met de -DDEBUG ingeschakeld. Als u een probleem met xymongen meldt, alstublieft
probeer het probleem te reproduceren en geef hiermee de uitvoer van het uitvoeren van xymongen
optie.

--tijdstip
Dump informatie over de tijd die verschillende delen van Xymongen besteden aan het uitwerken. Dit
Het is handig om te zien welk deel van de verwerking verantwoordelijk is voor de looptijd van
xymongen.
Opmerking: deze informatie wordt ook verstrekt in de uitvoer die naar het Xymon-display wordt verzonden
wanneer u de optie "--rapport" gebruikt.

GEBOUW WISSEL PAGINASETS

Met versie 1.4 van xymongen komt de mogelijkheid om meerdere sets pagina's te genereren
dezelfde gegevens.
Stel dat twee groepen mensen naar de Xymon-webpagina's kijken. Groep A wil dat
laat de hosts groeperen op de client waartoe ze behoren. Dit is hoe je Xymon hebt ingesteld -
de standaardpaginaset. Nu wil groep B de hosts gegroepeerd hebben op besturingssysteem -
laten we het de "os"-verzameling noemen. Vervolgens voegt u de pagina-indeling als volgt toe aan hosts.cfg:

ospage win Microsoft Windows
ossubpagina win-nt4 MS Windows NT 4
osgroup NT4 Bestandsservers
osgroup NT4 mailservers
ossubpagina win-xp MS Windows XP
ospage unix Unix
ossubpagina unix-sun Solaris
ossubpagina unix-linux Linux

Dit definieert een reeks pagina's met één pagina op het hoogste niveau (de xymon.html-pagina), twee pagina's
gelinkt vanuit xymon.html (win.html en unix.html), en vanaf bijvoorbeeld de win.html-pagina zijn er
subpagina's win-nt4.html en win-xp.html
De syntaxis is identiek aan de normale instructies "page" en "subpage" in hosts.cfg, maar
de richtlijn wordt voorafgegaan door de naam van de paginaset. Plaats geen hosts tussen de pagina
en subpagina-richtlijnen - voeg gewoon alle richtlijnen toe bovenaan het bestand hosts.cfg.
Hoe voeg je dan hosts toe aan de pagina's? Eenvoudig: plaats gewoon een tag "OS:win-xp" op de host
definitie lijn. Het "OS" moet hetzelfde zijn als het voorvoegsel dat wordt gebruikt voor de namen van de paginasets, maar dan in
hoofdletter. De "win-xp" moet overeenkomen met een van de pagina's of subpagina's die hierin zijn gedefinieerd
paginaset. Bijv

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/

Als u wilt dat de host verschijnt binnen een groep die op die pagina is gedefinieerd, moet u de
groeperen op nummer, beginnend bij 1. Om bijvoorbeeld een host in de groep "NT4 Mail-servers" te plaatsen
In het bovenstaande voorbeeld gebruikt u "OS:win-nt4,2" (de tweede groep op de "win-nt4"-pagina).
Als je wilt dat de host op de voorpagina verschijnt in plaats van op een subpagina, gebruik dan "OS:*" .

Dit alles definieert slechts de lay-out van de nieuwe paginaset. Om het te genereren, moet je rennen
xymongen één keer voor elke paginaset die u definieert - dwz maak een extensiescript zoals dit:

#!/ Bin / sh

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

Sla dit op in $XYMONHOME/ext/os-display.sh, en stel dit in om te draaien als een Xymon-extensie;
dit betekent dat er een extra sectie aan taken.cfg moet worden toegevoegd om deze uit te voeren.

Hierdoor worden de pagina's gegenereerd. Er worden hier enkele belangrijke opties gebruikt:
* XYMONWEB="/xymon/os" omgevingsvariabele, en de
"$XYMONHOME/www/os/" optie werkt samen en plaatst de
nieuwe paginaset HTML-bestanden in een submap buiten de normale
Xymon-webroot. Als u normaal gesproken de Xymon-pagina's bezoekt als
"http://xymon.acme.com/xymon/", dan krijgt u toegang
de nieuwe paginaset als "http://xymon.acme.com/xymon/os/"
NB: De map die wordt opgegeven als XYMONWEB moet een symbolisch bestand bevatten
link naar de map $XYMONHOME/www/html/, of links naar
individuele statusberichten werken niet. Soortgelijke koppelingen
moet worden gemaakt voor de gifs/, help/ en notities/
directories.
* "--pageset=os" vertelt xymongen om de webpagina's te structureren
met behulp van de "os"-indeling, in plaats van de standaardindeling.
* "--template=os" vertelt xymongen om een ​​andere set te gebruiken
kop- en voettekstsjablonen. Normaal gebruikt xymongen de
standaardsjabloon in $XYMONHOME/web/stdnormal_header en
.../stdnormal_footer - met deze optie wordt in plaats daarvan gebruikt
de bestanden "os_header" en "os_footer" uit de
map $XYMONHOME/web/. Hierdoor kun je maatwerk leveren
kop- en voetteksten voor elke paginaset. Als je maar wilt
Als u de normale sjabloon wilt gebruiken, kunt u deze optie weglaten.

GEBRUIK MAKEND VAN XYMONGEN VOOR VERSLAGEN

xymongen-rapportage wordt geïmplementeerd via drop-in-vervangingen voor de standaard Xymon
rapportagescripts (report.sh en reportlog.sh) geïnstalleerd in uw webservers cgi-bin
directory.

Deze twee shell-scripts zijn vervangen door twee zeer kleine shell-scripts, die slechts
stel de Xymon-omgevingsvariabelen in en roep de rapport.cgi(1) or reportlog.cgi(1)
scripts in $XYMONHOME/bin/

U kunt xymongen-opdrachtregelopties gebruiken bij het genereren van rapporten, bijvoorbeeld om bepaalde rapporten uit te sluiten
soorten tests (bijvoorbeeld "--ignorecolumns=msgs") uit de rapporten, om de naam van de
trends- en infokolommen die niet in het rapport mogen voorkomen, of om het rapport op te maken
anders (bijvoorbeeld "--subpagecolumns=2"). Als u wilt dat bepaalde opties worden gebruikt wanneer a
rapport wordt gegenereerd vanuit de webinterface, plaats deze opties in uw
$XYMONHOME/etc/xymonserver.cfg in de omgevingsvariabele XYMONGENREPOPTS.

De door xymongen gegenereerde rapportbestanden worden opgeslagen in individuele mappen (één per
report) onder de map $XYMONHOME/www/rep/. Deze moeten automatisch worden opgeschoond
- als er nieuwe rapporten worden gegenereerd, worden de oude verwijderd.

Probeer na de installatie een rapport te genereren. U zult waarschijnlijk zien dat de links in de
linkerbovenhoek (naar ack.html, nongreen.html etc.) werkt niet meer. Om deze op te lossen, verander
uw $XYMONHOME/web/repnormal_header-bestand, zodat deze links niet verwijzen naar "&XYMONWEB" maar
naar het normale URL-voorvoegsel voor uw Xymon-pagina's.

SLA RAPPORTAGE

xymongen-rapportage maakt het genereren van echte SLA (Service Level Agreement) mogelijk
rapportages, ook voor serviceperiodes die niet 24x7 zijn. Dit wordt mogelijk gemaakt door het definiëren van a
"REPORTTIME:timespec"-tag voor de hosts om de serviceperiode te definiëren, en optioneel een
"WARNPCT:level"-tag om de overeengekomen beschikbaarheid te definiëren.

Opmerking: Zie gastheren.cfg(5) voor de exacte syntaxis van deze opties.

"REPORTTIME:timespec" specificeert het tijdstip waarop de service naar verwachting actief zal zijn
rennen. Standaard is dit 24 uur per dag, alle dagen van de week. Als uw SLA alleen dekking biedt
Ma-Vr 7 - 8 uur, u definieert dit als "REPORTTIME=W:0700:2000", en de rapportgenerator
berekent dan zowel de normale 24x7 beschikbaarheid als een "SLA-beschikbaarheid".
houdt alleen rekening met de status van de host tijdens de SLA-periode.

De parameter DOWNTIME:timespec heeft invloed op de berekening van de SLA-beschikbaarheid. Als er een storing is
optreedt gedurende de tijd die is gedefinieerd als mogelijke "DOWNTIME", dan wordt de storing gemeld met een
status "blauw". (Dezelfde kleur wordt gebruikt als u de Xymon "uitschakelt" en vervolgens host
functie "uitschakelen"). Het tijdstip waarop de teststatus ‘blauw’ is, is niet opgenomen in de SLA
berekening, noch in de hoeveelheid tijd waarin de gastheer als down wordt beschouwd, noch in de
totale hoeveelheid tijd die het rapport bestrijkt. Dus de "blauwe" tijd wordt effectief genegeerd door de
SLA-beschikbaarheidsberekening, zodat u downtime kunt plannen zonder dat dit gevolgen heeft voor de beschikbaarheid
gerapporteerde SLA-beschikbaarheid.

Voorbeeld: een host heeft "DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200" omdat deze opnieuw is opgestart
elke dag tussen 7 en 7.30 uur, maar de dienst moet beschikbaar zijn van 6 tot 10 uur. Voor
op de dag van het rapport was deze gedaald van 7 uur naar 10 uur (de geplande herstart), maar ook
van 9 uur tot 53 uur. Dus de evenementen voor de dag zijn:

0700: groen gedurende 10 minuten (600 seconden)
0710: blauw gedurende 5 minuten (300 seconden)
0715: groen gedurende 14 uur 38 minuten (52680 seconden)
2153: rood gedurende 22 minuten (1320 seconden)
2215: groen

De dienst is beschikbaar voor 600+52680 = 53280 seconden. Het is 420 seconden lang omlaag (rood).
(de tijd van 21:53 tot 22:00 uur waarop de SLA-periode eindigt). De totale tijd inbegrepen in de
rapport is 15 uur (7 - 10 uur) behalve de 5 minuten blauw = 53700 seconden. De SLA dus
beschikbaarheid is 53280/53700 = 99,22%

De tag "WARNPCT:level" wordt ondersteund in het bestand hosts.cfg om de beschikbaarheid in te stellen
drempelwaarde per host. Deze drempel bepaalt of een test wordt gerapporteerd als
groen, geel of rood in de rapporten. Met de optie via kan voor alle hosts een standaardwaarde worden ingesteld
de omgevingsvariabele XYMONREPWARN, maar overschreven door deze tag. Het niveau wordt gegeven als
een percentage, bijvoorbeeld "WARNPCT:98.5"

VOORGEGENEREERD VERSLAGEN

Normaal gesproken produceert xymongen rapporten die linken naar dynamisch gegenereerde webpagina's met de
gedetailleerde status van een test (via het reportlog.sh CGI-script).

Het is mogelijk om xymongen een rapport te laten maken zonder deze dynamische links, dus de
rapport kan naar een andere server worden geëxporteerd. Het kan ook nuttig zijn om de
rapporten, om de belasting te verlagen door meerdere gebruikers dezelfde rapporten te laten genereren.

Om dit te doen, moet u xymongen uitvoeren met de optie "--reportopts" om de tijd te selecteren
interval dat het rapport bestrijkt, de rapportagestijl (kritiek, niet-groen of alle gebeurtenissen),
en om te verzoeken dat er geen dynamische pagina's worden gegenereerd.

De syntaxis is:

xymongen --reportopts=starttijd:eindtijd:nodynamic:stijl

"starttime" en "endtime" worden gespecificeerd als Unix time_t-waarden, dwz seconden sinds 1 januari
1970 00:00 GMT. Gelukkig kan dit eenvoudig worden berekend met het GNU-datumhulpprogramma
gebruik de uitvoeroptie "+%s". Als je het GNU-datumhulpprogramma niet hebt, pak dat dan op
van www.gnu.org; of u kunt het hulpprogramma "etime" voor hetzelfde doel gebruiken, namelijk
beschikbaar in het archief op www.deadcat.net.

"nodynamic" is 0 (voor dynamische pagina's, de standaard) of 1 (voor geen dynamische pagina's, dwz vooraf
gegenereerd, pagina's).

"style" is ofwel "crit" (inclusief kritische gebeurtenissen, dwz alleen rode gebeurtenissen), "nongr" (inclusief alle
niet-groene evenementen), of "alle" (inclusief alle evenementen).

Andere xymongen-opties kunnen worden gebruikt, bijvoorbeeld "--ignorecolumns" als u bepaalde kolommen wilt uitsluiten
testen uit het rapport.

Normaal gesproken moet u ook de XYMONWEB-omgevingsvariabele opgeven (deze moet overeenkomen
de basis-URL waar het rapport toegankelijk wordt gemaakt) en een uitvoermap
waar de rapportbestanden worden opgeslagen. Als u XYMONWEB specificeert, zou u dat waarschijnlijk ook moeten doen
definieer de omgevingsvariabelen XYMONHELPSKIN en XYMONNOTESSKIN. Deze moeten verwijzen naar
de URL waar uw Xymon-help- en notitiebestanden zich bevinden; als ze niet zijn gedefinieerd, wordt de
koppelingen naar help- en notitiebestanden verwijzen naar de rapportmap en zullen dat waarschijnlijk ook doen
werkt niet.

Een typische aanroep van xymongen voor een statisch rapport zou dus zijn:

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

De instelling "XYMONWEB" betekent dat het rapport beschikbaar is met de URL van
"http://www.server.com/reports/xymon/daily/2003/06/22". Het rapport bevat interne
links die deze URL gebruiken, zodat deze niet eenvoudig naar een andere locatie kunnen worden verplaatst.

De laatste parameter is de corresponderende fysieke map op uw webserver die overeenkomt met de
XYMONWEB-URL. U kunt de rapportbestanden uiteraard overal maken waar u maar wilt, misschien wel op
een andere machine - en verplaats ze later naar de webserver.

Merk op hoe de gegevens(1) hulpprogramma wordt gebruikt om de start- en eindtijdparameters te berekenen.

MILIEU VARIABELEN

BORDFILTER
Filter dat wordt gebruikt om te selecteren welke hosts/tests op de webpagina's zijn opgenomen, door te filteren
de gegevens opgehaald uit xymond via de opdracht xymondboard. Zien xymon(1) voor details
op de filtersyntaxis. Standaard wordt er niet gefilterd.

Gebruik xymongen online met behulp van onworks.net-services