xymon: en línea en la nube

PROGRAMA:

NOMBRE

xymon - programa de comunicación del cliente Xymon

SINOPSIS

ximon [opciones] RECIPIENTE mensaje

DESCRIPCIÓN

ximon(1) es el programa cliente que se utiliza para comunicarse con un servidor Xymon. Es frecuentemente
utilizado por los sistemas cliente Xymon para enviar mensajes de estado y alertas de buscapersonas en pruebas locales.

En Xymon, el programa xymon también se utiliza con fines administrativos, por ejemplo, para cambiar el nombre o
eliminar hosts, o para deshabilitar hosts que están inactivos durante períodos de tiempo más prolongados.

CAMPUS Y PARÁMETROS

--depurar
Habilite la depuración. Esto imprime detalles sobre cómo la conexión al Xymon
se está estableciendo el servidor.

--proxy =http://PROXYSERVER:PUERTO PROXY/
Cuando envíe los mensajes de estado a través de HTTP, utilice este servidor como un proxy HTTP en su lugar
de conectarse directamente al servidor Xymon.

--timeout = N
Especifica el tiempo de espera para conectarse al servidor Xymon, en segundos. El valor por defecto
son 5 segundos.

--respuesta
La utilidad xymon normalmente sabe cuándo esperar una respuesta del servidor, por lo que
no se requiere la opción. Sin embargo, causará que cualquier respuesta del servidor sea
desplegado.

--unir
Fusionar el texto del mensaje de la línea de comando con los datos proporcionados en la entrada estándar, y
envíe el resultado al servidor Xymon. El texto del mensaje proporcionado en la línea de comando
se convierte en la primera línea del mensaje combinado.

RECIPIENTE
El RECIPIENTE El parámetro define qué servidor recibe el mensaje. Si el RECIPIENTE es
dado como "0.0.0.0", el mensaje se envía a todos los servidores enumerados en el
Variable de entorno XYMSERVERS.

Normalmente, un cliente utilizará "$ XYMSRV" para el RECIPIENTE parámetro, ya que este es
definido para que los scripts del cliente contengan automáticamente el valor correcto.

El RECIPIENTE El parámetro puede ser una URL para un servidor web que tiene xymoncgimsg.cgi
o un script similar instalado. Esto canaliza los mensajes Xymon al servidor Xymon.
utilizando el protocolo HTTP estándar. los xymoncgimsg.cgi(8) Herramienta CGI (incluida en Xymon)
debe estar instalado en el servidor web para que funcione el transporte HTTP.

MENSAJE
El mensaje El parámetro es el mensaje que se enviará al servidor Xymon.
Los mensajes deben ir entre comillas, pero al hacerlo pueden ocupar varias líneas.
El tamaño máximo de un mensaje se define por la longitud máxima permitida de su
línea de comandos de shell, y suele ser de 8 a 32 KB.

Si necesita enviar mensajes de estado más largos, puede especificar "@" como mensaje:
xymon leerá el mensaje de estado de su stdin.

XYMON MENSAJE SINTAXIS

Esta sección enumera los mensajes más utilizados en el protocolo Xymon.

Cada mensaje debe comenzar con uno de los comandos de Xymon. Donde se especifica un HOSTNAME,
debe tener cualquier punto en el nombre de host cambiado a comas si la configuración de Xymon FQDN está habilitada
(que es el predeterminado). Por lo tanto, el host "www.foo.com", por ejemplo, informaría como
"www, foo, com".

