xymongen - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

xymongen - Xymon Webseiten-Generator

ZUSAMMENFASSUNG

xymongen -?
xymongen --help
xymongen --Version
xymongen [Optionen] [Ausgabe Verzeichnis]
(Eine Beschreibung der verfügbaren Befehlszeilenoptionen finden Sie im Abschnitt OPTIONEN).

BESCHREIBUNG

xymongen generiert die Übersichtsseiten für den Xymon-Monitor. Das sind die Webseiten
die den Gesamtstatus Ihrer Hosts anzeigen, nicht die detaillierten Statusseiten für jeden Test.

Hinweis: Die Daten für die Webseiten werden aus dem xymond(8) daemon und xymongen verwendet
die Werte der Umgebungsvariablen XYMSRV / XYMSERVERS, um das Netzwerk zu bestimmen
Adresse, unter der xymond erreichbar ist. Wenn Sie mehr als einen Server in aufgelistet haben
XYMSERVER, stellen Sie sicher, dass der erste der lokale Xymon-Server ist - dieser ist der
xymongen fragt nach Daten.

OPTIONAL

xymongen bietet eine Vielzahl von Befehlszeilenoptionen. Die Optionen können zum Ändern verwendet werden
das Verhalten von xymongen und die davon generierten Webseiten beeinflussen.

ALLGEMEIN OPTIONAL

--hilfe oder -?
Stellen Sie eine Zusammenfassung der verfügbaren Befehlszeilenoptionen bereit.

--Version
Druckt die Versionsnummer von xymongen

--docurl=URL
Diese Option ist veraltet, verwenden Sie die HOSTDOCURL-Einstellung in xymonserver.cfg(5)
stattdessen.

--doccgi=URL
Diese Option ist veraltet, verwenden Sie die HOSTDOCURL-Einstellung in xymonserver.cfg(5)
stattdessen.

--doc-Fenster
Veranlasst, dass Links zur Dokumentation für Hosts und Dienste in einem neuen Fenster geöffnet werden. Die
Standardmäßig wird die Dokumentation im selben Browserfenster wie der Xymon-Status angezeigt.

--htmlextension=.ERWEITERUNG
Legt die Dateinamenerweiterung fest, die für die von xymongen generierten Webseiten verwendet wird. Von
Standardmäßig wird die Erweiterung ".html" verwendet. Beachten Sie, dass Sie den "Punkt" angeben müssen.

--report[=SPALTENNAME]
Mit dieser Option sendet xymongen eine Statusnachricht mit der Angabe, wie viele
Hosts verarbeitet wurden, wie viele Seiten generiert wurden, aufgetretene Fehler
während des Laufs und einige Timing-Statistiken. Der Standardspaltenname ist "xymongen".

--htaccess[=htaccess-Dateiname]
Erstellen Sie .htaccess-Dateien, wenn neue Webseitenverzeichnisse erstellt werden. Der Inhalt von
die .htaccess-Dateien werden durch die Umgebungsvariable XYMONHTACCESS bestimmt (für
das Verzeichnis der obersten Ebene mit xymon.html und nongreen.html); bis zum
XYMONPAGEHTACCESS-Variable (für die Verzeichnisse auf Seitenebene); und durch die
XYMONSUBPAGEHTACCESS-Variable für Verzeichnisse auf untergeordneter und untergeordneter Ebene. Die
Dateiname der .htaccess-Dateien standardmäßig ".htaccess", wenn kein Dateiname mit angegeben wird
diese Option. Die Variable XYMONHTACCESS wird wörtlich in die oberste Ebene kopiert
.htaccess-Datei. Die Variable XYMONPAGEHTACCESS kann ein "%s" enthalten, wobei der Name
der Seite eingefügt wird. Die Variable XYMONSUBPAGEHTACCESS kann zwei "%s" enthalten
Instanzen: Die erste wird durch den Seitennamen ersetzt, die zweite durch die
Unterseitenname.

--max-eventcount=N
Beschränken Sie das Ereignisprotokoll auf der Seite "Alle nicht-grün" auf nur N Ereignisse. Standard: 100.

--max-eventtime=N
Beschränken Sie das Ereignisprotokoll auf der Seite "Alle nicht-grün" auf Ereignisse, die innerhalb der
letzten N Minuten. Standard: 240.

--no-eventlog
Deaktivieren Sie das Ereignisprotokoll, das normalerweise auf der Seite "Alle nicht grün" angezeigt wird

--max-account=N
Beschränken Sie das Quittierungsprotokoll auf der Seite "Alle nicht grün" auf nur N Ereignisse. Standard:
25

--max-acktime=N
Beschränken Sie das Bestätigungsprotokoll auf der Seite "Alle nicht-grün" auf passierten Bestätigungen
innerhalb der letzten N Minuten. Standard: 240.

