xymongen: en línea en la nube

PROGRAMA:

NOMBRE

xymongen - generador de páginas web Xymon

SINOPSIS

ximongen -?
ximongen --ayuda
ximongen --versión
ximongen [opciones] [directorio de salida]
(Consulte la sección OPCIONES para obtener una descripción de las opciones de línea de comandos disponibles).

DESCRIPCIÓN

ximongen genera las páginas web de descripción general para el monitor Xymon. Estas son las paginas web
que muestran el estado general de sus hosts, no las páginas de estado detalladas para cada prueba.

Nota: Los datos de las páginas web se obtienen del xmond(8) daemon y xymongen utiliza
los valores de las variables de entorno XYMSRV / XYMSERVERS para determinar la red
dirección donde se puede localizar a xymond. Si tiene más de un servidor en la lista
XYMSERVERS, asegúrese de que el primero sea el servidor Xymon local; este es el que
xymongen buscará datos.

CAMPUS

xymongen tiene una gran cantidad de opciones de línea de comandos. Las opciones se pueden utilizar para cambiar
el comportamiento de xymongen y afectar a las páginas web que genera.

GENERAL CAMPUS

- ayuda o -?
Proporcione un resumen de las opciones de línea de comandos disponibles.

--versión
Imprime el número de versión de xymongen

--docurl = URL
Esta opción está obsoleta, use la configuración HOSTDOCURL en xymonserver.cfg(5)
preferiblemente.

--doccgi = URL
Esta opción está obsoleta, use la configuración HOSTDOCURL en xymonserver.cfg(5)
preferiblemente.

--doc-ventana
Hace que los enlaces a la documentación de los hosts y los servicios se abran en una nueva ventana. los
el valor predeterminado es mostrar la documentación en la misma ventana del navegador que el estado de Xymon.

--htmlextension = .EXTENSION
Establece la extensión del nombre de archivo utilizada para las páginas web generadas por xymongen. Por
por defecto, se utiliza una extensión de ".html". Tenga en cuenta que debe especificar el "punto".

--informe [= COLUMNNAME]
Con esta opción, xymongen enviará un mensaje de estado con detalles de cuántos
se procesaron los hosts, cuántas páginas se generaron, los errores que ocurrieron
durante la carrera y algunas estadísticas de cronometraje. El nombre de columna predeterminado es "xymongen".

--htaccess [= htaccess-filename]
Cree archivos .htaccess cuando se creen nuevos directorios de páginas web. El contenido de
los archivos .htaccess están determinados por la variable de entorno XYMONHTACCESS (para
el directorio de nivel superior con xymon.html y nongreen.html); por el
Variable XYMONPAGEHTACCESS (para los directorios de nivel de página); y por el
Variable XYMONSUBPAGEHTACCESS para directorios de nivel de subpágina y subparente. los
El nombre de archivo de los archivos .htaccess predeterminado es ".htaccess" si no se proporciona un nombre de archivo con
esta opción. La variable XYMONHTACCESS se copia literalmente en el nivel superior
Archivo .htaccess. La variable XYMONPAGEHTACCESS puede contener un "% s" donde el nombre
de la página está insertada. La variable XYMONSUBPAGEHTACCESS puede contener dos "% s"
instancias: el primero se reemplaza con el nombre de la página, el segundo con el
nombre de subpágina.

--max-eventcount = N
Limite el registro de eventos en la página "Todos los que no son verdes" a solo N eventos. Predeterminado: 100.

--max-eventtime = N
Limite el registro de eventos en la página "Todo no verde" a los eventos que ocurrieron dentro del
pasados ​​N minutos. Predeterminado: 240.

--sin registro de eventos
Deshabilite el registro de eventos que se muestra normalmente en la página "Todo no verde"

--máx-recuento = N
Limite el registro de acuse de recibo en la página "Todos los que no son verdes" a solo N eventos. Defecto:
25.

--max-acktime = N
Limite el registro de acuse de recibo en la página "Todos los que no son verdes" a los reconocimientos que ocurrieron
en los últimos N minutos. Predeterminado: 240.

