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. Introducción

En Checkmk puedes guardar notas personalizadas para todos los hosts y servicios de forma individual y específica, o para grupos enteros. Estas notas se muestran en columnas separadas llamadas «Custom services notes» y «Custom host notes». Por defecto, estas columnas ya aparecen en las vistas detalladas de los hosts (Status of Host myhost) y los servicios (Service myservice, myhost). Como son columnas estándar, también se pueden insertar en muchas otras vistas de Checkmk.

2. Creación de notas

Las notas se pueden crear directamente en el directorio de configuración de tu site de Checkmk. Para ello, primero crea el directorio «notes» en «~/etc/check_mk/».

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

2.1. Notas de host

Para crear notas para los hosts, crea el directorio hosts dentro del directorio notes.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/hosts
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

Si ahora quieres crear una nota para un host específico, crea un archivo cuyo nombre coincida exactamente con el nombre del host en Checkmk. Usa el editor que prefieras o la redirección de shell, como en el siguiente ejemplo:

OMD[mysite]:~$ echo "My custom host note for myhost" > ~/etc/check_mk/notes/hosts/myhost
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

Situada en la parte inferior de la vista de tabla «Status of Host», esta nota tendrá este aspecto:

A note in the 'Status of Host' view.

Si quieres que un único archivo de este tipo haga referencia y se muestre en varios hosts a la vez, puedes trabajar con patrones de shell como el asterisco, el signo de interrogación y también clases de caracteres. Para ello, el nombre del archivo en el directorio correspondiente debe contener realmente estos caracteres. Así, un archivo llamado «'*'» en el directorio «~/etc/check_notes/hosts/» haría referencia a todos los hosts. El contenido del archivo «'*'» se mostraría, por lo tanto, en cada host individual de tu site.

Importante: Los nombres de estos archivos deben ir entre comillas simples.

Si, por alguna razón, quieres mostrar una nota específica en todos los hosts cuyo nombre termine en t, crea un archivo llamado '*t'.

OMD[mysite]:~$ echo "The name auf this host ends with t" > ~/etc/check_mk/notes/hosts/'*t'
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

Si hay más de un archivo que tiene una coincidencia con el nombre del host, el campo Custom host notes también mostrará todas las notas coincidentes. Las diferentes notas están separadas por una línea horizontal:

Notes from different source files are separated by a horizontal line.

2.2. Notas de servicio de servicio

Para poder crear este tipo de notas también para los servicios, necesitarás el directorio «services» dentro de «~/etc/check_mk/notes/».

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

A diferencia de los hosts, en este directorio no puedes empezar directamente con los archivos de tus notas. Aquí necesitas otro nivel de directorio, que defina para qué hosts debe mostrarse una nota de servicio.

Así que, a continuación, crea un directorio que designe un host —o, siguiendo los patrones mostrados arriba—, varios hosts.

Así, un directorio llamado «'*'» volvería a referirse a todos los hosts.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'*'
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

En un directorio que coincida exactamente con el nombre del host, puedes crear notas solo para los servicios de ese host concreto.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/myhost
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

Así que si quieres crear notas para los servicios de todos los hosts que empiezan por my, tendrás que crear un directorio llamado 'my*'.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'my*'
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

Una vez más, asegúrate de poner los nombres de los directorios entre comillas simples.

Una vez que hayas creado el nivel de host según tus requisitos, puedes —de forma análoga a las notas de host— volver a crear archivos, que en esta ocasión deben corresponder al Service description deseado. Del mismo modo, puedes trabajar con asteriscos, signos de interrogación y clases de caracteres.

El siguiente ejemplo crea una nota para el servicio Check_MK en cada uno de los hosts de tu site.

OMD[mysite]:~$ echo "Note about service Check_MK for all hosts" > ~/etc/check_mk/notes/services/'*'/Check_MK
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

3. Macros que se pueden utilizar

Dentro de las notas puedes usar macros, que luego se sustituirán según corresponda en la vista de tabla. Aquí puedes usar las siguientes macros:

$HOSTNAME$

Nombre del host

$HOSTNAME_LOWER$

Nombre del host en minúsculas

$HOSTNAME_UPPER$

Nombre del host en mayúsculas

$HOSTNAME_TITLE$

Nombre del host con la primera letra en mayúscula y el resto en minúsculas

$HOSTADDRESS$

La dirección IP del host objeto de monitorización.

$SERVICEDESC$

Descripción del servicio (solo para notas de servicio)

$SITE$

ID del site de Checkmk

$URL_PREFIX$

Prefijo URL del site

$HOSTOUTPUT$

Resultado del check plugin (solo para notas de host)

$SERVICEOUTPUT$

Salida del check plugin (solo para notas de servicio)

Por ejemplo, podrías usar un único archivo para hacer referencia a diferentes entradas de tu wiki interna, cada una de las cuales siempre tendrá una coincidencia con el host actualmente abierto.

~/etc/check_mk/notes/hosts/'*'
Additional information about <a href="http://mywiki.local/page.php?host=$HOSTNAME$" target="_blank">this host in our wiki</a>

Last modified: Tue, 02 Sep 2025 13:03:55 GMT via commit eb27aea06
En esta página