 |
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
1.1. Antecedentes y motivación
Nuestra integración de Datadog está dirigida a todos nuestros usuarios que ya utilizan Datadog en sus organizaciones. Mediante nuestra integración hemos reducido la necesidad de estar comprobando continuamente dos sistemas de monitorización, y también hemos cerrado la brecha entre ambos sistemas.
La integración nos permite correlacionar los datos de los dos sistemas, acelerar cualquier análisis de la causa raíz y, al mismo tiempo, facilitar la comunicación entre los usuarios de Checkmk y Datadog.
1.2. Monitores y eventos
Concretamente, nuestra conexión permite monitorizar y mostrar en Checkmk los llamados monitores y eventos de Datadog. Por supuesto, también puedes recibir notificaciones sobre eventos desde dentro de Checkmk de la forma habitual.
La integración de monitorizaciones y eventos de Datadog se realiza a través de un agente especial.
2. Configurar la integración
2.1. Generar y copiar claves
Para la extracción de datos, nuestro agente especial utiliza la API de Datadog. Para asegurar el acceso a esta API se necesitan dos claves: una clave de API y una clave de aplicación cada una. Recomendamos crear dos claves nuevas para uso de Checkmk y utilizarlas exclusivamente para que Checkmk las recupere.
En el momento de escribir este artículo, puedes encontrar las claves correspondientes o la opción de crear nuevas claves en Datadog haciendo clic en el botón de la esquina inferior izquierda donde se encuentra tu nombre de usuario. Haz clic allí en Organization Settings. Bajo el encabezamiento ACCESS encontrarás las dos entradas API Keys y Application Keys. Crea una nueva clave en cada uno de estos dos submenús utilizando el botón New Key.
Para poder insertar después las dos claves en Checkmk, se recomienda copiarlas. Para ello, haz clic en la línea de la clave respectiva y luego en Copy.
Nota: Durante la redacción de este artículo, la ubicación de las teclas ya ha cambiado una vez. Si no encuentras los elementos de menú descritos anteriormente, consulta la documentación de Datadog.
2.2. Crear un host
Dependiendo de cómo quieras integrar Datadog en Checkmk, puede haber distintas formas de asignar los datos obtenidos a los hosts en Checkmk. Más adelante hablaremos de ello. Por ahora, vamos a centrarnos en una configuración sencilla y a asignar todos los datos a un host.
Para ello, crea un nuevo host en Checkmk de la forma habitual y llámalo mydatadoghost, por ejemplo. Como este host sólo recibirá datos a través del agente especial por el momento, establece la opción IP address family en No IP.
Realiza todos los demás ajustes de acuerdo con tu entorno y confirma tu selección a través de Save & view folder.
2.3. Crear una regla para el agente Datadog
A continuación, tienes que configurar el agente especial mediante el conjunto de reglas Setup > Agents > Other integrations > Applications > Datadog. En primer lugar, copia las dos claves que has creado antes en los campos previstos, o bien utiliza el almacén de contraseñas de Checkmk. Después, comprueba si el API host preintroducido se corresponde con el de tu instancia de Datadog. Para ello, sólo tienes que comparar la URL de tu instancia de Datadog con la entrada por defecto de la regla y editarla si es necesario.
Si tienes a Checkmk comunicándose con Datadog a través de un HTTP proxy, introdúcelo en la siguiente opción.
Ahora puedes decidir qué datos quieres transferir de Datadog a Checkmk. Aquí puedes elegir entre los llamados monitors y events.
Obtener monitorizaciones
Si activas la monitorización de monitores, tienes la opción de filtrar los datos a transmitir, utilizando tags dentro de Datadog. Especialmente en entornos grandes, se recomienda etiquetar los monitores que quieras ver en Checkmk con un tag apropiado en Datadog (por ejemplo, monitored_by_checkmk:yes). A continuación, introduce estos tags en Restrict by monitor tags.
Además, también es posible utilizar otras etiquetas que aparecen en la configuración de la monitorización en Datadog para el filtrado. Por ejemplo, podrías etiquetar hosts con "checkmk:yes" en Datadog.
Si luego creas una monitorización del host en Datadog que haga referencia a todos los hosts con esa etiqueta, también puedes utilizar esa misma etiqueta en Checkmk en Restrict by tags. De esta forma, con muy poco esfuerzo obtendrás todas las monitorizaciones de Datadog que contengan la etiqueta 'checkmk:yes'. Por supuesto, esto funciona no sólo para las etiquetas del host, sino para todas las etiquetas a partir de las cuales se pueden crear monitorizaciones en Datadog.
Si dejas desactivadas ambas opciones, todas las monitorizaciones se transferirán simplemente de Datadog a Checkmk.
Se creará un servicio en Checkmk para cada monitor de Datadog que puedas monitorizar en Checkmk.
Obtener eventos
Con el agente especial para Datadog también tienes la posibilidad de transferir eventos de Datadog directamente a la Consola de eventos de Checkmk. Para limitar qué eventos deben transferirse, puedes utilizar de nuevo etiquetas de Datadog. Además, puedes especificar un intervalo de tiempo a partir del cual deben transferirse los eventos. Este Maximum age of fetched events no debe ser más corto que el intervalo de check, pues de lo contrario podrían perderse eventos. Sin embargo, como puede ocurrir que Datadog cree eventos con una marca de tiempo que se encuentre en el pasado, el periodo de tiempo no debe ser demasiado corto. Los 10 minutos por defecto son un buen punto de partida.
Todos los demás campos de esta parte de la regla se refieren a los parámetros que deben utilizarse para crear los eventos de Datadog en la Consola de eventos de Checkmk. Encontrarás una descripción detallada de todos estos campos en el artículo Consola de eventos, en sus secciones Prioridad de syslog y Niveles de servicio e instalación.
Para los eventos, sólo se crea un único servicio en el host en Checkmk, que te informa de cuántos eventos se han transferido.
Obtener registros
También puedes importar logs de Datadog y evaluarlos mediante la Consola de eventos, básicamente igual que se acaba de describir para los eventos. En el campo Log search query, utiliza la sintaxis propia de Datadog para la búsqueda. Y también la composición del texto a reenviar mediante la opción Text of forwarded events se explica en la documentación de Datadog.
Establecer el host explícito y realizar el descubrimiento de servicios
Para asegurarte de que las monitorizaciones y eventos que obtengas de Datadog con esta regla sólo lleguen a un host, debes añadir al final el host creado anteriormente a Conditions > Explicit hosts. A continuación, haz clic en Save.. Una vez que hayas realizado un descubrimiento de servicios para este host, verás tus primeras monitorizaciones y eventos de Datadog en Checkmk.
Nota: En la práctica, se ha comprobado que puede ser conveniente poner monitorizaciones y eventos en hosts separados en Checkmk. Este enfoque generalmente aumenta la claridad y permite una configuración más fácil de los parámetros adicionales para cada host.
3. Mapeo de los estados
Los estados que se transfieren con las monitorizaciones desde Datadog no pueden transferirse 1:1 a los estados en Checkmk para cada caso de uso. Para darte la posibilidad de configurar estos estados según tus necesidades, encontrarás la regla Checking of Datadog monitors. Puedes encontrar esta regla buscando en el menú Setup, o en Setup > Services > Service monitoring rules > Applications, Processes & Services > Checking of Datadog monitors.
Además, en esta regla también puedes especificar qué tags de Datadog deben mostrarse en la salida del servicio en Checkmk.