--no-acceso
Desactive el registro de acuse de recibo que se muestra normalmente en la página "Todo no verde".

--cricitcallog [= columna de registro crítica]
Esto genera un registro basado en texto de lo que se muestra en la página de estado critic.html,
y envía un mensaje de estado para el servidor Xymon en sí que refleja el color del
Página de estado crítico. Esto le permite rastrear cuándo han aparecido problemas en el
página de estado crítico. El archivo de registro se almacena en $ XYMONSERVERLOGS / criticstatus.log

--loadhostsfromxymond
En lugar de leer el archivo hosts.cfg, xymongen cargará hosts.cfg
configuración desde el demonio xymond. Esto elimina la necesidad de leer el
hosts.cfg, y si tiene xymond y xymongen ejecutándose en diferentes hosts, también
elimina la necesidad de copiar el archivo hosts.cfg entre sistemas. Tenga en cuenta que el
La opción "dispinclude" en hosts.cfg se ignora cuando esta opción está habilitada.

PÁGINA DISPOSICIÓN CAMPUS

Estas opciones afectan la forma en que las páginas web generadas por xymongen aparecen en el navegador.

--páginas-al final
Coloque enlaces de página y subpágina después de los hosts.

--páginas primero
Coloque los enlaces de página y subpágina antes de los hosts (predeterminado).

Estas dos opciones deciden si una página con enlaces a subpáginas y hosts tiene la
hosts o las subpáginas primero.

--subpagecolumns = N
Determina el número de columnas que se utilizan para los enlaces a páginas y subpáginas. El valor por defecto
es N = 1.

--maxrows = N
Los encabezados de columna de una página se muestran de forma predeterminada solo al principio de la página,
subpágina o grupo de hosts. Esta opción hace que los encabezados de columna se repitan para
cada N hosts mostrados.

--mostrar grupos vacíos

--no-showemptygroups
Cuando se crean grupos de hosts, muestre la tabla y los nombres de host incluso si hay
no hay pruebas presentes para ninguno de los hosts en cuestión. Utilice --no-showemptygroups para
esconder. (Predeterminado: sí)

--pagetitle-enlaces
Normalmente, solo los "puntos" de colores junto a una página o subpágina actúan como vínculos a la
página en sí. Con esta opción, el título de la página también se vinculará a la página.

--página-encabezados de texto
Utilice el texto de descripción de las etiquetas "página" o "subpágina" como encabezado de la
página, en lugar de "Páginas alojadas localmente" u otro encabezado estándar.

--no-subrayados-encabezados
Normalmente, los títulos de las páginas se subrayan mediante una etiqueta HTML de "regla horizontal". Esta
La opción desactiva el subrayado de los títulos.

--recentgifs [= MINUTES]
Use imágenes llamadas COLOR-recent.gif para las pruebas, donde el estado de la prueba ha cambiado
en las últimas 24 horas. Estos archivos GIF deben instalarse en el
$ XYMONHOME / www / gifs / directorio. De forma predeterminada, el umbral se establece en 24 horas, si
si lo desea de otra manera, también puede especificar el límite de tiempo. P.ej
"--recentgifs = 3h" mostrará los GIF recientes durante solo 3 horas después de un cambio de estado.

--ordenar-elementos-solo-grupo
En una directiva "solo de grupo" normal, puede especificar el orden en el que las pruebas
se muestran, de izquierda a derecha. Si prefiere que las pruebas se enumeren en
orden alfabético, utilice esta opción; la página generará "solo para grupos"
grupos como genera grupos normales y ordena las pruebas alfabéticamente.

--dialupskin = URL
Si desea mostrar visualmente que una prueba es una prueba de acceso telefónico, puede usar una
conjunto de iconos para verde / rojo / amarillo> / etc. imágenes especificando esta opción. los
El parámetro de URL especificado aquí anula la configuración normal de XYMONSKIN
variable de entorno, pero solo para pruebas de acceso telefónico.