estado [+ LIFETIME] [/ group: GROUP] HOSTNAME.TESTNAME COLOR
Esto envía un mensaje de estado para una sola prueba (columna) en un solo host.
TESTNAME es el nombre de la columna donde se mostrará esta prueba; cualquier nombre es válido
excepto que el uso de puntos en el nombre de la prueba no funcionará. El COLOR debe ser uno de los
colores válidos: "verde", "amarillo", "rojo" o "claro". Los colores "azul" y "violeta"
- aunque son colores válidos - no deben enviarse en un mensaje de estado, ya que son
manejado especialmente por el servidor Xymon. Como caso especial (para apoyar a personas mayores
clientes), "cliente" se puede utilizar como el nombre del color. Esto hace que el estado
mensaje para ser manejado por Xymon como un mensaje de datos de "cliente", y el TESTNAME
El parámetro se utiliza como "ID de colector".
El "texto adicional" normalmente incluye una marca de tiempo local y un resumen de la prueba.
resultado en la primera línea. Las líneas que siguen a la primera son de forma libre y pueden
Incluya cualquier información que pueda ser útil para diagnosticar el problema que se informa.
LIFETIME define cuánto tiempo es válido este estado después de ser recibido por el
Servidor Xymon. El valor predeterminado es 30 minutos, pero puede establecer el período que desee. P.ej
para una prueba personalizada que se ejecuta una vez por hora, querrá establecer esto en al menos 60
minutos; de lo contrario, el estado cambiará a morado después de 30 minutos. Es una buena idea
para establecer el LIFETIME en un poco más largo que el intervalo entre sus pruebas, para
Tenga en cuenta las variaciones en el tiempo que tarda la prueba en completarse. La VIDA está en
minutos, a menos que agregue una "h" (horas), "d" (días) o "w" (semanas) inmediatamente después
el número, por ejemplo, "estado + 5h" para un estado que es válido durante 5 horas.
La opción GRUPO se utiliza para dirigir las alertas del estado a un grupo específico. Eso
se utiliza actualmente para el estado generado a partir de los datos de los clientes Xymon, por ejemplo, para dirigir
alertas para un estado "procs" a diferentes personas, dependiendo exactamente de qué proceso
esta abajo.

notificar a HOSTNAME.TESTNAME
Esto desencadena un mensaje informativo que se enviará a quienes reciben alertas para
esta combinación HOSTNAME + TESTNAME, de acuerdo con las reglas definidas en alert.cfg(5)
Esto es utilizado por el enadis.cgi(1) herramienta para notificar a las personas sobre la desactivación de hosts
o habilitado, pero también puede servir como una forma general de notificar a los administradores del servidor.

datos HOSTNAME.DATANAME
El mensaje "datos" permite que las herramientas envíen datos sobre un host, sin que aparezca como
una columna en las páginas web de Xymon. Esto se utiliza, por ejemplo, para informar estadísticas.
sobre un host, por ejemplo, datos vmstat, que no representan en sí mismos algo que
tiene una identidad roja, amarilla o verde. Lo utilizan los módulos de alimentación inferior RRD, entre
otros. En Xymon, los mensajes de datos son procesados ​​por defecto solo por el xymond_rrd(8)
módulo. Si desea manejar mensajes de datos usando una aplicación externa, puede
quiero habilitar el xymond_filestore(8) módulo para mensajes de datos, para almacenar datos-
mensajes en un formato compatible con el funcionamiento del demonio de Big Brother.

inhabilitar HOSTNAME.TESTNAME DURATION
Desactiva una prueba específica durante DURATION minutos. Esto provocará que el estado de este
prueba para que aparezca como "azul" en el servidor Xymon, y no hay alertas para este host / prueba
se generará. Si DURATION se da como un número seguido de s / m / h / d, es
interpretado en segundos / minutos / horas / días respectivamente. Para deshabilitar un
prueba hasta que esté bien, usa "-1" como DURACIÓN. Para deshabilitar todas las pruebas para un
host, utilice un asterisco "*" para TESTNAME.

habilitar HOSTNAME.TESTNAME
Vuelve a habilitar una prueba que se había deshabilitado.

