1. Introducción
Si alguna vez te encuentras con problemas en Checkmk que —con la ayuda del Manual de usuario— no puedes resolver por ti mismo, tienes a tu disposición el soporte técnico oficial de Checkmk y el foro de Checkmk, que son dos excelentes puntos de contacto. En ambos casos, es imprescindible, por supuesto, una descripción precisa del error o del problema. Además, para un análisis y una solución rápidos, es imprescindible cierta información específica sobre tu entorno de Checkmk. La información más importante es, por supuesto, la versión y la edición de Checkmk que estás utilizando. Sin embargo, dependiendo de la situación, es posible que se requiera mucha más información para poder llegar al fondo de tu problema. En el pasado, el servicio de asistencia de Checkmk te indicaba qué información debías proporcionarles.
En lugar de que el servicio de soporte te proporcione una «lista de deseos», y te envíe así a una búsqueda del tesoro por los distintos componentes de Checkmk, con solo unos clics en la interfaz gráfica de usuario puedes crear un paquete de información a medida —denominado «dump» en este artículo—. Aquí decides por ti mismo si quieres incluir archivos de configuración que puedan contener información confidencial —o no— y, en caso afirmativo, especificar cuáles.
Algunos de los datos seleccionables solo están disponibles en las ediciones comerciales, por ejemplo, Performance Graphs of Checkmk Server, CMC (Checkmk Microcore) y Licensing information.
La información que selecciones aquí puede contener datos confidenciales. ¡Ten cuidado! |
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. |
2. Recopila la información de asistencia
2.1. Selecciona el site
Después de hacer clic en Setup > Maintenance > Support diagnostics, verás la siguiente pantalla:

Si utilizas la monitorización distribuida, en el primer campo puedes especificar el Site del que deseas seleccionar los datos que se van a recopilar.
2.2. Información general
En «General information» básicamente solo encontrarás un aviso de que la información sobre la versión de Checkmk y el sistema operativo en uso se incluirá en cualquier caso. Si lo dejas así —es decir, no seleccionas ninguna de las opciones— y empiezas la colección de los datos a través de «Collect diagnostics», obtendrás un archivo que contiene solo los siguientes datos:
Además del archivo general.json, Checkmk genera otros archivos en esta configuración estándar con datos de rendimiento, como el número de hosts y servicios, el hardware del servidor Checkmk, las variables del entorno configuradas en el site, los nombres y tamaños de los archivos del site y los módulos de Python instalados allí con sus versiones.
La página Background job details, que se abre después de hacer clic en Collect diagnostics, muestra exactamente qué datos se recopilan.
2.3. Información general opcional
En Optional general information encontrarás opciones que puedes recopilar de antemano para adaptarlas a tu consulta, o que el personal de soporte técnico puede solicitarte explícitamente.
Si seleccionas aquí Local Files and MKPs, Checkmk también creará una vista general de todos los archivos del directorio ~/local/ de tu site.
Esto puede resultar útil en ocasiones si tus personalizaciones locales son incompatibles con una actualización reciente de Checkmk.
Aquí también se incluyen todos los MKP instalados.
Al seleccionar «OMD Config», puedes añadir la información sobre tu configuración de OMD al volcado.
Esto se corresponde exactamente con lo que obtendrías en la línea de comandos con el comando «omd config show».
Si marcas la checkbox «Checkmk Overview», se incluirá información general sobre todos los sitios que se ejecutan en tu servidor Checkmk. Esto también crea una lista de todas las versiones de Checkmk instaladas. Y si el sitio seleccionado anteriormente es el nodo de un clúster, este dato también se registrará aquí.
Con la opción «Crash Reports», puedes añadir al volcado los últimos informes de fallos de las distintas categorías —por ejemplo, base, check, gui o rest_api—.
Encontrarás más información sobre los informes de fallos en el artículo sobre la programación de check plugins basados en agentes.
En Checkmk puedes encontrar los informes de fallos en Monitor > System > Crash reports.
Después de activar Checkmk Log files o Checkmk Configuration files, tienes la opción de eliminar cualquier dato confidencial de esta parte del paquete —a través de la selección «Pack only Low sensitivity files».
Todos los archivos que puedes seleccionar aquí provienen de los directorios ~/var/log/ o ~/etc/checkmk/ y sus subdirectorios.
Puedes ver una lista detallada justo debajo del menú desplegable.
Con la opción «Select individual files from list» tienes incluso la opción de incluir solo archivos específicos en el volcado.
Con esta opción también puedes ver qué archivos tienen uno de los niveles de confidencialidad Alto (H), por ejemplo, archivos con contraseñas; Medio (M), si contienen direcciones o nombres de usuario, por ejemplo; o, por último, Bajo (L).

