xymongen - En ligne dans le Cloud

PROGRAMME:

Nom

xymongen - Générateur de pages Web Xymon

SYNOPSIS

xymongène -?
xymongène --Aidez-moi
xymongène --version
xymongène [choix] [répertoire de sortie]
(Voir la section OPTIONS pour une description des options de ligne de commande disponibles).

DESCRIPTION

xymongène génère les pages Web de présentation du moniteur Xymon. Ce sont les pages Web
qui affichent l'état général de vos hôtes, pas les pages d'état détaillées pour chaque test.

Remarque : les données des pages Web sont extraites du xymond(8) démon, et xymongen utilise
les valeurs des variables d'environnement XYMSRV / XYMSERVERS pour déterminer le réseau
adresse où xymond peut être atteint. Si vous avez plusieurs serveurs répertoriés dans
XYMSERVERS, assurez-vous que le premier est le serveur Xymon local - c'est celui qui
xymongen demandera des données.

OPTIONS

xymongen a un grand nombre d'options de ligne de commande. Les options peuvent être utilisées pour modifier
le comportement de xymongen et affecter les pages Web générées par celui-ci.

GÉNÉRAL OPTIONS

--help ou -?
Fournissez un résumé des options de ligne de commande disponibles.

--version
Imprime le numéro de version de xymongen

--docurl=URL
Cette option est obsolète, utilisez le paramètre HOSTDOCURL dans xymonserver.cfg(5)
à la place.

--doccgi=URL
Cette option est obsolète, utilisez le paramètre HOSTDOCURL dans xymonserver.cfg(5)
à la place.

--doc-fenêtre
Les liens vers la documentation des hôtes et des services s'ouvrent dans une nouvelle fenêtre. Les
par défaut, la documentation s'affiche dans la même fenêtre de navigateur que l'état Xymon.

--htmlextension=.EXTENSION
Définit l'extension de nom de fichier utilisée pour les pages Web générées par xymongen. Par
par défaut, une extension de ".html" est utilisée. Notez que vous devez spécifier le "point".

--report[=NOM DE LA COLONNE]
Avec cette option, xymongen enverra un message d'état avec des détails sur le nombre
hôtes ont été traités, combien de pages ont été générées, toutes les erreurs qui se sont produites
pendant la course, et quelques statistiques de synchronisation. Le nom de colonne par défaut est "xymongen".

--htaccess[=htaccess-nom-fichier]
Créez des fichiers .htaccess lorsque de nouveaux répertoires de pages Web sont créés. Le contenu de
les fichiers .htaccess sont déterminés par la variable d'environnement XYMONHTACCESS (pour
le répertoire de niveau supérieur avec xymon.html et nongreen.html); par le
variable XYMONPAGEHTACCESS (pour les répertoires de niveau page) ; et par le
Variable XYMONSUBPAGEHTACCESS pour les répertoires de niveau sous-page et sous-parent. Les
le nom de fichier des fichiers .htaccess est par défaut ".htaccess" si aucun nom de fichier n'est donné avec
cette option. La variable XYMONHTACCESS est copiée textuellement dans le niveau supérieur
fichier .htaccess. La variable XYMONPAGEHTACCESS peut contenir un "%s" où le nom
de la page est inséré. La variable XYMONSUBPAGEHTACCESS peut contenir deux "%s"
instances : le premier est remplacé par le nom de la page, le second par le
nom de la sous-page.

--max-eventcount=N
Limitez le journal des événements sur la page "Tous non verts" à seulement N événements. Par défaut : 100.

--max-heure d'événement=N
Limitez le journal des événements sur la page « Tous non verts » aux événements qui se sont produits dans le
dernières N minutes. Par défaut : 240.

--no-eventlog
Désactiver le journal des événements normalement affiché sur la page "Tous non verts"

--max-compte-compte=N
Limitez le journal d'acquittement sur la page "Tous non verts" à seulement N événements. Défaut:
25.

--max-acktime=N
Limitez le journal des accusés de réception sur la page "Tous les non-verts" aux accusés de réception qui se sont produits
au cours des N dernières minutes. Par défaut : 240.