--no-acklog
Deaktivieren Sie das Bestätigungsprotokoll, das normalerweise auf der Seite "Alle nicht grün" angezeigt wird.

--cricitcallog[=Kritische Protokollspalte]
Dadurch wird ein textbasiertes Protokoll erstellt, was auf der Statusseite Critical.html angezeigt wird.
und sendet eine Statusmeldung für den Xymon-Server selbst, die die Farbe des
Kritische Statusseite. Auf diese Weise können Sie nachverfolgen, wann Probleme auf dem
Seite mit kritischem Status. Die Logdatei wird in $XYMONSERVERLOGS/criticalstatus.log gespeichert

--loadhostsfromxymond
Anstatt die Datei hosts.cfg zu lesen, lädt xymongen die Datei hosts.cfg
Konfiguration vom xymond-Daemon. Dadurch entfällt das Lesen der
hosts.cfg, und wenn xymond und xymongen auf unterschiedlichen Hosts laufen, auch
macht das Kopieren der Datei hosts.cfg zwischen Systemen überflüssig. Notiere dass der
Die Option "dispinclude" in hosts.cfg wird ignoriert, wenn diese Option aktiviert ist.

SEITE LAYOUT OPTIONAL

Diese Optionen wirken sich darauf aus, wie die von xymongen generierten Webseiten im Browser angezeigt werden.

--Seiten-letzte
Setzen Sie Seiten- und Unterseiten-Links nach Hosts.

--pages-first
Setzen Sie Seiten- und Unterseiten-Links vor Hosts (Standard).

Diese beiden Optionen entscheiden, ob eine Seite mit Links zu Unterseiten und Hosts die
hosts oder die Unterseiten zuerst.

--subpagecolumns=N
Bestimmt die Anzahl der Spalten, die für Links zu Seiten und Unterseiten verwendet werden. Der Standard
ist N=1.

--maxrows=N
Spaltenüberschriften auf einer Seite werden standardmäßig nur am Anfang einer Seite angezeigt,
Unterseite oder Gruppe von Hosts. Diese Option bewirkt, dass sich die Spaltenüberschriften für . wiederholen
alle N Hosts angezeigt.

--showemptygroups

--no-showemptygroups
Wenn Gruppen zu Hosts erstellt werden, zeigen Sie die Tabelle und die Hostnamen an, auch wenn
keine Tests für einen der fraglichen Hosts vorhanden. Verwenden Sie --no-showemptygroups, um
verstecken. (Standard: ja)

--Seitentitel-Links
Normalerweise fungieren nur die farbigen "Punkte" neben einer Seite oder Unterseite als Links zu den
Seite selbst. Bei dieser Option wird auch der Seitentitel auf die Seite verweisen.

--Seitentext-Überschriften
Verwenden Sie den Beschreibungstext aus den Tags "page" oder "subpage" als Überschrift für die
Seite statt der "Lokal gehosteten Seiten" oder einer anderen Standardüberschrift.

--no-underline-Überschriften
Normalerweise werden Seitenüberschriften mit einem HTML-Tag "horizontales Lineal" unterstrichen. Dies
Option deaktiviert das Unterstreichen von Überschriften.

--recentgifs[=MINUTEN]
Verwenden Sie Bilder mit dem Namen COLOR-recent.gif für Tests, bei denen sich der Teststatus geändert hat
innerhalb der letzten 24 Stunden. Diese GIF-Dateien müssen im installiert werden
$XYMONHOME/www/gifs/-Verzeichnis. Standardmäßig ist der Schwellenwert auf 24 Stunden eingestellt - wenn
Willst du es anders, kannst du das Zeitlimit auch angeben. Z.B
"--recentgifs=3h" zeigt nach einer Statusänderung nur 3 Stunden lang die letzten GIFs an.

--sort-group-only-items
In einer normalen "Nur-Gruppe"-Direktive können Sie die Reihenfolge angeben, in der die Tests
werden von links nach rechts angezeigt. Wenn Sie es vorziehen, die in aufgeführten Tests zu haben
alphabetischer Reihenfolge, verwenden Sie diese Option - die Seite generiert dann "nur Gruppen"
Gruppen wie es normale Gruppen generiert und die Tests alphabetisch sortieren.

--dialupskin=URL
Wenn Sie visuell zeigen möchten, dass es sich bei einem Test um einen Einwahltest handelt, können Sie einen alternativen
Satz von Symbolen für das Grün/Rot/Gelb>/etc. Bilder durch Angabe dieser Option. Die
Der hier angegebene URL-Parameter überschreibt die normale Einstellung von XYMONSKIN
Umgebungsvariable, aber nur für DFÜ-Tests.

