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 almacenar notas personalizadas para todos los host y servicios de forma individual y específica, o para grupos enteros. Estas notas se muestran en columnas independientes denominadas Custom services notes y Custom host notes. Por defecto, estas columnas ya se muestran en las vistas detalladas de host (Status of Host myhost) y servicios (Service myservice, myhost). Como son columnas estándar, también se pueden insertar en muchas otras vistas de Checkmk.

2. Crear notas

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

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes

2.1. Notas de host

Para crear a continuación notas para hosts, crea el directorio hosts dentro del directorio notes.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/hosts

Si ahora quieres crear una nota para un host concreto, crea un archivo cuyo nombre se corresponda exactamente con el nombre de ese host en Checkmk. Utiliza el editor de tu elección o la redirección del shell, como en el siguiente ejemplo:

OMD[mysite]:~$ echo "My custom host note for myhost" > ~/etc/check_mk/notes/hosts/myhost

Situada en la parte inferior de la vista de tabla Status of Host, esta nota tendrá el siguiente 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 host 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 host. En consecuencia, el contenido del archivo '*' se mostraría 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 host cuyo nombre termine en t, entonces crea un archivo llamado '*t'.

OMD[mysite]:~$ echo "The name auf this host ends with t" > ~/etc/check_mk/notes/hosts/'*t'

Si más de un archivo coincide con el nombre de un host, el campo Custom host notes mostrará también 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

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

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

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

Así, un directorio llamado '*' volvería a referirse a todos los host.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'*'

En un directorio que corresponda exactamente a un nombre del host, puedes crear notas sólo para los servicios de ese host.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/myhost

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

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'my*'

De nuevo, asegúrate de encerrar los nombres de directorio 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 esta vez 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 host de tu site.

OMD[mysite]:~$ echo "Note about service Check_MK for all hosts" > ~/etc/check_mk/notes/services/'*'/Check_MK

3. Macros que se pueden utilizar

Dentro de las notas puedes utilizar macros, que luego se sustituirán según corresponda en la vista de tabla. Aquí puedes utilizar 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úsculas y el resto en minúsculas

$HOSTADDRESS$

La dirección IP del host sobre el que se realiza la monitorización.

$SERVICEDESC$

Descripción del servicio (sólo para notas de servicio)

$SITE$

ID del site Checkmk

$URL_PREFIX$

Prefijo URL del site

$HOSTOUTPUT$

Salida del plugin de check (sólo para notas de host)

$SERVICEOUTPUT$

Salida del plugin de check (sólo para notas de servicio)

Por ejemplo, puedes utilizar un único archivo para hacer referencia a distintas entradas de tu wiki interna, cada una de las cuales coincidirá siempre con el host actualmente abierto.

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