--reverseskin = URL
Igual que "--dialupskin", pero para pruebas inversas (pruebas con '!' Delante).

--tooltips = [siempre, nunca, principal]
Determina qué páginas utilizan información sobre herramientas para mostrar la descripción del host (desde el
COMENTARIO en el anfitriones.cfg(5) expediente). Si se establece en hacerlo, la información sobre herramientas se utiliza en todos
páginas. Si se establece en nunca, la información sobre herramientas nunca se utiliza. Si se establece en principal, se utilizan información sobre herramientas
en las páginas principales, pero no en las páginas "Todos los que no son ecológicos" o "Sistemas críticos".

COLUMNA SELECCIÓN CAMPUS

Estas opciones afectan las columnas (pruebas) que se incluyen en las páginas web generadas por
ximongen.

--ignorecolumns = prueba [, prueba]
Xymongen ignorará por completo las columnas dadas al generar páginas web.
Se puede utilizar para generar informes en los que se eliminan algunas de las pruebas más ruidosas,
como "mensajes".

--críticos-rojos-solamente
Solo las columnas de estado rojas se incluirán en la página Crítico. Por defecto, el
La página crítica contendrá hosts con estado rojo, amarillo y claro.

--nongreen-colors = COLOR [, COLOR]
Define qué colores hacen que aparezca una prueba en la página de estado "Todos los que no son verdes".
El COLOR es rojo, amarillo o violeta. El valor predeterminado es incluir los tres.

--nongreen-ignorecolumns = prueba [, prueba]
Igual que --ignorecolumns, pero se aplica solo a los hosts de la página "Todos los que no son verdes".

--nongreen-ignorepurples
En desuso, utilice "--nongreen-colors" en su lugar.

--nongreen-ignoredialups
Ignore todos los hosts de acceso telefónico en la página "Todos los que no son verdes", incluido el registro de eventos.

--no-páginas
No genere las páginas normales (normalmente se usa para generar solo las páginas que no son verdes).
página).

--no-no verde
No genere la página "Todo lo que no sea verde".

--includecolumns = prueba [, prueba]
Incluya siempre estas columnas en la página "Todo lo que no sea verde" Incluirá ciertas columnas
en la página nongreen.html, independientemente de su color. Normalmente, nongreen.html suelta un
columna de prueba, si todas las pruebas son verdes. Esto se puede utilizar, por ejemplo, para tener siempre un enlace a
la columna de tendencias (con los gráficos RRD) de su página nongreen.html.

--eventignore = prueba [, prueba]
Ignore estas pruebas en la pantalla de registro de eventos "Todo no verde".

ESTADO PROPAGACIÓN CAMPUS

Estas opciones suprimen la propagación normal de un estado hacia arriba en la jerarquía de páginas.
Por lo tanto, puede tener una prueba con estado amarillo o rojo, pero aún tener la página completa en verde.
Es útil para pruebas que no necesitan generar una alarma, pero en las que aún desea saber
estado actual. Estas opciones establecen valores predeterminados globales para todos los hosts; puedes usar el NOPROPRED
y etiquetas NOPROPYELLOW en el anfitriones.cfg(5) archivo para aplicar límites similares en un host
base.

--nopropyellow = prueba [, prueba] o --noprop = prueba [, prueba]
Desactive la propagación del estado hacia arriba cuando esté AMARILLO. La opción "--noprop" está obsoleta
y no debe usarse.

--noproppurple = prueba [, prueba]
Desactive la propagación de estado ascendente cuando sea PÚRPURA.

--nopropred = prueba [, prueba]
Desactive la propagación del estado hacia arriba cuando esté ROJO o AMARILLO.

--nopropack = prueba [, prueba]
Desactive la propagación del estado hacia arriba cuando se haya reconocido el estado. Si quieres
para deshabilitar la propagación de todas las pruebas confirmadas, use "--nopropack = *".

VIOLETA ESTADO CAMPUS

Los estados morados se producen cuando se detiene la notificación del estado de una prueba. Un estado de prueba es válido para
tiempo limitado, normalmente 30 minutos, y después de este tiempo, la prueba se vuelve
púrpura.