--reverseskin=URL
Wie "--dialupskin", aber für umgekehrte Tests (Tests mit '!' davor).

--tooltips=[immer,nie,main]
Legt fest, auf welchen Seiten Tooltips verwendet werden, um die Beschreibung des Hosts anzuzeigen (aus dem
KOMMENTAR-Eintrag im hosts.cfg(5) Datei). Wenn auf eingestellt immer, Tooltips werden für alle verwendet
Seiten. Wenn auf eingestellt hört niemals , QuickInfos werden nie verwendet. Wenn auf eingestellt Haupt-, Tooltips werden verwendet
auf den Hauptseiten, aber nicht auf den Seiten "Alle nicht-grünen" oder "kritischen Systeme".

SPALTE SELECTION OPTIONAL

Diese Optionen beeinflussen, welche Spalten (Tests) in den Webseiten enthalten sind, die von . generiert werden
xymongen.

--ignorecolumns=test[,test]
Die angegebenen Spalten werden von xymongen beim Generieren von Webseiten vollständig ignoriert.
Kann verwendet werden, um Berichte zu erstellen, in denen Sie einige der geräuschvolleren Tests eliminieren,
wie "Nachricht".

--kritische-rote-nur
Auf der Seite Kritisch werden nur rote Statusspalten angezeigt. Standardmäßig ist die
Kritische Seite enthält Hosts mit rotem, gelbem und klarem Status.

--nongreen-colors=FARBE[,FARBE]
Definiert, welche Farben dazu führen, dass ein Test auf der Statusseite "Alle nicht grün" angezeigt wird.
FARBE ist rot, gelb oder lila. Standardmäßig sind alle drei enthalten.

--nongreen-ignorecolumns=test[,test]
Identisch mit --ignorecolumns, gilt jedoch nur für Hosts auf der Seite "Alle nicht-grün".

--nongreen-ignorepurples
Veraltet, verwenden Sie stattdessen "--nongreen-colors".

--nongreen-ignorediaups
Ignorieren Sie alle DFÜ-Hosts auf der Seite "Alle nicht grün", einschließlich des Ereignisprotokolls.

--keine-seiten
Generieren Sie nicht die normalen Seiten (normalerweise verwendet, um nur die nicht-grünen zu generieren
Seite ändern).

--nein-nichtgrün
Generieren Sie nicht die Seite "Alle nicht grün".

--includecolumns=test[,test]
Diese Spalten immer auf der Seite "Alle nicht grün" einschließen Wird bestimmte Spalten enthalten
auf der Seite nongreen.html, unabhängig von ihrer Farbe. Normalerweise fällt nongreen.html ein
test-Spalte, wenn alle Tests grün sind. Dies kann zB verwendet werden, um immer einen Link zu haben zu
die Trendspalte (mit den RRD-Diagrammen) von Ihrer nongreen.html-Seite.

--eventignore=test[,test]
Ignorieren Sie diese Tests in der Ereignisprotokollanzeige "Alle nicht grün".

STATUS VERMEHRUNG OPTIONAL

Diese Optionen unterdrücken die normale Weitergabe eines Status in der Seitenhierarchie nach oben.
So können Sie einen Test mit Status gelb oder rot haben, aber trotzdem die gesamte Seite grün haben.
Es ist nützlich für Tests, die keinen Alarm auslösen müssen, bei denen Sie aber dennoch wissen möchten
aktueller Status. Diese Optionen legen globale Standardwerte für alle Hosts fest; Sie können die NOPROPRED . verwenden
und NOPROPYELLOW-Tags im hosts.cfg(5) Datei, um ähnliche Beschränkungen pro Host anzuwenden
Basis.

--nopropyellow=test[,test] oder --noprop=test[,test]
Deaktivieren Sie die Statusausbreitung nach oben, wenn GELB. Die Option "--noprop" ist veraltet
und sollte nicht verwendet werden.

--noproppurple=test[,test]
Deaktivieren Sie die Statusweitergabe nach oben, wenn PURPLE.

--nopropred=test[,test]
Deaktivieren Sie die Statusausbreitung nach oben, wenn ROT oder GELB.

--nopropack=test[,test]
Deaktivieren Sie die Statusweitergabe nach oben, wenn der Status bestätigt wurde. Falls Sie es wollen
Um die Weitergabe aller bestätigten Tests zu deaktivieren, verwenden Sie "--nopropack=*".

PURPLE STATUS OPTIONAL

Lila Status treten auf, wenn die Meldung eines Teststatus beendet wird. Ein Teststatus ist gültig für a
begrenzte Zeit - normalerweise 30 Minuten - und nach dieser Zeit wird der Test zu
lila.