Para disponer de la mayor cantidad de información detallada posible sobre el comportamiento de Checkmk en los archivos de registro, puede ser necesario cambiar el nivel de registro en Checkmk durante un breve periodo de tiempo.
Los ajustes correspondientes se pueden encontrar en Setup > General > Global settings.
En esta página, simplemente escribe |
A continuación, tienes la opción de añadir Performance Graphs of Checkmk Server al volcado. Especialmente en casos de problemas con el rendimiento de un site de Checkmk, estos informes casi siempre se solicitan, por lo que es una buena idea incluirlos ante este tipo de problemas. El diagnóstico de soporte hará el trabajo por ti para generar manualmente una serie de informes en formato PDF. Entre otros, se generan los informes del servicio OMD mysite performance correspondientes a las últimas 25 horas y los últimos 35 días.
2.4. Información específica de componentes
La sección «Component specific information» te permite decidir de forma muy detallada qué información de tu configuración global de Checkmk, tus hosts y carpetas, y tu configuración de notificaciones debe incluirse en el volcado.
Dependiendo de la configuración, los archivos que selecciones aquí pueden contener información confidencial, como contraseñas. En condiciones normales, estos datos están protegidos por el hecho de que solo el usuario del site y los administradores tienen acceso a ellos. Si pones estos datos a disposición de terceros con fines de análisis, debes proceder con mucha precaución. |
En el subapartado «Global Settings» encontrarás todos los archivos `global.mk` de los componentes individuales de tu sitio Checkmk,
como el Demonio de Configuración Dinámica (DCD) o el Livestatus Proxy Daemon.
La información que se puede seleccionar a través del subapartado «Hosts and Folders» puede, entre otras cosas, ayudar a encontrar conjuntos de reglas desfavorables y errores en la configuración del host.
En la sección «Notifications» encontrarás, además de los archivos de configuración correspondientes, una opción para seleccionar archivos de registro. En caso de dificultades con tus notificaciones, tú —o, en última instancia, el soporte técnico de Checkmk— a menudo puedes encontrar el origen del problema en estos registros.

Usa la opción «Business Intelligence» para seleccionar los archivos de configuración de Business Intelligence. Tras activar una de las opciones «CMC (Checkmk Microcore)» o «Licensing information», tienes de nuevo la posibilidad de eliminar datos más o menos confidenciales de la parte correspondiente del paquete, mediante la selección «Pack only Medium and Low sensitivity files» o «Pack only Low sensitivity files».
3. Diagnóstico de soporte a través de la línea de comandos
Como suele ocurrir en Checkmk, esta tarea se puede realizar simplemente desde un terminal.
Esto se puede hacer fácilmente con el comando cmk y la opción --create-diagnostics-dump.
Para todas las opciones descritas anteriormente, puedes añadir el parámetro correspondiente al comando.
Las siguientes opciones completan la salida del comando:
|
Lista de todos los archivos instalados, sin empaquetar y opcionales en |
|
Contenido del archivo |
|
Último informe de fallos de cada subdirectorio de |
|
Información del nodo de inventario de HW/SW Software > Applications > Checkmk del servidor Checkmk.
Para el parámetro |
|
Archivos de configuración del directorio |
|
Archivos de registro ( |
|
Gráficos de rendimiento (p. ej., carga de la CPU, carga de la CPU) del servidor Checkmk —solo disponibles en las ediciones comerciales.
Para el parámetro |
Lo anterior, y todas las demás opciones del comando cmk, se pueden encontrar, como de costumbre, en la salida de cmk --help.
4. Falta información en el volcado
4.1. Se necesita el agente actual
Para poder generar información completa en los diagnósticos de soporte, debes asegurarte de que el agente instalado en los servidores Checkmk tenga el mismo número de versión que el servidor Checkmk. En concreto, es posible que las versiones antiguas del agente aún no proporcionen la información procedente del inventario de HW/SW del servidor Checkmk.
4.2. Label «cmk/check_mk_server:yes
»
Los diagnósticos de soporte dependen de que los servidores Checkmk de tu entorno estén etiquetados correctamente.
Si te faltan algunos datos en un volcado, comprueba si tus servidores Checkmk están etiquetados con la etiqueta «cmk/check_mk_server:yes».