--no-acklog
Désactivez le journal d'acquittement normalement affiché sur la page "Tous non verts".

--cricitcallog[=colonne du journal critique]
Cela génère un journal textuel de ce qui est affiché sur la page d'état critique.html,
et envoie un message d'état pour le serveur Xymon lui-même reflétant la couleur du
Page d'état critique. Cela vous permet de savoir quand des problèmes sont apparus sur le
page d'état critique. Le fichier journal est stocké dans $XYMONSERVERLOGS/criticalstatus.log

--loadhostsfromxymond
Au lieu de lire le fichier hosts.cfg, xymongen chargera hosts.cfg
configuration à partir du démon xymond. Cela élimine le besoin de lire le
hosts.cfg, et si vous avez xymond et xymongen exécutés sur des hôtes différents, il
élimine le besoin de copier le fichier hosts.cfg entre les systèmes. Notez que le
L'option "dispinclude" dans hosts.cfg est ignorée lorsque cette option est activée.

PAGE LAYOUT OPTIONS

Ces options affectent la façon dont les pages Web générées par xymongen apparaissent dans le navigateur.

--pages-dernier
Mettez les liens de page et de sous-page après les hôtes.

--pages-premier
Mettez les liens de page et de sous-page avant les hôtes (par défaut).

Ces deux options décident si une page avec des liens vers des sous-pages et des hôtes a le
hôtes ou les sous-pages en premier.

--subpagecolumns=N
Détermine le nombre de colonnes utilisées pour les liens vers les pages et les sous-pages. Le défaut
est N=1.

--maxrows=N
Les en-têtes de colonne sur une page ne sont par défaut affichés qu'au début d'une page,
sous-page ou groupe d'hôtes. Cette option entraîne la répétition des en-têtes de colonne pour
tous les N hôtes affichés.

--showemptygroups

--no-showemptygroups
Lorsque les groupes sont des hôtes, affichez la table et les noms d'hôtes même s'il y a
aucun test présent pour aucun des hôtes en question. Utilisez --no-showemptygroups pour
cacher. (Par défaut : oui)

--pagetitre-liens
Normalement, seuls les "points" colorés à côté d'une page ou d'une sous-page servent de liens vers le
page elle-même. Avec cette option, le titre de la page sera également lié à la page.

--pagetext-titres
Utilisez le texte de description des balises « page » ou « sous-page » comme titre pour le
page, au lieu des "Pages hébergées localement" ou d'un autre en-tête standard.

--pas de titres soulignés
Normalement, les en-têtes de page sont soulignés à l'aide d'une balise HTML "règle horizontale". Cette
L'option désactive le soulignement des titres.

--gifs récents[=MINUTES]
Utilisez des images nommées COLOR-recent.gif pour les tests, où l'état du test a changé
au cours des dernières 24 heures. Ces fichiers GIF doivent être installés dans le
Répertoire $XYMONHOME/www/gifs/. Par défaut, le seuil est défini sur 24 heures - si
vous le voulez différemment, vous pouvez également spécifier le délai. Par exemple
"--recentgifs=3h" affichera les GIF récents pendant seulement 3 heures après un changement de statut.

--sort-group-only-items
Dans une directive normale "groupe uniquement", vous pouvez spécifier l'ordre dans lequel les tests
sont affichés, de gauche à droite. Si vous préférez que les tests soient répertoriés dans
ordre alphabétique, utilisez cette option - la page générera alors "groupe uniquement"
des groupes comme celui-ci génère des groupes normaux et trie les tests par ordre alphabétique.

--dialupskin=URL
Si vous voulez montrer visuellement qu'un test est un test d'accès à distance, vous pouvez utiliser un autre
ensemble d'icônes pour le vert/rouge/jaune>/etc. images en spécifiant cette option. Les
Le paramètre d'URL spécifié ici remplace le paramètre normal du XYMONSKIN
variable d'environnement, mais uniquement pour les tests de connexion.

--reverseskin=URL
Identique à "--dialupskin", mais pour les tests inversés (tests avec '!' devant).

