Checkmk
to checkmk.com
Important

This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved.

1. Tablas disponibles

Las siguientes tablas están disponibles para su uso en Livestatus. Algunas de ellas funcionan adicionalmente sobre las columnas de otra tabla. Estas columnas se identificarán con el nombre de la tabla como prefijo:

Tabla Comentarios

hosts

Contiene toda la información de los host configurados.

services

Contiene toda la información de los servicios configurados y, además, las columnas de hosts.

hostgroups

Información de los grupos del host.

servicegroups

Información de los grupos de servicio.

contactgroups

Información de los grupos de contacto.

servicesbygroup

Como services, pero además con las columnas de servicegroups.

servicesbyhostgroup

Como services, pero además con las columnas de hostgroups.

hostsbygroup

Como hosts, pero además con las columnas de hostgroups.

contacts

Información para los contactos.

commands

Todos los comandos de check configurados, como los que se encuentran para un servicio en Service check command.

timeperiods

Toda la información sobre los periodos de tiempo configurados.

downtimes

Como en timeperiods, pero para los tiempos de mantenimiento programados.

comments

Contiene toda la información de los comentarios y, además, las columnas de hosts y services.

log

Toda la información de los eventos registrados. Deben filtrarse por clase y marca/periodo de tiempo.

status

Información sobre el estado y el rendimiento del núcleo.

columns

Aquí se listarán todas las tablas disponibles. Además, también se proporciona una descripción de todas las columnas de una tabla.

statehist

Con esta tabla se pueden buscar exhaustivamente los estados anteriores de un host/servicio.

eventconsoleevents

Lista todos los eventos de la Consola de eventos. Esta tabla tiene además todas las columnas de hosts.

eventconsolehistory

Como eventconsoleevents, pero también con columnas adicionales para el historial de un evento.

eventconsolestatus

Lista las estadísticas del rendimiento de la Consola de eventos.

eventconsolerules

Estadísticas de la frecuencia con la que la coincidencia de reglas para un evento entrante tuvo éxito.

Si deseas saber qué columnas utiliza una tabla, puedes mostrarlas fácilmente con el siguiente comando:

OMD[mysite]:~$ lq "GET columns\nColumns: name\nFilter: table = columns"
description
name
table
type

También se pueden seleccionar otras tablas utilizando filtros. Todas las columnas disponibles para buscar por columna y tabla se pueden ver en la salida del ejemplo mostrado.

2. Cabeceras disponibles

Cabecera Argumento Función

Columns

Nombre de columna

Restringe la salida a las columnas especificadas.

Filter

Nombre de columna, operador y nombre de objeto

Restringe la salida al objeto definido. Ver también filtro.

OrderBy

Nombre de columna o clave de diccionario

Ordena la salida por el contenido de la columna o el valor, respectivamente. El orden de ordenación por defecto es ascendente, alternativamente puedes especificar adicionalmente uno de asc o desc.

OR

Número entero

Enlaza el/los último(s) filtro(s) de n con un OR lógico.

AND

Número entero

Vincula el/los último(s) filtro(s) n con un AND lógico.

NEGATE

Número entero

Invierte el último filtro o filtros n.

Separators

Valores ASCII

Define los caracteres para separar elementos.

OutputFormat

Nombre

Define un formato de salida alternativo para los datos. Los formatos posibles son json, python, python3, CSV y csv (el formato estándar).

Stats

Operador y nombres de columna

Genera estadísticas para las columnas especificadas.

StatsOr

Número entero

Proporciona las funciones del encabezado OR en las estadísticas.

StatsAnd

Número entero

Proporciona las funciones del encabezado AND en las estadísticas.

StatsNegate

Número entero

Proporciona las funciones del encabezado NEGATE en las estadísticas.

Limit

Número entero

Limita la salida a n líneas.

Timelimit

Número entero

Limita el tiempo permitido para procesar la consulta a n segundos.

ColumnHeaders

-

La primera línea de la salida contiene el nombre de la columna utilizada. Si además se ha configurado la cabecera ResponseHeader, el nombre de la columna se mostrará en la segunda línea.

AuthUser

Nombre de usuario

Restringe la salida a las líneas que el usuario especificado está autorizado a ver.

WaitObject

Nombre del objeto

El objeto para el que se espera un comportamiento especificado. Es el nombre del objeto o, en el caso de la tabla services, el nombre del host seguido de un espacio en blanco, seguido a su vez de la descripción del servicio. Si el propio nombre del host contiene caracteres en blanco, los dos elementos también pueden separarse con un punto y coma. Esta cabecera sólo es compatible con las tablas hosts, services hostgroups servicegroups contacts y contactgroups.

