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/».
2.1. Notas de host
Para crear notas para los hosts, crea el directorio hosts dentro del directorio notes.
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:
Situada en la parte inferior de la vista de tabla «Status of Host», esta nota tendrá este aspecto:

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'.
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:

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/».
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.
En un directorio que coincida exactamente con el nombre del host, puedes crear notas solo para los servicios de ese host concreto.
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*'.
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.
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:
|
Nombre del host |
|
Nombre del host en minúsculas |
|
Nombre del host en mayúsculas |
|
Nombre del host con la primera letra en mayúscula y el resto en minúsculas |
|
La dirección IP del host objeto de monitorización. |
|
Descripción del servicio (solo para notas de servicio) |
|
ID del site de Checkmk |
|
Prefijo URL del site |
|
Resultado del check plugin (solo para notas de host) |
|
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.
Additional information about <a href="http://mywiki.local/page.php?host=$HOSTNAME$" target="_blank">this host in our wiki</a>