--tooltips=[toujours,jamais,principal]
Détermine quelles pages utilisent des info-bulles pour afficher la description de l'hôte (à partir du
Commentaire entrée dans le hôtes.cfg(5) déposer). Si réglé sur toujours, les infobulles sont utilisées sur tous
pages. Si réglé sur n'allons jamais , les infobulles ne sont jamais utilisées. Si réglé sur principal, les infobulles sont utilisées
sur les pages principales, mais pas sur les pages "Tous les non-verts" ou "Systèmes critiques".

COLONNE SÉLECTION OPTIONS

Ces options affectent les colonnes (tests) incluses dans les pages Web générées par
xymongène.

--ignorecolumns=test[,test]
Les colonnes données seront complètement ignorées par xymongen lors de la génération de pages Web.
Peut être utilisé pour générer des rapports où vous éliminez certains des tests les plus bruyants,
comme "msgs".

--critical-reds-uniquement
Seules les colonnes d'état rouges seront incluses sur la page Critique. Par défaut, le
La page critique contiendra des hôtes avec un statut rouge, jaune et clair.

--nongreen-colors=COULEUR[,COULEUR]
Définit les couleurs qui provoquent l'apparition d'un test sur la page d'état « Tout non vert ».
La COULEUR est rouge, jaune ou violet. La valeur par défaut est d'inclure les trois.

--nongreen-ignorecolumns=test[,test]
Identique à --ignorecolumns, mais s'applique uniquement aux hôtes de la page "Tous non verts".

--nongreen-ignorepurples
Obsolète, utilisez plutôt "--nongreen-colors".

--nongreen-ignoredialups
Ignorez tous les hôtes de connexion sur la page "Tous non verts", y compris le journal des événements.

--pas de pages
Ne pas générer les pages normales (normalement utilisées pour générer uniquement les pages non vertes
page).

--non-non-vert
Ne générez pas la page "Tous non verts".

--includecolumns=test[,test]
Incluez toujours ces colonnes sur la page « Tous les non-verts » Inclut certaines colonnes
sur la page nongreen.html, quelle que soit sa couleur. Normalement, nongreen.html laisse tomber un
colonne de test, si tous les tests sont verts. Cela peut être utilisé par exemple pour avoir toujours un lien vers
la colonne des tendances (avec les graphiques RRD) de votre page nongreen.html.

--eventignore=test[,test]
Ignorez ces tests dans l'affichage du journal des événements « Tous non verts ».

STATUT PROPAGATION OPTIONS

Ces options suppriment la propagation normale d'un statut vers le haut dans la hiérarchie des pages.
Ainsi, vous pouvez avoir un test avec le statut jaune ou rouge, mais avoir toujours la page entière verte.
Il est utile pour les tests qui n'ont pas besoin de déclencher une alarme, mais pour lesquels vous souhaitez tout de même connaître le
statut actuel. Ces options définissent des valeurs par défaut globales pour tous les hôtes ; vous pouvez utiliser le NOPROPRED
et les balises NOPROPYELLOW dans le hôtes.cfg(5) fichier pour appliquer des limites similaires sur un hôte par hôte
base.

--nopropyellow=test[,test] ou --noprop=test[,test]
Désactivez la propagation d'état vers le haut lorsque JAUNE. L'option "--noprop" est dépréciée
et ne doit pas être utilisé.

--noproppurple=test[,test]
Désactivez la propagation d'état vers le haut lorsque VIOLET.

--nopropred=test[,test]
Désactivez la propagation d'état vers le haut lorsque ROUGE ou JAUNE.

--nopropack=test[,test]
Désactivez la propagation d'état vers le haut lorsque l'état a été acquitté. Si tu veux
pour désactiver la propagation de tous les tests ackés, utilisez "--nopropack=".

PURPLE STATUT OPTIONS

Les états violets se produisent lorsque le rapport d'un état de test s'arrête. Un statut de test est valable pour un
durée limitée - normalement 30 minutes - et après cette durée, le test devient
violet.

--purplelog=NOM DE FICHIER
Générez un fichier journal de tous les messages d'état violets.

ALTERNER ENSEMBLE DE PAGES OPTIONS