WaitCondition

Condición del filtro

La condición que debe cumplirse para el objeto definido. Se puede definir cualquier número de condiciones que se desee - éstas se enlazan entre sí con un Y lógico.

WaitConditionOr

Número entero

Proporciona la función OR-cabecera en las condiciones de Espera.

WaitConditionAnd

Número entero

Proporciona la función AND-header en las condiciones de Espera.

WaitConditionNegate

Número entero

Proporciona la función NEGATE-header en las condiciones de Espera.

WaitTrigger

Palabra clave *

Las palabras clave funcionan como una condición normal si se establecen por sí mismas. En combinación con WaitCondition, esto simplifica la localización de entradas de registro relevantes y reduce la sobrecarga en Livestatus.

WaitTimeout

Número entero

Establece un límite de tiempo en milisegundos. Tras, por ejemplo, 5000 milisegundos (5 segundos), la consulta se ejecutará aunque no se haya satisfecho la condición.

Localtime

Hora Unix

Mediante el uso de una hora de referencia especificada se intenta compensar las diferentes marcas horarias locales en un entorno distribuido.

ResponseHeader

fijo16/apagado

Devuelve una línea de estado en la primera línea de la respuesta. La salida propiamente dicha permanece en la primera línea si se ha establecido adicionalmente la cabecera ColumnHeaders.

KeepAlive

on

Evita que se cierre el canal Livestatus tras una consulta.

* Las siguientes palabras clave están disponibles para WaitTrigger:

  • check

  • estado

  • registrar

  • tiempo de mantenimiento

  • comentar

  • comando

  • programa

  • todo

3. Operadores para filtros

3.1. Operadores generales

Operador * Para números Para cadenas de caracteres

=

Igualdad

Igualdad

~

Superconjunto **

Contiene una cadena de caracteres como expresión regular.

=~

Subconjunto **

Igualdad insensible a mayúsculas y minúsculas

~~

Contiene al menos uno de los valores **

Contiene una cadena de caracteres insensible a mayúsculas y minúsculas como expresión regular.

<

Menor que

Lexicográficamente menor que

>

Mayor que

Lexicográficamente mayor que

<=

Menor o igual que

Lexicográficamente menor o igual

>=

Mayor o igual

Lexicográficamente mayor o igual

* Todos los operadores se pueden negar con un signo de exclamación (!).

** Estos operadores son útiles cuando se trabaja con listas. Livestatus interpreta entonces los valores especificados como una cantidad.

3.2. Operadores para listas

Puedes comprobar si un elemento está incluido en una lista utilizando los siguientes operadores:

Operador Tipo de check

=

Comprueba si hay listas vacías *

>=

Igualdad

<

Disparidad

<=

Igualdad insensible a mayúsculas y minúsculas

>

Disparidad insensible a mayúsculas y minúsculas

~

La cadena de caracteres para una expresión regular *

~~

La cadena de caracteres insensible a mayúsculas y minúsculas para una expresión regular *

* Estos operadores pueden negarse con un signo de exclamación (!).

4. Operadores para estadísticas

Operador Descripción

sum

Genera una suma a partir de los valores.

min

Busca el valor más pequeño.

max

Busca el valor más alto.

avg

Calcula un valor medio (valor medio).

std

Obtiene la desviación estándar.

suminv

Invierte la suma de los valores según 1/sum.

avginv

Invierte el valor medio de los valores según 1/avg.

5. Códigos de estado del ResponseHeader

Código de estado Descripción

200

La consulta se ha realizado correctamente y la respuesta contiene los datos solicitados.

400

La consulta contiene una cabecera defectuosa.

404

No se ha podido encontrar la tabla.

413

Se ha superado el límite de tiempo de la consulta.

451

La consulta se ha transferido de forma incompleta.

452

La consulta es completamente inválida.

6. Comandos

Los siguientes comandos están a tu disposición en todas las ediciones de Checkmk:

Comando Descripción

Comandos de host

ACKNOWLEDGE_HOST_PROBLEM

Reconocer un problema del host

REMOVE_HOST_ACKNOWLEDGEMENT

Borrar el reconocimiento de un problema del host

ADD_HOST_COMMENT

Añadir un comentario a un host

DEL_HOST_COMMENT

Borrar un comentario de un host

SCHEDULE_HOST_DOWNTIME

Programar un tiempo de mantenimiento de un host

DEL_HOST_DOWNTIME