--purplelog = NOMBRE DE ARCHIVO
Genere un archivo de registro de todos los mensajes de estado de color púrpura.

ALTERNOS CONJUNTO DE PÁGINAS CAMPUS

--pageset = PAGESETNAME
Cree páginas web para un conjunto de páginas alternativo al predeterminado. Ver la sección CONJUNTOS DE PÁGINAS
abajo.

--template = PLANTILLA
Utilice una plantilla alternativa para los archivos de encabezado y pie de página. Normalmente se utilizan juntos
la opción "--pageset"; consulte la sección CONJUNTOS DE PÁGINAS a continuación.

ALTERNOS SALIDA FORMATOS

--wml [= prueba1, prueba2, ...]
Esta opción hace que xymongen genere un conjunto de archivos de "tarjeta" WML que se pueden
accedido por un dispositivo WAP (teléfono celular, PDA, etc.) Los archivos generados contienen el
hosts que tienen un estado ROJO o AMARILLO en las pruebas especificadas. Esta opción puede definir
las pruebas predeterminadas a incluir: los valores predeterminados se pueden anular o modificar utilizando el
Etiquetas "WML:" o "NK:" en el anfitriones.cfg(5) expediente. Si no se especifican pruebas, todas las pruebas
Será incluido.

--nstab = NOMBRE DE ARCHIVO
Genere un archivo HTML adecuado para una entrada de la barra lateral de Netscape 6 / Mozilla. En realidad
permitir que sus usuarios obtengan dicha entrada de la barra lateral, necesita este código Javascript en
una página web (por ejemplo, puede incluirla en el archivo $ XYMONHOME / web / stdnormal_header):