consulta HOSTNAME.TESTNAME
Consulte al servidor Xymon para conocer el estado más reciente informado para esta prueba en particular. Si
se conoce el estado del host / prueba, la respuesta es la primera línea del informe de estado
- el color actual será la primera palabra de la línea. Líneas de texto adicionales
que puede estar presente en el mensaje de estado no se puede recuperar.
Esto permite que cualquier cliente Xymon determine el estado de una prueba en particular, ya sea
es uno que pertenece al host donde se está ejecutando el cliente, algún otro host, o
tal vez el resultado de una prueba combinada de múltiples hosts administrados por estado combinado(1)
Por lo general, esto será útil para los scripts de extensión del cliente Xymon, que necesitan
determinar el estado de otros hosts, por ejemplo, para decidir si un
Se debe iniciar una acción de recuperación.

config NOMBRE DE ARCHIVO
Recupere uno de los archivos de configuración de Xymon del servidor. Este comando permite
un cliente para extraer archivos del directorio $ XYMONHOME / etc / en el servidor, lo que permite
para actualizaciones semiautomáticas de la configuración del cliente. Desde la configuración
Los archivos están diseñados para tener un archivo común para la configuración de todos los hosts en el
sistema - y esta es de hecho la forma recomendada de configurar sus clientes - este
facilita la sincronización de los archivos de configuración.

soltar HOSTNAME
Elimina todos los datos almacenados sobre el host HOSTNAME. Se supone que tienes
ya eliminó el host del archivo de configuración hosts.cfg.

soltar HOSTNAME TESTNAME
Eliminar datos sobre una sola prueba (columna).

renombrar OLDHOSTNAME NEWHOSTNAME
Cambie el nombre de todos los datos de un host al que se le haya cambiado el nombre. Deberías hacer esto después
cambiando el nombre de host en el archivo de configuración hosts.cfg.

renombrar HOSTNAME OLDTESTNAME NEWTESTNAME
Cambiar el nombre de los datos de una sola prueba (columna).

xymondlog NOMBRE DE HOST. NOMBRE DE PRUEBA
Recupere el registro de estado de Xymon para una sola prueba. La primera línea de la respuesta
contiene una serie de campos separados por un signo de tubería:

hostname El nombre del anfitrión

nombre de la prueba El nombre de la prueba

Color Color de estado (verde, amarillo, rojo, azul, claro, morado)

banderas de prueba Para las pruebas de red, las banderas que indican detalles sobre la prueba (utilizadas por
ximógeno).

ultimo cambio Marca de tiempo de Unix cuando el color de estado cambió por última vez.

tiempo de registro Marca de tiempo de Unix cuando se recibió el mensaje de registro.

tiempo valido Marca de tiempo de Unix cuando el mensaje de registro ya no es válido (se vuelve púrpura en
esta vez).

tiempo de espera Una marca de tiempo -1 o Unix cuando expira un reconocimiento activo.

tiempo de desactivación O bien -1 o marca de tiempo Unix cuando el estado ya no está deshabilitado.

remitente Dirección IP de donde se recibió el estado.

galleta -1 o el valor de la cookie utilizado para reconocer una alerta.

acuse de recibo Vacío o el mensaje de confirmación enviado cuando se reconoció el estado.
Las líneas nuevas, los letreros de tubería y las barras invertidas se escapan con una barra invertida, estilo C.

desestimar Vacío o el mensaje enviado cuando el estado estaba deshabilitado. Newline, señales de tubería
y las barras invertidas se escapan con una barra invertida, estilo C.

Después de la primera línea viene el registro de estado completo en formato de texto sin formato.

xymondxlog NOMBRE DE HOST. NOMBRE DE PRUEBA
Recupera una cadena XML que contiene el registro de estado como con el comando "xymondlog".

xymondboard [CRITERIA] [fields = FIELDLIST]
Recupera un resumen del estado de todas las pruebas conocidas disponibles para el demonio Xymon.

De forma predeterminada, si no se proporciona ningún CRITERIO, devuelve una línea para todos los estados
mensajes que se encuentran en Xymon. Puede filtrar la respuesta por selección específica
página, host, prueba, color o varios otros campos. El PAGEPATH, NETWORK, HOSTNAME,
Los parámetros TESTNAME y * MSG se interpretan como expresiones regulares compatibles con Perl;
el parámetro COLOR acepta varios colores separados por comas; los valores * TIME
aceptar marcas de tiempo de época de Unix. Otras variables identificadas en xymon-xmh(5) también
ser usado.