--purplelog=DATEINAME
Generieren Sie eine Protokolldatei aller lila Statusmeldungen.

WECHSELN SEITENSATZ OPTIONAL

--pageset=SEITENSETNAME
Erstellen Sie Webseiten für einen anderen Seitensatz als den Standard. Siehe den Abschnitt SEITENSÄTZE
unten.

--template=VORLAGE
Verwenden Sie eine alternative Vorlage für Kopf- und Fußzeilendateien. Wird normalerweise zusammen verwendet
die Option "--pageset"; siehe den Abschnitt SEITENSET weiter unten.

WECHSELN AUSGABE FORMATEN

--wml[=test1,test2,...]
Diese Option veranlasst xymongen, einen Satz von WML-"Karten"-Dateien zu generieren, die
Zugriff über ein WAP-Gerät (Handy, PDA etc.) Die generierten Dateien enthalten die
Hosts, die bei den angegebenen Tests den Status ROT oder GELB haben. Diese Option kann definieren
die einzubeziehenden Standardtests - die Standardeinstellungen können überschrieben oder geändert werden mit dem
"WML:"- oder "NK:"-Tags im hosts.cfg(5) Datei. Wenn keine Tests angegeben sind, werden alle Tests
wird mit inbegriffen sein.

--nstab=DATEINAME
Generieren Sie eine HTML-Datei, die für einen Eintrag in der Seitenleiste von Netscape 6/Mozilla geeignet ist. Um eigentlich
Um Ihren Benutzern einen solchen Sidebar-Eintrag zu ermöglichen, benötigen Sie diesen Javascript-Code in
eine Webseite (zB können Sie sie in die Datei $XYMONHOME/web/stdnormal_header einbinden):