<!--
function addNetscapePanel () {
if ((typeof window.sidebar == "object") &&
(typeof window.sidebar.addPanel == "función"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html"," ");
más
alert ("Barra lateral solo para Mozilla o Netscape 6+");
}
// ->


y luego puede incluir un enlace "Agregar esto a la barra lateral" usando esto como plantilla:

Agregar a la barra lateral

o si prefiere tener el botón "Agregar pestaña" estándar de Netscape, lo haría



<IMG SRC="/gifs/add-button.gif" ALTO=45 ANCHO=100
ALT = "[Agregar barra lateral]" STYLE = "borde: 0">


El "add-button.gif" está disponible en Netscape en
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Si NOMBRE DE ARCHIVO no comienza con una barra, el archivo de la barra lateral de Netscape se coloca en la
$ XYMONHOME / www / directorio.

--nslimit = COLOR
El color mínimo que se debe incluir en la barra lateral de Netscape; el valor predeterminado es "rojo", lo que significa
solo se incluyen alertas críticas. Si también desea incluir advertencias, utilice
"--nslimit = amarillo".

--rss Genera un flujo de entrega de contenido RSS / RDF de sus alertas de Xymon. Este formato de salida
se puede incrustar dinámicamente en otras páginas web, al igual que las fuentes de noticias en vivo a menudo
visto en sitios web. Se generarán dos archivos RSS, uno refleja el "Todos los no
verde ", la otra refleja la página" Crítica ". Estarán en la
Archivos "nongreen.rss" y "critic.rss", respectivamente. Además, un archivo RSS
se generará para cada página y / o subpágina que enumere los hosts presentes en ese
página o subpágina.
El parámetro FILENAME previamente permitido en la opción --rss ahora está obsoleto.
Para obtener más información acerca de las fuentes de contenido RSS / RDF, consulte
http://www.syndic8.com/.

--rssextension = .EXTENSION
Establece la extensión del nombre de archivo utilizada para los archivos RSS generados por xymongen. Por
por defecto, se utiliza una extensión de ".rss". Tenga en cuenta que debe especificar el "punto".

--rssversion = {0.91 | 0.92 | 1.0 | 2.0}
El formato de salida deseado de la fuente RSS / RDF. La versión 0.91 parece ser la más
formato de uso común, y es el predeterminado si se omite esta opción.

--rsslimit = COLOR
El color mínimo que se debe incluir en la fuente RSS; el valor predeterminado es "rojo", es decir, solo
Se incluyen alertas críticas. Si también desea incluir advertencias, use
"--rsslimit = amarillo".

CAMPUS USADO BY CGI FRENTE TERMINA

--reportopts = INICIO: FIN: DINÁMICO: ESTILO
Invoque xymongen en el modo de generación de informes. Normalmente lo utilizan los
informe.cgi(1) Script CGI, pero también se puede utilizar directamente al generar previamente
informes. El parámetro START es la hora de inicio del informe en Unix time_t
formato (segundos desde el 1 de enero de 1970 a las 00:00 UTC); END es la hora de finalización del informe;
DINÁMICO es 0 para un informe prediseñado y 1 para un informe dinámico (en línea); ESTILO es
"crítico" para incluir solo eventos críticos (rojo), "no" para incluir todos los que no son verdes
eventos y "todos" para incluir todos los eventos.

--csv = NOMBRE DE ARCHIVO
Usado junto con --reportopts, esto hace que xymongen genere una disponibilidad
informe en forma de archivo de valores separados por comas (CSV). Este formato es comúnmente
se utiliza para importar en hojas de cálculo para su posterior procesamiento.
El archivo CSV incluye marcas de tiempo de Unix. Para mostrar estos como tiempos legibles por humanos en
Excel, la fórmula = C2 / 86400 + DATEVALUE (1-ene-1970) (si tiene la marca de tiempo de Unix
en la celda C2). La celda de resultado debe tener el formato de fecha / hora
campo. Tenga en cuenta que las marcas de tiempo están en UTC, por lo que es posible que también deba manejar local
problemas de zona horaria y horario de verano.

--csvdelim = DELIMITER
De forma predeterminada, se utiliza una coma para delimitar campos en la salida CSV. Algunos no ingleses
Las hojas de cálculo utilizan un delimitador diferente, normalmente un punto y coma. Para generar un CSV
archivo con el delimitador adecuado, puede utilizar esta opción para establecer el carácter utilizado
como delimitador. Por ejemplo, "--csvdelim =;" - tenga en cuenta que esto normalmente debería ser doble
comillas, para evitar que el shell de Unix interprete el carácter delimitador como un
delimitador de línea de comandos.

--snapshot = HORA
Genere una instantánea de las páginas de Xymon, tal como aparecieron en TIME. El TIEMPO se da como
segundos desde el 1 de enero de 1970 a las 00:00 UTC. Usado normalmente a través del instantánea.cgi(1) CGI
guión.

DEPURACIÓN CAMPUS

--depurar
Hace que xymongen descargue grandes cantidades de salida de depuración a stdout, si fuera
compilado con el -DDEBUG habilitado. Al informar un problema con xymongen, por favor
intente reproducir el problema y proporcione el resultado de ejecutar xymongen con esto
.

--momento
Volcar información sobre el tiempo dedicado por varias partes de xymongen a stdout. Esta
es útil para ver qué parte del procesamiento es responsable del tiempo de ejecución de
ximongen.
Nota: esta información también se proporciona en la salida enviada a la pantalla Xymon
al usar la opción "--report".

EDIFICIO ALTERNOS CONJUNTOS DE PÁGINAS

Con la versión 1.4 de xymongen viene la posibilidad de generar múltiples conjuntos de páginas desde
los mismos datos.
Suponga que tiene dos grupos de personas mirando las páginas web de Xymon. El grupo A quiere
tener los hosts agrupados por el cliente al que pertenecen. Así es como ha configurado Xymon:
el conjunto de páginas predeterminado. Ahora el grupo B quiere tener los hosts agrupados por sistema operativo -
llamémoslo el conjunto "os". Luego, agregaría el diseño de página a hosts.cfg de esta manera:

ospage gana Microsoft Windows
ossubpágina win-nt4 MS Windows NT 4
Servidores de archivos osgroup NT4
servidores de correo osgroup NT4
ossubpágina win-xp MS Windows XP
ospage Unix Unix
ossubpágina unix-sun Solaris
ossubpágina unix-linux Linux

Esto define un conjunto de páginas con una página de nivel superior (la página xymon.html), dos páginas
enlazado desde xymon.html (win.html y unix.html), y desde, por ejemplo, la página win.html hay
subpáginas win-nt4.html y win-xp.html
La sintaxis es idéntica a las directivas normales de "página" y "subpágina" en hosts.cfg, pero
la directiva tiene como prefijo el nombre del conjunto de páginas. No coloque ningún host entre la página
y directivas de subpágina: simplemente agregue todas las directivas en la parte superior del archivo hosts.cfg.
Entonces, ¿cómo se agregan hosts a las páginas? Sencillo: simplemente coloque una etiqueta "OS: win-xp" en el host
línea de definición. El "SO" debe ser el mismo que el prefijo utilizado para los nombres de los conjuntos de páginas, pero en
mayúsculas. El "win-xp" debe coincidir con una de las páginas o subpáginas definidas en este
conjunto de páginas. P.ej

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

Si desea que el host aparezca dentro de un grupo definido en esa página, debe identificar el
agrupar por número, comenzando en 1. Por ejemplo, para poner un host dentro del grupo "NT4 Mail servers" en
En el ejemplo anterior, use "OS: win-nt4,2" (el segundo grupo en la página "win-nt4").
Si desea que el host se muestre en la página principal en lugar de en una subpágina, use "OS: *".

Todo esto solo define el diseño del nuevo conjunto de páginas. Para generarlo, debes ejecutar
xymongen una vez para cada conjunto de páginas que defina, es decir, cree un script de extensión como este:

#!/ Bin / sh

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

Guárdelo en $ XYMONHOME / ext / os-display.sh y configúrelo para que se ejecute como una extensión Xymon;
esto significa agregar una sección adicional a tasks.cfg para ejecutarlo.

Esto genera las páginas. Hay algunas opciones importantes que se utilizan aquí:
* XYMONWEB = "/ xymon / os" variable de entorno y la
La opción "$ XYMONHOME / www / os /" funciona en conjunto y coloca la
nuevos archivos HTML de conjuntos de páginas en un subdirectorio fuera de lo normal
Xymon webroot. Si normalmente accede a las páginas de Xymon como
"http://xymon.acme.com/xymon/", luego accederá
el nuevo conjunto de páginas como "http://xymon.acme.com/xymon/os/"
NB: El directorio dado como XYMONWEB debe contener un símbolo
enlace al directorio $ XYMONHOME / www / html /, o enlaces a
los mensajes de estado individuales no funcionarán. Enlaces similares
debe hacerse para los gifs /, ayuda / y notas /
directorios.
* "--pageset = os" le dice a xymongen que estructura las páginas web
utilizando el diseño "os", en lugar del diseño predeterminado.
* "--template = os" le dice a xymongen que use un conjunto diferente de
plantillas de encabezado y pie de página. Normalmente xymongen usa el
plantilla estándar en $ XYMONHOME / web / stdnormal_header y
... / stdnormal_footer - con esta opción, usará en su lugar
los archivos "os_header" y "os_footer" del
$ XYMONHOME / web / directorio. Esto le permite personalizar
encabezados y pies de página para cada conjunto de páginas. Si solo quieres
para usar la plantilla normal, puede omitir esta opción.

USO XYMONGEN PARA REPORTAJES

Los informes xymongen se implementan a través de reemplazos directos para el Xymon estándar
scripts de informes (report.sh y reportlog.sh) instalados en sus servidores web cgi-bin
directorio.

Estos dos scripts de shell han sido reemplazados por dos scripts de shell muy pequeños, que simplemente
configurar las variables de entorno de Xymon e invocar el informe.cgi(1) or reportlog.cgi(1)
scripts en $ XYMONHOME / bin /

Puede utilizar las opciones de la línea de comandos de xymongen al generar informes, por ejemplo, para excluir ciertos
tipos de pruebas (por ejemplo, "--ignorecolumns = msgs") de los informes, para especificar el nombre del
columnas de tendencias e información que no deben estar en el informe, o para dar formato al informe
de forma diferente (por ejemplo, "--subpagecolumns = 2"). Si desea que se utilicen determinadas opciones cuando
informe se genera desde la interfaz web, coloque estas opciones en su
$ XYMONHOME / etc / xymonserver.cfg en la variable de entorno XYMONGENREPOPTS.

Los archivos de informes generados por xymongen se almacenan en directorios individuales (uno por
informe) debajo del directorio $ XYMONHOME / www / rep /. Estos deben limpiarse automáticamente
- a medida que se generan nuevos informes, los antiguos se eliminan.

Después de la instalación, intente generar un informe. Probablemente verá que los enlaces en el
la esquina superior izquierda (a ack.html, nongreen.html, etc.) ya no funciona. Para solucionar estos, cambie
su archivo $ XYMONHOME / web / repnormal_header, por lo que estos enlaces no se refieren a "& XYMONWEB" sino
al prefijo de URL normal para sus páginas Xymon.

SLA PRESENTACIÓN DE INFORMES

Los informes xymongen permiten la generación de un verdadero SLA (Acuerdo de nivel de servicio)
informes, también para períodos de servicio que no son 24x7. Esto se habilita definiendo un
Etiqueta "REPORTTIME: timespec" para que los hosts definan el período de servicio y, opcionalmente, una
Etiqueta "WARNPCT: level" para definir la disponibilidad acordada.

Nota: ver anfitriones.cfg(5) para conocer la sintaxis exacta de estas opciones.

"REPORTTIME: timespec" especifica la hora del día en la que se espera que el servicio esté activo y
corriendo. De forma predeterminada, esto es 24 horas al día, todos los días de la semana. Si su SLA solo cubre
De lunes a viernes de 7:8 a. M. A 0700:2000 p. M., Lo define como "REPORTTIME = W: XNUMX: XNUMX" y el generador de informes
luego calculará tanto la disponibilidad normal 24x7 como también una "disponibilidad SLA" que
solo tiene en cuenta el estado del host durante el período de SLA.

El parámetro DOWNTIME: timespec afecta el cálculo de disponibilidad del SLA. Si un apagón
ocurre durante el tiempo definido como posible "DOWNTIME", luego la falla se informa con un
estado de "azul". (Se usa el mismo color si "deshabilita" y luego aloja usando el Xymon
función "deshabilitar"). El momento en que el estado de la prueba es "azul" no se incluye en el SLA
cálculo, ni en la cantidad de tiempo en que el host se considera inactivo, ni en el
cantidad total de tiempo que cubre el informe. Así que el tiempo "azul" es efectivamente ignorado por el
Cálculo de disponibilidad de SLA, lo que le permite tener un tiempo de inactividad planificado sin afectar el
informó la disponibilidad de SLA.

Ejemplo: un host tiene "DOWNTIME: *: 0700: 0730 REPORTTIME = W: 0600: 2200" porque se reinicia
todos los días entre las 7 y las 7.30, pero el servicio debe estar disponible de 6 a 10 horas. Para
el día del informe, bajó de las 7:10 a. m. a las 7:15 a. m. (el reinicio planeado), pero también
de 9:53 a 10:15 h. Entonces los eventos del día son:

0700: verde durante 10 minutos (600 segundos)
0710: azul durante 5 minutos (300 segundos)
0715: verde durante 14 horas 38 minutos (52680 segundos)
2153: rojo durante 22 minutos (1320 segundos)
2215: verde

El servicio está disponible por 600 + 52680 = 53280 segundos. Está abajo (rojo) durante 420 segundos
(el tiempo desde las 21:53 hasta las 22:00 cuando finaliza el período de SLA). El tiempo total incluido en el
el informe es de 15 horas (de 7 a. m. a 10 p. m.) excepto los 5 minutos en azul = 53700 segundos. Entonces el SLA
la disponibilidad es 53280/53700 = 99,22%

La etiqueta "WARNPCT: level" se admite en el archivo hosts.cfg, para establecer la disponibilidad
umbral sobre una base de host por host. Este umbral determina si una prueba se informa como
verde, amarillo o rojo en los informes. Se puede establecer un valor predeterminado para todos los hosts con via
la variable de entorno XYMONREPWARN, pero anulada por esta etiqueta. El nivel se da como
un porcentaje, por ejemplo, "WARNPCT: 98.5"

Pregenerado REPORTAJES

Normalmente, xymongen produce informes que se vinculan a páginas web generadas dinámicamente con el
estado detallado de una prueba (a través del script CGI reportlog.sh).

Es posible que xymongen produzca un informe sin estos enlaces dinámicos, por lo que
el informe se puede exportar a otro servidor. También puede ser útil generar previamente el
informes, para reducir la carga haciendo que varios usuarios generen los mismos informes.

Para hacer esto, debe ejecutar xymongen con la opción "--reportopts" para seleccionar la hora
intervalo que cubre el informe, el estilo de informe (crítico, no verde o todos los eventos),
y solicitar que no se generen páginas dinámicas.

La sintaxis es:

xymongen --reportopts = hora de inicio: hora de finalización: nodynamic: estilo

"starttime" y "endtime" se especifican como valores de Unix time_t, es decir, segundos desde el 1 de enero
1970 00:00 GMT. Afortunadamente, esto se puede calcular fácilmente con la utilidad de fecha GNU si
utilice la opción de salida "+% s". Si no tiene la utilidad de fecha GNU, retírela
de www.gnu.org; o puede utilizar la utilidad "etime" para el mismo propósito, que es
disponible en el archivo en www.deadcat.net.

"nodinámico" es 0 (para páginas dinámicas, el valor predeterminado) o 1 (para no dinámico, es decir, pre
generado, páginas).

"estilo" es "crítico" (incluye eventos críticos, es decir, rojos solamente), "no" (incluye todos
eventos no verdes), o "todos" (incluir todos los eventos).

Se pueden utilizar otras opciones de xymongen, por ejemplo, "--ignorecolumns" si desea excluir determinadas
pruebas del informe.

Normalmente también necesitará especificar la variable de entorno XYMONWEB (debe coincidir
la URL base desde donde se podrá acceder al informe) y un directorio de salida
donde se guardan los archivos del informe. Si especifica XYMONWEB, probablemente también debería
defina las variables de entorno XYMONHELPSKIN y XYMONNOTESSKIN. Estos deben apuntar a
la URL donde se encuentran los archivos de ayuda y notas de Xymon; si no están definidos, el
Los enlaces a archivos de ayuda y notas apuntarán dentro del directorio del informe y probablemente
no trabajo.

Entonces, una invocación típica de xymongen para un informe estático sería:

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

La configuración "XYMONWEB" significa que el informe estará disponible con una URL de
"http://www.server.com/reports/xymon/daily/2003/06/22". El informe contiene
enlaces que utilizan esta URL, por lo que no se puede mover fácilmente a otra ubicación.

El último parámetro es el directorio físico correspondiente en su servidor web que coincide con el
URL de XYMONWEB. Por supuesto, puede crear los archivos de informe en cualquier lugar que desee, tal vez en
otra máquina, y luego muévelos al servidor web más adelante.

Tenga en cuenta cómo el datos(1) La utilidad se utiliza para calcular los parámetros de hora de inicio y finalización.

MEDIO AMBIENTE VARIABLES

FILTRO DE PLACA
Filtro utilizado para seleccionar qué hosts / pruebas se incluyen en las páginas web, filtrando
los datos recuperados de xymond vi el comando xymondboard. Ver ximon(1) para conocer más detalles.
en la sintaxis del filtro. De forma predeterminada, no se realiza ningún filtrado.

Utilice xymongen en línea utilizando los servicios de onworks.net