Debido a que la filtración del host se realiza antes de la filtración de prueba, es más eficiente (con
conjuntos de datos muy grandes) para usar PAGEPATH, HOSTNAME, NETWORK y otros filtros XMH_
cuando sea posible, antes de filtrar globalmente con COLOR, * MSG, * TIME o TESTNAME.

Puede filtrar, por ejemplo, tanto un nombre de host como un nombre de prueba.

page = PAGEPATH Incluya solo las pruebas de los hosts que se encuentran en la página PAGEPATH en el
archivo hosts.cfg.

net = RED Incluya solo pruebas de hosts con esta etiqueta NET:

ip = IPDirección Incluya solo pruebas de hosts con esta dirección IP. Esta es una expresión regular,
no CIDR.

host = HOSTNAME Incluir solo pruebas del host HOSTNAME

test = TESTNAME Incluya solo pruebas con el nombre de prueba TESTNAME

color = COLORNAME Incluya solo pruebas en las que el color de estado sea COLORNAME

tag = NOMBRE DE ETIQUETA Incluya solo hosts con una determinada etiqueta especificada en el anfitriones.cfg(5)
línea. Tenga en cuenta que aquí solo se incluyen los elementos conocidos por los componentes xymon; arbitrario
el texto no está incluido

Cadena_XMH = VALOR Incluya solo hosts con un xymon-xmh(5) variable que coincide con esto
propuesta de

Filtrado avanzado

msg = MENSAJE Incluya solo pruebas con MESSAGE de contenido completo que coincida. Utilice "\ s" para
espacios de escape (u otras cadenas de PCRE)

ackmsg = MENSAJE Incluya solo pruebas con MENSAJE de reconocimiento (s). Utilice "\ s" para
espacios de escape (u otras cadenas de PCRE)

dismsg = MENSAJE Incluya solo las pruebas que se hayan inhabilitado con cadenas que coincidan
MENSAJE. Utilice "\ s" para escapar de los espacios (u otras cadenas de PCRE). (Es más eficiente
para emparejar esto con color = blue.)

Filtros de marca de tiempo

Ciertos campos (explicados a continuación) se pueden filtrar con marcas de tiempo Unix y con el
siguientes desigualdades:> => <= <=! =

Estos filtros son: lastchange, logtime, validtime, acktime, disabletime

La respuesta es una línea para cada estado que coincida con los CRITERIOS o todos los estados.
si no se especifica ningún criterio. La línea se compone de varios campos, separados
por una señal de tubería. Puede seleccionar qué campos recuperar enumerándolos en el
LISTA DE CAMPO. Están disponibles los siguientes campos:

hostname El nombre del anfitrión

nombre de la prueba El nombre de la prueba

Color Color de estado (verde, amarillo, rojo, azul, claro, morado)

banderas Para las pruebas de red, las banderas que indican detalles sobre la prueba (utilizadas por
ximógeno).

ultimo cambio Marca de tiempo de Unix cuando el color de estado cambió por última vez.

tiempo de registro Marca de tiempo de Unix cuando se recibió el mensaje de registro.

tiempo valido Marca de tiempo de Unix cuando el mensaje de registro ya no es válido (se vuelve púrpura en
esta vez).

tiempo de espera Una marca de tiempo -1 o Unix cuando expira un reconocimiento activo.

tiempo de desactivación O bien -1 o marca de tiempo Unix cuando el estado ya no está deshabilitado.

remitente Dirección IP de donde se recibió el estado.

galleta -1 o el valor de la cookie utilizado para reconocer una alerta.

line1 Primera línea del registro de estado.

acuse de recibo Vacío (si no hay ningún acuse de recibo activo) o el texto del acuse de recibo
mensaje.

desestimar Vacío (si el estado está habilitado actualmente), o el texto de la inhabilitación
mensaje.

MSG El texto completo del mensaje de estado actual.

