 |
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 con Datadog está dirigida a todos nuestros usuarios que ya utilizan Datadog en sus organizaciones. Gracias a nuestra integración, hemos reducido la necesidad de estar checking 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 ambos sistemas, lo que agiliza el análisis de las causas raíz y, al mismo tiempo, facilita la comunicación entre los usuarios de Checkmk y Datadog.
1.2. Monitores y eventos de monitorización
En concreto, nuestra conexión permite la monitorización y la muestra de los llamados monitores y eventos de Datadog en Checkmk. Por supuesto, también puedes recibir notificaciones sobre eventos desde dentro de Checkmk de la forma habitual.
La integración de monitores y eventos de Datadog se realiza a través de un agente especial.
2. Configuración de la integración
2.1. Generar y copiar claves
Para la extracción de datos, nuestro agente especial utiliza la API de Datadog. Para proteger el acceso a esta API se necesitan dos claves: una clave API y una clave de aplicación. Te recomendamos crear dos claves nuevas para que las use Checkmk y utilizarlas exclusivamente para la recuperación de datos por parte de Checkmk.
En el momento de escribir este artículo, puedes encontrar las claves correspondientes o la opción para 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 encabezado «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 las dos claves en Checkmk más adelante, se recomienda copiarlas. Para ello, haz clic en la línea de la clave correspondiente y luego en «Copy».
Nota: Durante la redacción de este artículo, la ubicación de las claves ya ha cambiado una vez. Si no encuentras los elementos de menú descritos anteriormente, consulta la documentación de Datadog.
2.2. Creación de un host
Dependiendo de cómo quieras integrar Datadog en Checkmk, puede haber diferentes formas de asignar los datos obtenidos a los hosts en Checkmk. Más adelante hablaremos de esto. Por ahora, centrémonos en una configuración sencilla y asignemos todos los datos a un host.
Para ello, crea un nuevo host en Checkmk como de costumbre y asígnale un nombre como, por ejemplo, «mydatadoghost».
Dado que, por el momento, este host solo recibirá datos a través del agente especial, configura la opción «IP address family» (Agente de datos) en «No IP».
Configura el resto de ajustes según tu entorno y confirma tu selección a través de Save & view folder.
2.3. Creación de una regla para el agente de Datadog
A continuación, debes configurar el agente especial a través del conjunto de reglas Setup > Agents > Other integrations > Applications > Datadog. Primero, copia las dos claves que creaste anteriormente en los campos correspondientes o, si lo prefieres, utiliza el almacén de contraseñas de Checkmk. Después, comprueba si el API host introducido previamente coincide con el de tu instancia de Datadog. Para ello, solo tienes que comparar la URL de tu instancia de Datadog con la entrada predeterminada de la regla y modificarla si es necesario.
Si Checkmk se comunica 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 el llamado monitors y events.
Recuperar monitores de monitorización
Si habilitas la monitorización de monitores, tienes la opción de filtrar los datos que se van a transmitir utilizando tags dentro de Datadog.
Especialmente en entornos grandes, se recomienda etiquetar los monitores que quieres ver en Checkmk con una etiqueta adecuada en Datadog (por ejemplo, monitored_by_checkmk:yes).
A continuación, introduce estas etiquetas en Restrict by monitor tags.
Además, también es posible utilizar otras etiquetas que aparecen en la configuración del monitor en Datadog para el filtrado. Por ejemplo, podrías etiquetar hosts con «Checkmk:yes» en Datadog.
Si luego creas un monitor de host en Datadog que se refiera a todos los hosts con ese tag, también puedes usar ese mismo tag en Checkmk en Restrict by tags. De esta manera, con muy poco esfuerzo obtendrás todos los monitores de Datadog que contengan el tag «checkmk:yes». Por supuesto, esto funciona no solo para los tags del host, sino para todos los tags a partir de los cuales se pueden crear monitores en Datadog.
Si dejas ambas opciones desactivadas, todos los monitores se transferirán simplemente de Datadog a Checkmk.
Se creará un servicio en Checkmk por cada monitor de Datadog, que luego podrás supervisar en Checkmk.
Recuperar eventos
Con el agente especial para Datadog también tienes la posibilidad de transferir eventos desde Datadog directamente a la Consola de eventos de Checkmk. Para limitar qué eventos deben transferirse, puedes volver a utilizar etiquetas de Datadog. Además, puedes especificar un intervalo de tiempo desde el cual deben transferirse los eventos. Este «Maximum age of fetched events» no debe ser más corto que el intervalo de check, ya que de lo contrario podrían perderse eventos. Sin embargo, dado que puede ocurrir que Datadog cree eventos con una marca de tiempo que se remonta al pasado, el periodo de tiempo no debe ser demasiado corto. Los 10 minutos predeterminados 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 sobre la Consola de eventos, en las secciones «Prioridad y facilidad de syslog» y «Niveles de servicio».
Para los eventos, solo se crea un único servicio en el host en Checkmk, que te informa de cuántos eventos se han transferido.
Recuperar registros
También puedes importar registros desde Datadog y evaluarlos usando la Consola de eventos, básicamente tal y como se acaba de describir para los eventos. En el campo «Log search query», usa la sintaxis propia de Datadog para la búsqueda. Además, la composición del texto que se reenviará a través de la opción «Text of forwarded events» se explica en la documentación de Datadog.
Configuración de un host explícito y realización del descubrimiento de servicios
Para asegurarte de que los monitores y eventos que recuperas de Datadog con esta regla solo lleguen a un host, debes añadir el host creado anteriormente a Conditions > Explicit hosts al final. A continuación, haz clic en Save. Una vez que hayas realizado el descubrimiento de servicios para este host, verás tus primeros monitores y eventos de Datadog en Checkmk.
Nota: En la práctica, se ha comprobado que puede resultar conveniente colocar los monitores y eventos en hosts separados en Checkmk. Este enfoque suele aumentar la claridad y permite configurar más fácilmente los parámetros adicionales para cada host.
3. Mapeo de estados
Los estados que se transfieren con los monitores de Datadog no siempre se pueden transferir tal cual a los estados de Checkmk en todos los casos. Para que puedas configurar estos estados según tus necesidades, tienes 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.