Borrar un tiempo de mantenimiento de un host

START_EXECUTING_HOST_CHECKS

Iniciar la ejecución global de los checks del host

STOP_EXECUTING_HOST_CHECKS

Detener la ejecución global de los checks del host

ENABLE_HOST_CHECK

Activar los checks activos de un host

DISABLE_HOST_CHECK

Desactivar los checks activos de un host

ENABLE_PASSIVE_HOST_CHECKS

Activar los checks pasivos de un host

DISABLE_PASSIVE_HOST_CHECKS

Desactivar los checks pasivos de un host

ENABLE_HOST_NOTIFICATIONS

Activar notificaciones para un host

DISABLE_HOST_NOTIFICATIONS

Desactivar las notificaciones de un host

ENABLE_HOST_SVC_NOTIFICATIONS

Activar notificaciones para todos los servicios de un host

DISABLE_HOST_SVC_NOTIFICATIONS

Desactivar las notificaciones de todos los servicios de un host

SCHEDULE_FORCED_HOST_CHECK

Programar una actualización forzada de un check de host

PROCESS_HOST_CHECK_RESULT

Establecer manualmente el resultado de un check de host

SEND_CUSTOM_HOST_NOTIFICATION

Crear una notificación definida por el usuario para el host

CHANGE_HOST_MODATTR

Editar los atributos modificados de un host

Comandos de servicio

ACKNOWLEDGE_SVC_PROBLEM

Reconocer un problema de servicio

REMOVE_SVC_ACKNOWLEDGEMENT

Borrar el Reconocimiento de un problema de servicio

ADD_SVC_COMMENT

Añadir un comentario a un servicio

DEL_SVC_COMMENT

Borrar un comentario de un servicio

SCHEDULE_SVC_DOWNTIME

Programar un tiempo de mantenimiento para un servicio

DEL_SVC_DOWNTIME

Borrar un tiempo de mantenimiento de un servicio

START_EXECUTING_SVC_CHECKS

Iniciar la ejecución global de los servicios activos

STOP_EXECUTING_SVC_CHECKS

Detener la ejecución global de los servicios activos

ENABLE_SVC_CHECK

Activar la ejecución de un servicio activo

DISABLE_SVC_CHECK

Desactivar la ejecución de un servicio activo

ENABLE_PASSIVE_SVC_CHECKS

Activar la ejecución de un servicio pasivo

DISABLE_PASSIVE_SVC_CHECKS

Desactivar la ejecución de un servicio pasivo

ENABLE_SVC_NOTIFICATIONS

Activar las notificaciones de un servicio

DISABLE_SVC_NOTIFICATIONS

Desactivar las notificaciones de un servicio

SCHEDULE_FORCED_SVC_CHECK

Programar una actualización forzada de un servicio

PROCESS_SERVICE_CHECK_RESULT

Establecer manualmente el resultado de un servicio pasivo

SEND_CUSTOM_SVC_NOTIFICATION

Crear una notificación de servicio definida por el usuario

CHANGE_SVC_MODATTR

Editar los atributos modificados de un servicio

Otros comandos

ENABLE_NOTIFICATIONS

Activar notificaciones globalmente

DISABLE_NOTIFICATIONS

Desactivar las notificaciones globalmente

ENABLE_FLAP_DETECTION

Activar la detección de hosts/servicios inestables globalmente

DISABLE_FLAP_DETECTION

Desactivar la detección de hosts/servicios inestables globalmente

ENABLE_PERFORMANCE_DATA

Activar el proceso de datos de rendimiento globalmente

DISABLE_PERFORMANCE_DATA

Desactiva el proceso de datos de rendimiento globalmente

ENABLE_EVENT_HANDLERS

Activar la ejecución de alert handlers/event handlers globalmente

DISABLE_EVENT_HANDLERS

Desactiva la ejecución de los alert handlers/event handlers globalmente

SAVE_STATE_INFORMATION

Guardar inmediatamente toda la información de estado

Comandos que sólo están disponibles con la CMC en las ediciones comerciales:

Comando Descripción

Comandos de host

PROCESS_HOST_PERFDATA

tba

UPDATE_SHADOW_HOST_STATE

tba

Comandos de servicio

PROCESS_SVC_PERFDATA

tba

UPDATE_SHADOW_SERVICE_STATE

tba

Otros comandos

LOG

tba

MK_LOGWATCH_ACKNOWLEDGE

tba

RELOAD_CONFIG

tba

REOPEN_DAEMONLOG

tba

ROTATE_LOGFILE

tba

SEGFAULT

tba

En esta página