--pageset=NOM DE LA PAGE
Créez des pages Web pour un autre ensemble de pages que celui par défaut. Voir la section ENSEMBLES DE PAGES
ci-dessous.

--template=MODÈLE
Utilisez un autre modèle pour les fichiers d'en-tête et de pied de page. Généralement utilisé avec le
l'option "--pageset" ; voir la section ENSEMBLES DE PAGES ci-dessous.

ALTERNER SORTIE FORMATS

--wml[=test1,test2,...]
Cette option permet à xymongen de générer un ensemble de fichiers "cartes" WML qui peuvent être
accessible par un appareil WAP (téléphone portable, PDA etc.) Les fichiers générés contiennent les
hôtes qui ont un statut ROUGE ou JAUNE sur les tests spécifiés. Cette option peut définir
les tests par défaut à inclure - les valeurs par défaut peuvent être remplacées ou modifiées à l'aide du
Les balises « WML : » ou « NK : » dans le hôtes.cfg(5) déposer. Si aucun test n'est spécifié, tous les tests
sera inclus.

--nstab=NOM DE FICHIER
Générez un fichier HTML adapté à une entrée de barre latérale Netscape 6/Mozilla. En fait
permettre à vos utilisateurs d'obtenir une telle entrée dans la barre latérale, vous avez besoin de ce code Javascript dans
une page Web (par exemple, vous pouvez l'inclure dans le fichier $XYMONHOME/web/stdnormal_header) :


<!--
fonction addNetscapePanel() {
if ((typeof window.sidebar == "object") &&
(typeof window.sidebar.addPanel == "fonction"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html","");
d'autre
alert("Barre latérale uniquement pour Mozilla ou Netscape 6+");
}
// ->


puis vous pouvez inclure un lien "Ajouter ceci à la barre latérale" en utilisant ceci comme modèle :

Ajouter à la barre latérale

ou si vous préférez avoir le bouton "Ajouter un onglet" standard de Netscape, vous le feriez
avec


<IMG SRC="/gifs/add-button.gif" HAUTEUR=45 LARGEUR=100
ALT="[Ajouter une barre latérale]" STYLE="border:0">


Le "add-button.gif" est disponible sur Netscape à l'adresse
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Si FILENAME ne commence pas par une barre oblique, le fichier de la barre latérale Netscape est placé dans le
Répertoire $XYMONHOME/www/.

--nslimit=COULEUR
La couleur minimale à inclure dans la barre latérale de Netscape - la valeur par défaut est "rouge", ce qui signifie
seules les alertes critiques sont incluses. Si vous souhaitez également inclure des avertissements, utilisez
"--nslimit=jaune".

--rss Génère le flux de diffusion de contenu RSS/RDF de vos alertes Xymon. Ce format de sortie
peut être intégré dynamiquement dans d'autres pages Web, un peu comme les flux d'actualités en direct souvent
vu sur les sites internet. Deux fichiers RSS seront générés, l'un reflète le "Tous les non-
verte", l'autre reflète la page "Critique". Ils seront dans la
Les fichiers "nongreen.rss" et "critical.rss", respectivement. De plus, un fichier RSS
sera généré pour chaque page et/ou sous-page listant les hébergeurs présents sur celle-ci
page ou sous-page.
Le paramètre FILENAME précédemment autorisé sur l'option --rss est désormais obsolète.
Pour plus d'informations sur les flux de contenu RSS/RDF, veuillez consulter
http://www.syndic8.com/.

--rssextension=.EXTENSION
Définit l'extension de nom de fichier utilisée pour les fichiers RSS générés par xymongen. Par
par défaut, une extension ".rss" est utilisée. Notez que vous devez spécifier le "point".

--rssversion={0.91|0.92|1.0|2.0}
Le format de sortie souhaité du flux RSS/RDF. La version 0.91 semble être la plus
format couramment utilisé, et est la valeur par défaut si cette option est omise.

--rsslimit=COULEUR
La couleur minimale à inclure dans le flux RSS - la valeur par défaut est "rouge", ce qui signifie uniquement
les alertes critiques sont incluses. Si vous souhaitez également inclure des avertissements, utilisez
"--rsslimit=jaune".

OPTIONS OCCASION BY CGI PARTIES AVANT

--reportopts=DEBUT:FIN:DYNAMIQUE:STYLE
Appelez xymongen en mode de génération de rapport. Ceci est normalement utilisé par le
rapport.cgi(1) Script CGI, mais peut également être utilisé directement lors de la pré-génération
rapports. Le paramètre START est l'heure de début du rapport sous Unix time_t
format (secondes depuis le 1er janvier 1970 00:00 UTC); END est l'heure de fin du rapport ;
DYNAMIQUE vaut 0 pour un rapport prédéfini et 1 pour un rapport dynamique (en ligne) ; STYLE est
"crit" pour inclure uniquement les événements critiques (rouges), "nongr" pour inclure tous les événements non verts
événements, et "all" pour inclure tous les événements.

--csv=NOM DE FICHIER
Utilisé avec --reportopts, xymongen génère une disponibilité
rapport sous la forme d'un fichier de valeurs séparées par des virgules (CSV). Ce format est généralement
utilisé pour l'importation dans des feuilles de calcul pour un traitement ultérieur.
Le fichier CSV inclut les horodatages Unix. Pour les afficher sous forme d'heures lisibles par l'homme dans
Excel, la formule =C2/86400+VALEURDATE(1-jan-1970) (si vous avez l'horodatage Unix
dans la cellule C2) peut être utilisé. La cellule de résultat doit être formatée en date/heure
champ. Notez que les horodatages sont en UTC, vous devrez donc peut-être également gérer les
le fuseau horaire et l'heure d'été vous-même.

--csvdelim=DÉLIMITEUR
Par défaut, une virgule est utilisée pour délimiter les champs dans la sortie CSV. Certains non anglais
les feuilles de calcul utilisent un délimiteur différent, généralement un point-virgule. Pour générer un CSV
fichier avec le délimiteur approprié, vous pouvez utiliser cette option pour définir le caractère utilisé
comme délimiteur. Par exemple "--csvdelim=" - notez que cela devrait normalement être en double
guillemets, pour empêcher le shell Unix d'interpréter le caractère délimiteur comme un
délimiteur de ligne de commande.

--snapshot=HEURE
Générez un instantané des pages Xymon, telles qu'elles sont apparues à TIME. TEMPS est donné comme
secondes depuis le 1er janvier 1970 00:00 UTC. Normalement utilisé via le instantané.cgi(1) CGI
scripts.

DÉBOGAGE OPTIONS

--déboguer
Provoque xymongen pour vider de grandes quantités de sortie de débogage vers stdout, si c'était
compilé avec le -DDEBUG activé. Lorsque vous signalez un problème avec xymongen, veuillez
essayez de reproduire le problème et fournissez la sortie de l'exécution de xymongen avec ceci
option.

--Horaire
Transférez des informations sur le temps passé par diverses parties de xymongen vers stdout. Cette
est utile pour voir quelle partie du traitement est responsable de l'exécution de
xymongène.
Remarque : ces informations sont également fournies dans la sortie envoyée à l'écran Xymon
lors de l'utilisation de l'option "--report".

IMMEUBLE ALTERNER ENSEMBLES DE PAGES

Avec la version 1.4 de xymongen vient la possibilité de générer plusieurs ensembles de pages à partir de
les mêmes données.
Supposons que vous ayez deux groupes de personnes qui consultent les pages Web Xymon. Le groupe A veut
avoir les hôtes regroupés par le client auquel ils appartiennent. Voici comment vous avez configuré Xymon -
l'ensemble de pages par défaut. Maintenant, le groupe B veut que les hôtes soient regroupés par système d'exploitation -
appelons-le l'ensemble "os". Ensuite, vous ajouteriez la mise en page à hosts.cfg comme ceci :

ospage gagner Microsoft Windows
ossubpage win-nt4 MS Windows NT 4
serveurs de fichiers osgroup NT4
serveurs de messagerie osgroup NT4
ossubpage win-xp MS Windows XP
ospage unix Unix
ossubpage unix-sun Solaris
ossubpage unix-linux Linux

Cela définit un ensemble de pages avec une page de niveau supérieur (la page xymon.html), deux pages
lié à partir de xymon.html (win.html et unix.html), et à partir par exemple de la page win.html il y a
sous-pages win-nt4.html et win-xp.html
La syntaxe est identique aux directives normales "page" et "subpage" dans hosts.cfg, mais
la directive est précédée du nom de l'ensemble de pages. Ne mettez aucun hôte entre la page
et les directives de sous-page - ajoutez simplement toutes les directives en haut du fichier hosts.cfg.
Comment ajouter des hôtes aux pages, alors ? Simple - il suffit de mettre une balise "OS:win-xp" sur l'hôte
ligne de définition. Le « OS » doit être le même que le préfixe utilisé pour les noms des ensembles de pages, mais dans
majuscule. Le "win-xp" doit correspondre à l'une des pages ou sous-pages définies dans ce
ensemble de pages. Par exemple

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/

Si vous souhaitez que l'hôte apparaisse dans un groupe défini sur cette page, vous devez identifier le
regrouper par numéro, en commençant à 1. Par exemple pour mettre un hôte dans le groupe "NT4 Mail servers" dans
l'exemple ci-dessus, utilisez "OS:win-nt4,2" (le deuxième groupe sur la page "win-nt4").
Si vous voulez que l'hôte apparaisse sur la page d'accueil au lieu d'une sous-page, utilisez "OS:*" .

Tout cela définit simplement la mise en page du nouvel ensemble de pages. Pour le générer, vous devez exécuter
xymongen une fois pour chaque ensemble de pages que vous définissez - c'est-à-dire créez un script d'extension comme celui-ci :

#!/ Bin / sh

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

Enregistrez-le dans $XYMONHOME/ext/os-display.sh et configurez-le pour qu'il s'exécute en tant qu'extension Xymon ;
cela signifie ajouter une section supplémentaire à tasks.cfg pour l'exécuter.

Cela génère les pages. Certaines options importantes sont utilisées ici :
* Variable d'environnement XYMONWEB="/xymon/os", et la
L'option "$XYMONHOME/www/os/" fonctionne ensemble et place le
nouveaux fichiers HTML d'ensemble de pages dans un sous-répertoire hors de la normale
Racine Web Xymon. Si vous accédez normalement aux pages Xymon en tant que
"http://xymon.acme.com/xymon/", vous accéderez alors
le nouvel ensemble de pages en tant que "http://xymon.acme.com/xymon/os/"
NB : Le répertoire donné comme XYMONWEB doit contenir une symbolique
lien vers le répertoire $XYMONHOME/www/html/, ou des liens vers
les messages d'état individuels ne fonctionneront pas. Liens similaires
devrait être fait pour les gifs/, help/ et notes/
répertoires.
* "--pageset=os" indique à xymongen de structurer les pages Web
en utilisant la mise en page "os", au lieu de la mise en page par défaut.
* "--template=os" indique à xymongen d'utiliser un ensemble différent de
modèles d'en-tête et de pied de page. Normalement, xymongen utilise le
modèle standard dans $XYMONHOME/web/stdnormal_header et
.../stdnormal_footer - avec cette option, il utilisera à la place
les fichiers "os_header" et "os_footer" du
Répertoire $XYMONHOME/web/. Cela vous permet de personnaliser
en-têtes et pieds de page pour chaque ensemble de pages. Si tu veux juste
pour utiliser le modèle normal, vous pouvez omettre cette option.

EN UTILISANT XYMONGÈNE POUR RAPPORTS

Les rapports xymongen sont mis en œuvre via des remplacements instantanés pour le Xymon standard
scripts de reporting (report.sh et reportlog.sh) installés sur vos serveurs web cgi-bin
répertoire.

Ces deux scripts shell ont été remplacés par deux très petits scripts shell, qui
configurer les variables d'environnement Xymon et appeler le rapport.cgi(1) or reportlog.cgi(1)
scripts dans $XYMONHOME/bin/

Vous pouvez utiliser les options de ligne de commande xymongen lors de la génération de rapports, par exemple pour exclure certains
types de tests (par exemple "--ignorecolumns=msgs") des rapports, pour spécifier le nom du
des colonnes de tendances et d'informations qui ne devraient pas figurer dans le rapport, ou pour formater le rapport
différemment (par exemple "--subpagecolumns=2"). Si vous souhaitez que certaines options soient utilisées lorsqu'un
rapport est généré à partir de l'interface Web, placez ces options dans votre
$XYMONHOME/etc/xymonserver.cfg dans la variable d'environnement XYMONGENREPOPTS.

Les fichiers de rapport générés par xymongen sont stockés dans des répertoires individuels (un par
report) sous le répertoire $XYMONHOME/www/rep/. Ceux-ci devraient être automatiquement nettoyés
- à mesure que de nouveaux rapports sont générés, les anciens sont supprimés.

Après l'installation, essayez de générer un rapport. Vous verrez probablement que les liens dans le
le coin supérieur gauche (vers ack.html, nongreen.html etc.) ne fonctionne plus. Pour les corriger, changez
votre fichier $XYMONHOME/web/repnormal_header afin que ces liens ne fassent pas référence à "&XYMONWEB" mais
au préfixe d'URL normal pour vos pages Xymon.

Contrat de niveau de service DE LA LIGNE

Les rapports xymongen permettent la génération d'un véritable SLA (Service Level Agreement)
rapports, également pour les périodes de service qui ne sont pas 24x7. Ceci est activé en définissant un
Balise "REPORTTIME:timespec" pour les hôtes pour définir la période de service, et éventuellement un
Balise "WARNPCT:level" pour définir la disponibilité convenue.

Remarque: voir hôtes.cfg(5) pour la syntaxe exacte de ces options.

"REPORTTIME:timespec" spécifie l'heure à laquelle le service devrait être opérationnel et
fonctionnement. Par défaut, il s'agit de 24 heures par jour, tous les jours de la semaine. Si votre SLA ne couvre que
Du lundi au vendredi de 7h à 8h, vous définissez ceci comme "REPORTTIME=W:0700:2000", et le générateur de rapport
calculera alors à la fois la disponibilité normale 24x7 mais aussi une "disponibilité SLA" qui
ne prend en compte que le statut de l'hébergeur pendant la période du SLA.

Le paramètre DOWNTIME:timespec affecte le calcul de la disponibilité SLA. Si une panne
se produit pendant le temps défini comme possible "DOWNTIME", alors la panne est signalée avec un
statut de "bleu". (La même couleur est utilisée si vous "désactivez" puis hébergez en utilisant le Xymon
fonction "désactiver"). Le moment où l'état du test est « bleu » n'est pas inclus dans le SLA
calcul, ni dans la durée pendant laquelle l'hôte est considéré en panne, ni dans le
durée totale couverte par le rapport. Ainsi, le temps « bleu » est effectivement ignoré par le
Calcul de disponibilité SLA, vous permettant d'avoir des temps d'arrêt planifiés sans affecter le
disponibilité SLA signalée.

Exemple : Un hôte a "DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200" car il est redémarré
tous les jours entre 7h et 7.30h6, mais le service doit être disponible de 10h à XNUMXh. Pour
le jour du reportage, il était en baisse de 7h10 à 7h15 (le redémarrage prévu), mais aussi
de 9h53 à 10h15. Les événements de la journée sont donc :

0700 : vert pendant 10 minutes (600 secondes)
0710 : bleu pendant 5 minutes (300 secondes)
0715 : vert pendant 14 heures 38 minutes (52680 secondes)
2153 : rouge pendant 22 minutes (1320 secondes)
2215 : vert

Le service est disponible pendant 600+52680 = 53280 secondes. Il est en panne (rouge) pendant 420 secondes
(l'heure de 21h53 à 22h00 lorsque la période SLA se termine). Le temps total inclus dans le
rapport est de 15 heures (7h - 10h) sauf les 5 minutes bleu = 53700 secondes. Donc le SLA
la disponibilité est 53280/53700 = 99,22%

La balise "WARNPCT:level" est prise en charge dans le fichier hosts.cfg, pour définir la disponibilité
seuil hôte par hôte. Ce seuil détermine si un test est signalé comme
vert, jaune ou rouge dans les rapports. Une valeur par défaut peut être définie pour tous les hôtes avec le via
la variable d'environnement XYMONREPWARN, mais remplacée par cette balise. Le niveau est donné comme
un pourcentage, par exemple "WARNPCT:98.5"

PRÉ-GÉNÉRÉ RAPPORTS

Normalement, xymongen produit des rapports qui renvoient à des pages Web générées dynamiquement avec le
état détaillé d'un test (via le script CGI reportlog.sh).

Il est possible que xymongen produise un rapport sans ces liens dynamiques, ainsi le
rapport peut être exporté vers un autre serveur. Il peut également être utile de pré-générer le
rapports, pour réduire la charge en permettant à plusieurs utilisateurs de générer les mêmes rapports.

Pour ce faire, vous devez exécuter xymongen avec l'option "--reportopts" pour sélectionner l'heure
l'intervalle couvert par le rapport, le style de rapport (critique, non vert ou tous les événements),
et de demander qu'aucune page dynamique ne soit générée.

La syntaxe est:

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

"starttime" et "endtime" sont spécifiés en tant que valeurs Unix time_t, c'est-à-dire secondes depuis le 1er janvier
1970 00h00 GMT. Heureusement, cela peut être facilement calculé avec l'utilitaire de date GNU si vous
utilisez l'option de sortie "+%s". Si vous n'avez pas l'utilitaire de date GNU, récupérez-le
de www.gnu.org; ou vous pouvez utiliser l'utilitaire "etime" dans le même but, qui est
disponible dans les archives sur www.deadcat.net.

"nodynamic" est soit 0 (pour les pages dynamiques, la valeur par défaut) soit 1 (pour aucune dynamique, c'est-à-dire pré-
générés, pages).

"style" est soit "crit" (inclure les événements critiques, c'est-à-dire uniquement rouges), "nongr" (inclure tous
événements non verts) ou « tous » (inclure tous les événements).

D'autres options de xymongen peuvent être utilisées, par exemple "--ignorecolumns" si vous souhaitez exclure certains
tests du rapport.

Vous devrez normalement également spécifier la variable d'environnement XYMONWEB (elle doit correspondre
l'URL de base à partir de laquelle le rapport sera rendu accessible) et un répertoire de sortie
où les fichiers de rapport sont enregistrés. Si vous spécifiez XYMONWEB, vous devriez probablement aussi
définir les variables d'environnement XYMONHELPSKIN et XYMONNOTESSKIN. Ceux-ci devraient indiquer
l'URL où se trouvent vos fichiers d'aide et de notes Xymon ; s'ils ne sont pas définis, le
les liens vers les fichiers d'aide et de notes pointeront dans le répertoire du rapport et seront probablement
ne fonctionne pas.

Ainsi, un appel typique de xymongen pour un rapport statique serait :

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

Le paramètre "XYMONWEB" signifie que le rapport sera disponible avec une URL de
"http://www.server.com/reports/xymon/daily/2003/06/22". Le rapport contient des informations internes
liens qui utilisent cette URL, de sorte qu'elle ne peut pas être facilement déplacée vers un autre emplacement.

Le dernier paramètre est le répertoire physique correspondant sur votre serveur Web correspondant au
URL XYMONWEB. Vous pouvez bien sûr créer les fichiers de rapport n'importe où - peut-être sur
une autre machine - puis les déplacer vers le serveur Web ultérieurement.

Notez comment le données(1) L'utilitaire est utilisé pour calculer les paramètres d'heure de début et de fin.

ENVIRONNEMENT VARIABLES

CARTE FILTRE
Filtre utilisé pour sélectionner quels hôtes/tests sont inclus dans les pages Web, par filtrage
les données récupérées de xymond vi la commande xymondboard. Voir xymon(1) pour information
sur la syntaxe du filtre. Par défaut, aucun filtrage n'est effectué.

Utiliser xymongen en ligne en utilisant les services onworks.net