cliente Muestra "Y" si hay datos del cliente disponibles, "N" si no.

selloclnt Marca de tiempo cuando se recibió el último mensaje del cliente, en Unix "epoch"
formato.

acklist Lista de reconocimientos actuales para una prueba. Esta es una cadena de texto con
varios campos, delimitados por dos puntos. Hay 5 campos: Marca de tiempo para
cuándo se generó el ack y cuándo caduca; el "nivel de acuse"; el usuario que
envió el acuse de recibo; y el texto de reconocimiento.

solapainfo Dice si el estado está cambiando. 5 campos, delimitados por "/": un "0" si el
el estado no es aleteo y "1" si es aleteo; marca de tiempo cuando el estado más reciente
se registró el cambio y cuándo se registró el primer cambio de estado; y los dos
colores entre los que se agita el estado.

estadísticas Número de cambios de estado que se han registrado para este estado desde xymond
empezó.

modificadores Enumera todos los modificadores activos para este estado (es decir, las actualizaciones enviadas mediante un
comando "modificar").

XMH_ * Las etiquetas XMH se refieren a Xymon anfitriones.cfg(5) ajustes de configuración. Una completa
La lista de estos se puede encontrar en el xymon-xmh(5) página de manual.

Los campos ackmsg, dismsg y msg tienen ciertos caracteres codificados: Newline es "\ n",
TAB es "\ t", retorno de carro es "\ r", un signo de tubería es "\ p" y una barra invertida es "\\".

Si se omite el parámetro "campos", un conjunto predeterminado de
hostname, testname, color, flags, lastchange, logtime, validtime, acktime, disabletime, remitente, cookie, línea1
se utiliza.

xymondxboard
Recupera una cadena XML con el resumen de todos los registros de estado como para el
comando "xymondboard".

hostinfo [CRITERIOS]
Recupera la configuración actual de un host (es decir, el anfitriones.cfg(5) definición).
CRITERIOS selecciona qué host (s) informar, y es idéntico a los CRITERIOS en el
comando xymondboard.

La respuesta es una línea para cada host que coincida con los CRITERIOS, o todos los hosts si
no se especifica ningún criterio. La línea se compone de varios campos, separados por
una señal de tubería. Los dos primeros campos siempre serán el nombre de host y la dirección IP.
Los campos restantes, si los hay, son las etiquetas hosts.cfg sin ningún orden en particular.

descargar FILENAME
Descargue un archivo del directorio de descargas del servidor Xymon.

cliente [/ COLLECTORID] HOSTNAME.OSTYPE [HOSTCLASS]
Se utiliza para enviar un mensaje de "cliente" al servidor Xymon. Se generan mensajes de cliente
por el cliente Xymon; cuando se envían al servidor Xymon, se comparan con el
reglas en el análisis.cfg(5) archivo de configuración, y se generan mensajes de estado
para las pruebas del lado del cliente. El COLLECTORID se utiliza al enviar datos de clientes que
son adiciones a los datos estándar del cliente. Los datos se concatenarán con el
datos normales del cliente.

clientlog HOSTNAME [section = SECTIONNAME [, SECTIONNAME ...]]
Recupera el mensaje de cliente sin procesar actual enviado por última vez por HOSTNAME. El opcional
El filtro "sección" se utiliza para seleccionar secciones específicas de los datos del cliente.

ping Intenta ponerse en contacto con el servidor Xymon. Si tiene éxito, el ID de la versión del servidor Xymon es
informó.

cliente de extracción
Este mensaje se utiliza cuando se obtienen datos del cliente mediante el mecanismo de "extracción" implementado
by xmonfetch(8) y caché de mensajes(8) para clientes que no pueden conectarse directamente al
Servidor Xymon.

lista fantasma
Informar una lista de fantasma clientes vistos por el servidor Xymon. Los fantasmas son sistemas que
reportar datos al servidor Xymon, pero no están listados en el archivo hosts.cfg.