<!--
Funktion addNetscapePanel() {
if ((typeof window.sidebar == "Objekt") &&
(typeof window.sidebar.addPanel == "Funktion"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html","");
sonst
alert("Sidebar nur für Mozilla oder Netscape 6+");
}
// ->


und dann können Sie einen Link "Dies zur Seitenleiste hinzufügen" einfügen, indem Sie dies als Vorlage verwenden:

Zur Seitenleiste hinzufügen

oder wenn Sie es vorziehen, die standardmäßige Netscape-Schaltfläche "Registerkarte hinzufügen" zu verwenden, würden Sie dies tun
mit


<IMG SRC="/gifs/add-button.gif" HEIGHT=45 WIDTH=100
ALT="[Seitenleiste hinzufügen]" STYLE="border:0">


Die "add-button.gif" ist bei Netscape erhältlich unter
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Wenn FILENAME nicht mit einem Schrägstrich beginnt, wird die Netscape-Seitenleistendatei in das
$XYMONHOME/www/-Verzeichnis.

--nslimit=FARBE
Die Mindestfarbe, die in die Netscape-Sidebar aufgenommen werden muss - Standard ist "rot", was bedeutet, dass
nur kritische Warnungen sind enthalten. Wenn Sie auch Warnungen einfügen möchten, verwenden Sie
"--nslimit=gelb".

--rss Erzeugt einen RSS/RDF-Inhaltslieferstrom Ihrer Xymon-Warnungen. Dieses Ausgabeformat
kann dynamisch in andere Webseiten eingebettet werden, ähnlich wie die Live-Newsfeeds oft
auf Webseiten gesehen. Es werden zwei RSS-Dateien generiert, eine spiegelt die "Alle nicht-
grüne" Seite, die andere spiegelt die Seite "Kritisch" wieder. Sie werden in der
„nongreen.rss“- und „kritische.rss“-Dateien. Außerdem eine RSS-Datei
wird für jede Seite und/oder Unterseite generiert, in der die Hosts aufgelistet sind, die auf dieser vorhanden sind
Seite oder Unterseite.
Der zuvor für die Option --rss zulässige Parameter FILENAME ist nun veraltet.
Weitere Informationen zu RSS/RDF-Inhaltsfeeds finden Sie unter
http://www.syndic8.com/.

--rserweiterung=.ERWEITERUNG
Legt die Dateinamenerweiterung fest, die für die von xymongen generierten RSS-Dateien verwendet wird. Von
Standardmäßig wird die Erweiterung ".rss" verwendet. Beachten Sie, dass Sie den "Punkt" angeben müssen.

--rssversion={0.91|0.92|1.0|2.0}
Das gewünschte Ausgabeformat des RSS/RDF-Feeds. Version 0.91 scheint die meiste zu sein
häufig verwendetes Format und ist die Standardeinstellung, wenn diese Option weggelassen wird.

--rsslimit=FARBE
Die Mindestfarbe, die in den RSS-Feed aufgenommen werden muss - Standard ist "rot", was bedeutet, dass nur
kritische Warnungen sind enthalten. Wenn Sie auch Warnungen einfügen möchten, verwenden Sie
"--rsslimit=gelb".

OPTIONAL BENUTZT BY CGI FRONT-ENDS

--reportopts=START:ENDE:DYNAMISCH:STIL
Rufen Sie xymongen im Berichterstellungsmodus auf. Dies wird normalerweise von den
Bericht.cgi(1) CGI-Skript, kann aber auch direkt beim Vorgenerieren verwendet werden
berichtet. Der Parameter START ist die Startzeit für den Bericht in Unix time_t
Format (Sekunden seit dem 1. Januar 1970 00:00 UTC); END ist die Endzeit für den Bericht;
DYNAMIC ist 0 für einen vorgefertigten Bericht und 1 für einen dynamischen (Online-)Bericht; STIL ist
"crit", um nur kritische (rote) Ereignisse einzuschließen, "nongr", um alle nicht-grünen Ereignisse einzuschließen
Ereignisse und "alle", um alle Ereignisse einzuschließen.

--csv=DATEINAME
Wird zusammen mit --reportopts verwendet, bewirkt dies, dass xymongen eine Verfügbarkeit generiert
Bericht in Form einer Datei mit durch Kommas getrennten Werten (CSV). Dieses Format ist häufig
zum Importieren in Tabellenkalkulationen zur weiteren Verarbeitung verwendet.
Die CSV-Datei enthält Unix-Zeitstempel. Um diese als für Menschen lesbare Zeiten anzuzeigen in
Excel, die Formel =C2/86400+DATUMWERT (1. Januar 1970) (wenn Sie den Unix-Zeitstempel haben
in der Zelle C2) verwendet werden. Die Ergebniszelle sollte als Datum/Uhrzeit formatiert sein
Gebiet. Beachten Sie, dass die Zeitstempel in UTC angegeben sind, sodass Sie möglicherweise auch lokal verarbeiten müssen
Zeitzone und DST selbst ausgeben.

--csvdelim=TRENNZEICHEN
Standardmäßig wird ein Komma verwendet, um Felder in der CSV-Ausgabe abzugrenzen. Einige nicht englisch
Tabellenkalkulationen verwenden ein anderes Trennzeichen, normalerweise Semikolon. So generieren Sie eine CSV
Datei mit dem richtigen Trennzeichen, können Sie mit dieser Option das verwendete Zeichen einstellen
als Trennzeichen. ZB "--csvdelim=;" - Beachten Sie, dass dies normalerweise doppelt sein sollte
Anführungszeichen, um zu verhindern, dass die Unix-Shell das Trennzeichen als a . interpretiert
Befehlszeilentrennzeichen.

--snapshot=ZEIT
Erstellen Sie einen Schnappschuss der Xymon-Seiten, wie sie zur TIME erschienen sind. ZEIT ist gegeben als
Sekunden seit dem 1. Januar 1970 00:00 UTC. Normalerweise verwendet über die Snapshot.cgi(1) CGI
Skripte.

FEHLERBEHEBUNG OPTIONAL

--debuggen
Bewirkt, dass xymongen große Mengen an Debugging-Ausgaben auf stdout ausgibt, wenn dies der Fall war
mit aktiviertem -DDEBUG kompiliert. Wenn Sie ein Problem mit xymongen melden, bitte
Versuchen Sie, das Problem zu reproduzieren und die Ausgabe von xymongen damit bereitzustellen
.

--zeitliche Koordinierung
Geben Sie Informationen über die Zeit ab, die verschiedene Teile von xymongen auf stdout verbracht haben. Dies
ist nützlich, um zu sehen, welcher Teil der Verarbeitung für die Laufzeit von . verantwortlich ist
xymongen.
Hinweis: Diese Informationen werden auch in der Ausgabe bereitgestellt, die an das Xymon-Display gesendet wird
wenn Sie die Option "--report" verwenden.

GEBÄUDE- WECHSELN SEITENSÄTZE

Mit Version 1.4 von xymongen gibt es die Möglichkeit, mehrere Seitensätze aus zu generieren
die gleichen Daten.
Angenommen, Sie haben zwei Gruppen von Personen, die sich die Xymon-Webseiten ansehen. Gruppe A will
lassen Sie die Hosts nach dem Client gruppieren, zu dem sie gehören. So richten Sie Xymon ein -
das Standardseitenset. Nun möchte Gruppe B die Hosts nach Betriebssystem gruppieren -
nennen wir es das "os"-Set. Dann würden Sie das Seitenlayout wie folgt zu hosts.cfg hinzufügen:

ospage gewinnt Microsoft Windows
ossubpage win-nt4 MS Windows NT 4
osgroup NT4 Dateiserver
osgroup NT4 Mailserver
ossubpage win-xp MS Windows XP
Betriebssystem Unix Unix
ossubpage unix-sun Solaris
ossubpage unix-linux Linux

Dies definiert einen Satz von Seiten mit einer Seite der obersten Ebene (der xymon.html-Seite), zwei Seiten
verlinkt von xymon.html (win.html und unix.html), und von zB der win.html-Seite gibt es
Unterseiten win-nt4.html und win-xp.html
Die Syntax ist identisch mit den normalen Direktiven "page" und "subpage" in hosts.cfg, aber
der Direktive wird der Name des Seitensets vorangestellt. Setzen Sie keine Hosts zwischen die Seite
und Unterseiten-Direktiven - fügen Sie einfach alle Direktiven am Anfang der hosts.cfg-Datei hinzu.
Wie fügt man dann Hosts zu den Seiten hinzu? Ganz einfach - setzen Sie einfach ein Tag "OS:win-xp" auf dem Host
Definitionszeile. Das "OS" muss mit dem Präfix identisch sein, das für die Seitenset-Namen verwendet wird, aber in
Großbuchstaben. Das "win-xp" muss mit einer der darin definierten Seiten oder Unterseiten übereinstimmen
Seitensatz. Z.B

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/

Wenn der Host in einer auf dieser Seite definierten Gruppe erscheinen soll, müssen Sie den
gruppieren nach Nummer, beginnend bei 1. Um zB einen Host in die Gruppe "NT4 Mailserver" einzufügen in
Verwenden Sie im obigen Beispiel "OS:win-nt4,2" (die zweite Gruppe auf der Seite "win-nt4").
Wenn Sie möchten, dass der Host auf der Startseite statt auf einer Unterseite angezeigt wird, verwenden Sie "OS:*" .

All dies definiert nur das Layout des neuen Seitensatzes. Um es zu generieren, müssen Sie ausführen
xymongen einmal für jedes von Ihnen definierte Seitenset - dh erstellen Sie ein Erweiterungsskript wie folgt:

#!/ Bin / sh

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

Speichern Sie dies in $XYMONHOME/ext/os-display.sh und richten Sie dies so ein, dass es als Xymon-Erweiterung ausgeführt wird;
Dies bedeutet, dass der Tasks.cfg ein zusätzlicher Abschnitt hinzugefügt wird, um ihn auszuführen.

Dadurch werden die Seiten generiert. Hier werden einige wichtige Optionen verwendet:
* Umgebungsvariable XYMONWEB="/xymon/os" und die
Die Option "$XYMONHOME/www/os/" arbeitet zusammen und platziert die
neue Seitenset-HTML-Dateien in einem Unterverzeichnis außerhalb des Normalen
Xymon-Webroot. Wenn Sie normalerweise auf die Xymon-Seiten zugreifen als
"http://xymon.acme.com/xymon/", Sie werden dann zugreifen
das neue Seitenset als "http://xymon.acme.com/xymon/os/"
Hinweis: Das als XYMONWEB angegebene Verzeichnis muss ein symbolisches . enthalten
Link zum Verzeichnis $XYMONHOME/www/html/ oder Links zu
einzelne Statusmeldungen funktionieren nicht. Ähnliche Links
sollte für die Gifs/, Hilfe/ und Notizen/ gemacht werden
Verzeichnisse.
* "--pageset=os" weist xymongen an, die Webseiten zu strukturieren
das "os"-Layout anstelle des Standardlayouts verwenden.
* "--template=os" weist xymongen an, einen anderen Satz von zu verwenden
Kopf- und Fußzeilen-Vorlagen. Normalerweise verwendet xymongen die
Standardvorlage in $XYMONHOME/web/stdnormal_header und
.../stdnormal_footer - mit dieser Option wird stattdessen verwendet
die Dateien "os_header" und "os_footer" aus dem
$XYMONHOME/web/-Verzeichnis. Dadurch können Sie anpassen
Kopf- und Fußzeilen für jedes Seitenset. Wenn du nur willst
Um die normale Vorlage zu verwenden, können Sie diese Option weglassen.

VERWENDUNG XYMONGEN FÜR BERICHTE

xymongen-Berichterstellung wird durch Drop-in-Ersatz für das Standard-Xymon . implementiert
Berichterstellungsskripte (report.sh und reportlog.sh), die in Ihren Webservern cgi-bin installiert sind
Verzeichnis.

Diese beiden Shell-Skripte wurden durch zwei sehr kleine Shell-Skripte ersetzt, die lediglich
richten Sie die Xymon-Umgebungsvariablen ein und rufen Sie die Bericht.cgi(1) or reportlog.cgi(1)
Skripte in $XYMONHOME/bin/

Sie können beim Generieren von Berichten xymongen-Befehlszeilenoptionen verwenden, um z. B. bestimmte auszuschließen
Testtypen (zB "--ignorecolumns=msgs") aus den Berichten, um den Namen des
Trend- und Info-Spalten, die nicht im Bericht enthalten sein sollen, oder um den Bericht zu formatieren
anders (zB "--subpagecolumns=2"). Wenn Sie möchten, dass bestimmte Optionen verwendet werden, wenn a
Bericht über die Weboberfläche generiert wird, geben Sie diese Optionen in Ihr
Datei $XYMONHOME/etc/xymonserver.cfg in der Umgebungsvariablen XYMONGENREPOPTS.

Die von xymongen generierten Berichtsdateien werden in einzelnen Verzeichnissen gespeichert (eine pro
report) unterhalb des Verzeichnisses $XYMONHOME/www/rep/. Diese sollten automatisch bereinigt werden
- Wenn neue Berichte erstellt werden, werden die alten entfernt.

Versuchen Sie nach der Installation, einen Bericht zu erstellen. Sie werden wahrscheinlich sehen, dass die Links in der
obere linke Ecke (zu ack.html, nongreen.html etc.) funktioniert nicht mehr. Um diese zu beheben, ändern Sie
Ihre $XYMONHOME/web/repnormal_header-Datei, damit diese Links nicht auf "&XYMONWEB" verweisen, sondern
zum normalen URL-Präfix für Ihre Xymon-Seiten.

SLA REPORTING

xymongen-Reporting ermöglicht die Generierung eines echten SLA (Service Level Agreement)
Berichte, auch für Servicezeiträume, die nicht 24x7 sind. Dies wird durch die Definition von a . ermöglicht
"REPORTTIME:timespec"-Tag für die Hosts zur Definition des Servicezeitraums und optional a
Tag "WARNPCT:level", um die vereinbarte Verfügbarkeit zu definieren.

Hinweis: Siehe hosts.cfg(5) für die genaue Syntax dieser Optionen.

"REPORTTIME:timespec" gibt die Tageszeit an, zu der der Dienst voraussichtlich verfügbar ist und
Laufen. Standardmäßig sind dies 24 Stunden am Tag, alle Tage der Woche. Wenn Ihr SLA nur abdeckt
Mo-Fr 7-8 Uhr, Sie definieren dies als "REPORTTIME=W:0700:2000" und der Reportgenerator
berechnet dann sowohl die normale 24x7-Verfügbarkeit als auch eine "SLA-Verfügbarkeit", die
berücksichtigt nur den Status des Hosts während der SLA-Periode.

Der Parameter DOWNTIME:timespec beeinflusst die SLA-Verfügbarkeitsberechnung. Bei einem Ausfall
während der als möglich definierten Zeit "DOWNTIME" auftritt, dann wird der Ausfall mit a . gemeldet
Status "blau". (Die gleiche Farbe wird verwendet, wenn Sie "deaktivieren" und dann mit dem Xymon hosten
Funktion "deaktivieren"). Die Zeit, in der der Teststatus "blau" ist, ist nicht im SLA enthalten
Berechnung, weder in der Zeit, in der der Host als ausgefallen gilt, noch in der
Gesamtzeit, die der Bericht abdeckt. Die "blaue" Zeit wird also effektiv von der ignoriert
SLA-Verfügbarkeitsberechnung, damit Sie Ausfallzeiten planen können, ohne die
gemeldete SLA-Verfügbarkeit.

Beispiel: Ein Host hat "DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200", weil er neu gestartet wird
täglich zwischen 7 und 7.30 Uhr, der Service muss jedoch von 6 bis 10 Uhr verfügbar sein. Zum
am Tag des Berichts war es von 7:10 Uhr auf 7:15 Uhr (der geplante Neustart) zurückgegangen, aber auch
von 9:53 bis 10:15 Uhr. Die Ereignisse des Tages sind also:

0700 : grün für 10 Minuten (600 Sekunden)
0710 : blau für 5 Minuten (300 Sekunden)
0715 : grün für 14 Stunden 38 Minuten (52680 Sekunden)
2153 : rot für 22 Minuten (1320 Sekunden)
2215 : grün

Der Dienst ist für 600+52680 = 53280 Sekunden verfügbar. Es ist für 420 Sekunden unten (rot)
(die Zeit von 21:53 bis 22:00 Uhr, wenn der SLA-Zeitraum endet). Die Gesamtzeit, die in der enthalten ist
Der Bericht dauert 15 Stunden (7:10 - 5:53700 Uhr), mit Ausnahme der XNUMX Minuten blau = XNUMX Sekunden. Also das SLA
Verfügbarkeit ist 53280/53700 = 99,22%

Das Tag "WARNPCT:level" wird in der Datei hosts.cfg unterstützt, um die Verfügbarkeit einzustellen
Schwellenwert auf Host-zu-Host-Basis. Dieser Schwellenwert bestimmt, ob ein Test gemeldet wird als
grün, gelb oder rot in den Berichten. Für alle Hosts mit dem via . kann ein Standardwert gesetzt werden
die Umgebungsvariable XYMONREPWARN, aber überschrieben von diesem Tag. Das Niveau wird angegeben als
ein Prozentsatz, zB "WARNPCT:98.5"

VORGENERIERT BERICHTE

Normalerweise erstellt xymongen Berichte, die auf dynamisch generierte Webseiten mit dem
detaillierter Status eines Tests (über das CGI-Skript reportlog.sh).

Es ist möglich, dass xymongen einen Bericht ohne diese dynamischen Links erstellt
Bericht kann auf einen anderen Server exportiert werden. Es kann auch sinnvoll sein, die
Berichte, um die Last zu verringern, indem mehrere Benutzer dieselben Berichte erstellen.

Dazu müssen Sie xymongen mit der Option "--reportopts" ausführen, um die Zeit auszuwählen
Intervall, das der Bericht abdeckt, der Berichtsstil (kritisch, nicht grün oder alle Ereignisse),
und anzufordern, dass keine dynamischen Seiten erzeugt werden sollen.

Die Syntax lautet:

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

"starttime" und "endtime" werden als Unix-time_t-Werte angegeben, dh Sekunden seit dem 1. Januar
1970 00:00 GMT. Glücklicherweise kann dies leicht mit dem GNU-Datumsdienstprogramm berechnet werden, wenn Sie
Verwenden Sie die Ausgabeoption "+%s". Wenn Sie das GNU-Datumsdienstprogramm nicht haben, nehmen Sie es entweder auf
von www.gnu.org; oder Sie können das Dienstprogramm "etime" für den gleichen Zweck verwenden, nämlich
abrufbar im Archiv unter www.deadcat.net.

"nodynamic" ist entweder 0 (für dynamische Seiten die Standardeinstellung) oder 1 (für keine dynamische, d.
generiert, Seiten).

"style" ist entweder "crit" (beinhaltet kritische, dh nur rote Ereignisse), "nongr" (beinhaltet alle
nicht-grüne Ereignisse) oder "alle" (alle Ereignisse einschließen).

Andere xymongen-Optionen können verwendet werden, zB "--ignorecolumns", wenn Sie bestimmte ausschließen möchten
Tests aus dem Bericht.

Normalerweise müssen Sie auch die Umgebungsvariable XYMONWEB angeben (sie muss mit
die Basis-URL, von der aus auf den Bericht zugegriffen wird) und ein Ausgabeverzeichnis
wo die Berichtsdateien gespeichert werden. Wenn Sie XYMONWEB angeben, sollten Sie wahrscheinlich auch
Definieren Sie die Umgebungsvariablen XYMONHELPSKIN und XYMONNOTESSKIN. Diese sollten darauf hinweisen
die URL, unter der sich Ihre Xymon-Hilfe- und Notizen-Dateien befinden; wenn sie nicht definiert sind,
Links zu Hilfe- und Notizendateien zeigen in das Berichtsverzeichnis und werden wahrscheinlich
nicht arbeiten.

Ein typischer Aufruf von xymongen für einen statischen Bericht wäre also:

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

Die Einstellung "XYMONWEB" bedeutet, dass der Bericht mit einer URL von . verfügbar ist
"http://www.server.com/reports/xymon/daily/2003/06/22". Der Bericht enthält interne
Links, die diese URL verwenden, sodass sie nicht einfach an einen anderen Ort verschoben werden können.

Der letzte Parameter ist das entsprechende physische Verzeichnis auf Ihrem Webserver, das mit dem übereinstimmt
XYMONWEB-URL. Sie können die Berichtsdateien natürlich überall erstellen - vielleicht am
eine andere Maschine - und dann später auf den Webserver verschieben.

Beachten Sie, wie die Datum(1) Das Dienstprogramm wird verwendet, um die Start- und Endzeitparameter zu berechnen.

VARIABLEN

BOARDFILTER
Filter, der verwendet wird, um auszuwählen, welche Hosts / Tests in den Webseiten enthalten sind, durch Filtern
die von xymond abgerufenen Daten über den Befehl xymondboard. Sehen Xymon(1) für Details
zur Filtersyntax. Standardmäßig wird keine Filterung durchgeführt.

Verwenden Sie xymongen online mit den onworks.net-Diensten