 |
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. Conceptos básicos sobre las notificaciones
En Checkmk, una notificación consiste en avisar activamente a los usuarios cuando cambia el estado de un host o un servicio.
Supongamos que, en un momento dado, en el host mywebsrv17, el servicio HTTP foo.bar cambia de OK a CRIT.
Checkmk lo detecta y, por defecto, envía un correo electrónico con los datos más importantes sobre este evento a todos los contactos de este servicio.
Más tarde, el estado vuelve a cambiar, de CRIT a OK, y los contactos reciben otro correo electrónico, esta vez con un informe sobre la recuperación.
Pero esta es solo la forma más sencilla de notificar. Hay muchas formas de personalizarlo:
Puedes enviar notificaciones por SMS, buscapersonas, Slack y otros servicios de internet.
Puedes limitar las notificaciones a periodos de tiempo específicos, por ejemplo, para tener en cuenta los turnos de guardia.
Puedes definir escalados si el contacto responsable no actúa con la suficiente rapidez.
Los usuarios pueden «suscribirse» o «darse de baja» de las notificaciones de forma independiente si lo permites.
En general, puedes definir reglas sobre quién debe recibir qué notificación y cuándo.
Sin embargo, antes de empezar a trabajar con las notificaciones, debes tener en cuenta lo siguiente:
Las notificaciones son una función opcional. Algunos usuarios prescinden de las notificaciones porque cuentan con un centro de control que funciona las 24 horas del día y que opera únicamente con la interfaz de estado.
Al principio, activa las notificaciones solo para ti y hazte responsable de todo. Observa durante al menos unos días cuál es el volumen de notificaciones.
No actives las notificaciones para otros usuarios hasta que hayas reducido al mínimo las falsas alarmas (falsos positivos). Hemos descrito cómo puedes hacerlo en el capítulo sobre el ajuste preciso de la monitorización.
2. Preparación para las notificaciones por correo electrónico
El método más sencillo y, con diferencia, el más habitual es enviar una notificación por correo electrónico. En un correo electrónico hay espacio suficiente para incluir también los gráficos de las métricas.
Antes de poder enviar notificaciones por correo electrónico, tu servidor Checkmk debe estar configurado para enviar correos electrónicos. Para todas las distribuciones de Linux compatibles, esto se reduce a lo siguiente:
Instala un servicio de servidor SMTP. Esto suele hacerse automáticamente durante la instalación de la distribución.
Especifica un smarthost. Normalmente se te pedirá esto al instalar el servidor SMTP. El smarthost es un servidor de correo de tu empresa que se encarga de la entrega de los correos electrónicos de Checkmk. Las empresas muy pequeñas no suelen tener su propio smarthost. En este caso, utiliza el servidor SMTP que te proporciona tu proveedor de correo electrónico.
Si el envío de correo se ha configurado correctamente, deberías poder enviar un correo electrónico desde la línea de comandos, por ejemplo, mediante este comando:
El correo electrónico debería entregarse sin demora.
Si esto no funciona, encontrarás pistas sobre el origen del problema en el archivo de registro del servidor SMTP, en el directorio /var/log/.
Puedes encontrar más detalles sobre la configuración del envío de correos en Linux en el artículo sobre reglas de notificación.
3. Activar las notificaciones por correo electrónico
Una vez que el envío de correos electrónicos funciona básicamente, activar las notificaciones es muy sencillo. Para que un usuario reciba notificaciones por correo electrónico, deben cumplirse las siguientes condiciones:
Se le ha asignado una dirección de correo electrónico al usuario.
El usuario es responsable de hosts o servicios, a través de la asignación de grupos de contacto.
Existe una regla de notificación que garantiza que los miembros de los grupos de contacto reciban notificaciones por correo electrónico.
La asignación de la dirección de correo electrónico y los grupos de contacto se realiza a través de las propiedades del usuario, tal y como mostramos anteriormente en el capítulo sobre administración de usuarios. Se puede hacer, por ejemplo, añadiendo tu dirección de correo electrónico y el grupo de contacto Everything a la cuenta de usuario denominada cmkadmin. Checkmk ya tiene una regla de notificación preconfigurada que avisa a todos los contactos de los hosts y servicios sobre cambios de estado importantes mediante correo HTML.
En la siguiente sección descubrirás qué significa «importante».
4. Probar las notificaciones
Sería un poco engorroso esperar a que surja un problema real o incluso provocar uno para probar las notificaciones. Esto es más fácil con Test notifications, una herramienta con la que puedes simular una notificación para un host o servicio y hacer que se envíe de inmediato.
Primero, abre el centro de notificaciones con Setup > Events > Notifications:
Cuando accedas a esta página por primera vez, se te informará de la «dirección de correo electrónico de reserva» que aún no se ha configurado, como se puede ver en la captura de pantalla anterior. Por el momento, puedes ignorar esta información. Tratamos este tema en el artículo sobre reglas de notificación. Hasta que hayas leído esta sección, te recomendamos dejar la información como recordatorio y no hacer clic en Do not show again para eliminarla.
Por lo demás, esta página muestra información de estado —como el número de notificaciones enviadas y fallidas— y se utiliza para acceder a acciones relacionadas con el tema de las notificaciones, por ejemplo, la creación de una regla de notificación, pero también para acceder a reglas de host y de servicio que pueden influir en las notificaciones.
En la parte inferior de la página Notifications, en la caja «Global notification rules», se muestra la regla de notificación global proporcionada por Checkmk. «Global», porque cada usuario también puede crear sus propias reglas de notificación definidas por el usuario.
La regla de notificación proporcionada garantiza que las notificaciones de todos los cambios de estado importantes de los hosts y servicios se envíen a todos los contactos responsables a través de correo electrónico HTML. Todos los cambios de estado de los hosts a DOWN y UP, y de los servicios a CRIT, WARN y OK se clasifican como «importantes».
La prueba de notificación evalúa las reglas de notificación mostradas. Puedes acceder a la prueba de notificación a través de Setup > Events > Notifications y del botón Test notifications:
Solo tienes que seleccionar un host y, a continuación, cualquier cambio de estado como evento. Al activar la checkbox «Trigger notification for a specific method», especificas que la notificación no solo se simula, sino que también se envía realmente.
Haz clic en «Test notifications». Los resultados se muestran en la parte inferior de la página. Lo más importante es el resumen «Test results» en la parte superior:
Para que la prueba sea satisfactoria, debe haber al menos una coincidencia entre las reglas de notificación. El mensaje que indica «notification has been triggered» (Enviado) indica que la notificación se ha enviado realmente.
Debajo de Predicted notifications puedes ver a quién y a través de qué canal se envió la notificación:
Por último, la primera columna del campo inferior muestra cuál de las reglas de notificación se ha aplicado 
y cuál no 
:
Esto debería generar inmediatamente un correo electrónico para este problema simulado. Encontrarás una descripción detallada de las opciones y los resultados de la prueba de notificación en el artículo sobre reglas de notificación.
Si no has recibido una notificación en la monitorización real, es decir, fuera de la simulación, esto no significa necesariamente que haya un error. Hay situaciones en las que las notificaciones de Checkmk se suprimen deliberadamente, por ejemplo:
cuando la notificación se ha desactivado en el snap-in dMaster control;
cuando un host o servicio se encuentra en un periodo de tiempo de mantenimiento programado;
cuando un host está en modo de prueba y, por lo tanto, sus servicios no activan ninguna notificación;
si el estado ha cambiado con demasiada frecuencia recientemente y, por lo tanto, el servicio ha sido marcado como «inestable» en Checkmk.
5. Ajustes precisos de las notificaciones
Puedes adaptar las notificaciones de Checkmk a tus necesidades o a las de tu organización de diversas formas mediante reglas complejas. Encontrarás toda la información al respecto en el artículo sobre notificaciones.
6. Resolución de problemas
El módulo de notificaciones de Checkmk es muy complejo, ya que cubre muchos requisitos muy diferentes que han demostrado ser importantes a lo largo de muchos años de experiencia práctica. Por eso, la pregunta «¿Por qué Checkmk no ha enviado una notificación aquí?» se planteará más a menudo de lo que podrías esperar, sobre todo al principio. Por este motivo, aquí tienes algunos consejos para solucionar problemas.
Si tienes problemas con las notificaciones, check primero si hay alguna notificación fallida. La lista de notificaciones fallidas aparece en la página Monitor > System > Failed notifications. La columna «Summary» muestra el motivo del error, o al menos te da una indicación de la causa probable.
Checkmk ofrece otra posibilidad al analizar las notificaciones más recientes que ha generado el sistema y que han pasado por las reglas de notificación. Abre la tabla de notificaciones para su análisis en Setup > Events > Analyze recent notifications. Aquí puedes reenviar una notificación, mostrar su contexto y analizar las reglas de notificación asociadas. Puedes encontrar más información al respecto en el artículo sobre notificaciones.
Si una notificación no ha sido activada por un servicio concreto, el primer paso sería consultar el historial de notificaciones de ese servicio. Para ello, abre la página de detalles de ese servicio haciendo clic en el servicio dentro de la monitorización. Selecciona «Service > Service notifications» en el menú. Allí encontrarás todas las notificaciones de este servicio ordenadas cronológicamente, de más reciente a más antigua.
Aquí tienes un ejemplo de un servicio para el que se intentó enviar una notificación, pero en el que el envío de correos electrónicos falló porque no se ha instalado ningún servidor SMTP.
Puedes encontrar aún más información en el archivo «~/var/log/notifiy.log».
Puedes ver esto como usuario del site, con el comando «less», por ejemplo:
Si aún no estás familiarizado con less, con la combinación de teclas Shift+G puedes saltar al final de un archivo (lo cual es útil para los archivos de registro), y salir de less con la tecla Q.
Con el comando tail -f, también puedes ver el contenido del archivo «en directo» mientras se está ejecutando.
Esto es útil si solo te interesan los mensajes nuevos, es decir, aquellos que aparecen después de haber pulsado tail.
Aquí tienes un extracto del archivo notify.log correspondiente a una notificación activada correctamente:
2024-04-15 16:21:47,912 [20] [cmk.base.notify] Analysing notification (localhost) context with 14 variables
2024-04-15 16:21:47,912 [20] [cmk.base.notify] Global rule 'Notify all contacts of a host/service via HTML email'...
2024-04-15 16:21:47,913 [20] [cmk.base.notify] -> matches!
2024-04-15 16:21:47,913 [20] [cmk.base.notify] - adding notification of martin via mail
2024-04-15 16:21:47,913 [20] [cmk.base.notify] Executing 1 notifications:
2024-04-15 16:21:47,913 [20] [cmk.base.notify] * notifying martin via mail, parameters: graphs_per_notification, notifications_with_graphs, bulk: no
2024-04-15 16:21:47,913 [20] [cmk.utils.notify] sending command LOG;HOST NOTIFICATION: martin;localhost;DOWN;mail;
2024-04-15 16:21:47,913 [20] [cmk.base.notify] executing /omd/sites/mysite/share/check_mk/notifications/mail
2024-04-15 16:21:48,458 [20] [cmk.base.notify] Output: Spooled mail to local mail transmission agent
2024-04-15 16:21:48,501 [20] [cmk.utils.notify] sending command LOG;HOST NOTIFICATION RESULT: martin;localhost;OK;mail;Spooled mail to local mail transmission agent;Spooled mail to local mail transmission agent |
Si quieres saber exactamente cuándo se generan las notificaciones —y cuándo no—, puedes conocer toda la verdad en el artículo sobre notificaciones. |
Al configurar las notificaciones, has dado los últimos toques: ¡tu sistema Checkmk está listo para usar! Esto no significa, por supuesto, que se hayan explorado todas las capacidades de Checkmk.