programar [COMANDO TIMESTAMP]
Programa un comando enviado al servidor Xymon para su ejecución en un momento posterior. P.ej
se utiliza para programar la desactivación de un host o servicio en algún momento en el futuro. MANDO
es un comando completo de Xymon como los que se enumeran anteriormente. TIMESTAMP es el Unix
época tiempo en que se ejecutará el comando.
Si no se proporcionan parámetros, las tareas programadas actualmente se enumeran en el
respuesta. La respuesta es una línea por comando programado, con la identificación del trabajo, el
hora en que se ejecutará el comando, la dirección IP desde la que se envió,
y la cadena de comandos completa.
Para cancelar un comando previamente programado, "calendario cancelar IDENTIFICACIÓN DEL TRABAJO" puede ser usado.
JOBID es un número proporcionado como primer elemento en la salida de la lista de programación.

notas NOMBRE DE ARCHIVO
El texto del mensaje se almacenará en $ XYMONHOME / notes / FILENAME que luego se usa como
hipervínculos de nombres de host o nombres de columna. Esto requiere que la tarea "storenotes"
está habilitado en tasks.cfg (está deshabilitado de forma predeterminada). FILENAME no puede contener
ruta del directorio: estos se eliminan automáticamente.

ID de usermsg
Estos mensajes se transmitirán directamente a los módulos que escuchan en el canal "usuario".
del demonio Xymon. Esto está destinado a la comunicación personalizada entre el lado del cliente
módulos y el servidor Xymon.

modificar HOSTNAME.TESTNAME COLOR FUENTE CAUSA
Modificar el color de un estado específico, sin generar un estado completo
mensaje. Esto es para procesadores de back-end (por ejemplo, gráficos RRD) que pueden anular el
color de un estado basado en algunos criterios determinados fuera del flujo normal de un
estado. Por ejemplo, el estado normal de "conexión" puede parecer verde, ya que simplemente verifica
sobre si se puede hacer ping a un host o no; el manejador RRD puede entonces usar un "modificar"
comando para anular esto es el tiempo de respuesta de ping real excede un umbral dado.
(Consulte el ajuste de configuración "DS" en análisis.cfg(5) para saber cómo hacer esto). FUENTE
es alguna identificación del módulo que genera el mensaje "modificar" - futuro
las modificaciones deben utilizar la misma fuente. Puede haber varias fuentes que modifiquen
el mismo estado (el estado más severo se convierte en el color real del
estado). CAUSA es una cadena de texto de una línea que explica el motivo por el que se anula la
color de estado normal: se mostrará en la página web de estado.

EJEMPLO

Envíe un mensaje de estado normal al servidor Xymon, utilizando el protocolo Xymon estándar en TCP
puerto 1984:
$ $ XYMON $ XYMSRV "estado www, foo, com.http verde` fecha` Web OK "

Envíe el mismo mensaje de estado, pero utilizando el protocolo HTTP a través del xymoncgimsg.cgi del servidor web
script:
$ $ XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi "estado www, foo, com.http verde
`fecha` Web OK"

Utilice el mensaje "consulta" para determinar el color de la prueba "www" y reinicie Apache si es
rojo:

$ WWW = `$ XYMON $ XYMSRV" consulta www, foo, com.www "| awk '{imprimir $ 1}' `
$ si ["$ WWW" = "rojo"]; luego /etc/init.d/apache reiniciar; fi

Use el mensaje "config" para actualizar un archivo mytest.cfg local (pero solo si obtenemos una respuesta):

$ $ XYMON $ XYMSRV "config mytest.cfg"> /tmp/mytest.cfg.new
$ if [-s /tmp/mytest.cfg.new]; luego
mv /tmp/mytest.cfg.new $ XYMONHOME / etc / mytest.cfg
fi

Envíe un mensaje de estado muy grande que se haya creado en el archivo "statusmsg.txt". En lugar de
de proporcionarlo en la línea de comandos, páselo a través de stdin al comando xymon:

$ cat statusmsg.txt | $ XYMON $ XYMSRV "@"

Use xymon en línea usando los servicios de onworks.net