En esta guía, te explicamos cómo utilizar las integraciones. Si lo que buscas es información sobre cómo crear una integración nueva, consulta la página Crear una nueva integración.
Una integración, al más alto nivel, se produce cuando se ensambla un sistema unificado a partir de unidades que normalmente se consideran por separado. En Datadog, puedes utilizar integraciones para reunir todas las métricas y registros de tu infraestructura y obtener información sobre el sistema unificado como un todo: puedes ver las secciones de forma individual, así como el impacto que estas tienen sobre el conjunto.
Nota: Lo mejor es empezar a recopilar métricas sobre tus proyectos desde la fase más temprana posible del proceso de desarrollo, pero puedes empezar en cualquier momento.
Datadog ofrece tres tipos principales de integraciones:
Integraciones basadas en el Agent que se instalan con el Datadog Agent y utilizan un método de clase Python denominado check para definir las métricas que se deben recopilar.
Integraciones basadas en (un rastreador de) autenticación que se configuran en Datadog y donde el usuario debe introducir las credenciales para obtener métricas con la API. Entre ellas, hay integraciones tan populares como Slack, AWS, Azure y PagerDuty.
Integraciones de bibliotecas que utilizan la API de Datadog para poder monitorizar aplicaciones en función del lenguaje en el que estén redactadas, como, por ejemplo, Node.js o Python.
También puedes crear un check personalizado para definir y enviar métricas a Datadog desde tu propio sistema interno.
Configurar una integración
El paquete del Datadog Agent incluye integraciones compatibles oficialmente con Datadog en el núcleo de integraciones. Para poder utilizar esas integraciones, es necesario descargar el Datadog Agent. Las integraciones basadas en la comunidad se encuentran en integraciones adicionales. Para obtener más información sobre cómo instalar o gestionar estas integraciones, consulta la guía de gestión de integraciones.
Permisos
El permiso de gestión de integraciones es necesario para interactuar con el cuadro de una integración. Para obtener más información, consulta Roles RBAC.
Claves de API y de aplicación
Para instalar el Datadog Agent, necesitas una clave de API. Si ya te has descargado el Agent, recuerda configurar la clave de API en el archivo datadog.yaml. Además, es necesaria una clave de aplicación para utilizar la mayoría de las funcionalidades adicionales de Datadog, así como para enviar métricas y eventos. Puedes gestionar las claves de API y de aplicación de tus cuentas en la página de Configuración de la API.
Instalación
En caso de que quieras conectarte con una integración basada en un rastreador o biblioteca, accede a ese proveedor a través de la página de Integrations (Integraciones) para consultar las instrucciones específicas para conectarte. Para el resto de las integraciones compatibles, instala el Datadog Agent. La mayoría de las integraciones son compatibles con los siguientes Agents contenedorizados: Docker y Kubernetes. Después de descargar el Agent, ve a la página de Integraciones para consultar las instrucciones de configuración específicas de cada integración.
Configurar las integraciones del Agent
La mayoría de los parámetros de configuración son propios de cada integración. Accede a la carpeta conf.d en la raíz del directorio de configuración de tu Agent para configurar las integraciones. Todas cuentan con una carpeta llamada <INTEGRATION_NAME>.d que contiene el archivo conf.yaml.example. En el siguiente archivo de ejemplo, se muestran todas las opciones de configuración disponibles para la integración en cuestión.
Para activar una integración concreta:
Cambia el nombre del archivo conf.yaml.example (en la carpeta de <INTEGRATION_NAME>.d correspondiente) a conf.yaml.
Actualiza los parámetros obligatorios dentro del archivo de configuración que acabas de crear con los valores que se correspondan con tu entorno.
Nota: Todos los archivos de configuración siguen el formato que se describe en la especificación @param.
A continuación, puedes ver un ejemplo del archivo de configuración conf.yaml mínimo necesario para recopilar métricas y logs de la integración de Apache:
El intervalo de recopilación predeterminado para todas las integraciones estándar de Datadog es de 15 segundos. Si quieres cambiar este intervalo, utiliza el parámetro min_collection_interval. Para obtener más información, consulta la sección Actualizar el intervalo de recopilación.
Etiquetado
El etiquetado es clave para filtrar y agregar los datos que llegan a Datadog desde diversas fuentes. Para obtener más información sobre el etiquetado, consulta Empezando con las etiquetas (tags).
Si defines etiquetas en el archivo datadog.yaml, se aplicarán a todos los datos de tus integraciones. Una vez que definas una etiqueta en datadog.yaml, la heredarán todas las nuevas integraciones.
Por ejemplo, la configuración del Agent recomendada para monitorizar sistemas separados e independientes consiste en definir service en tu archivo de configuración.
También es recomendable configurar la etiqueta env en el Agent para unificar mejor el entorno. Si deseas obtener más información, consulta Etiquetado de servicios unificado.
Configuración de etiquetas por cada check
Puedes personalizar el comportamiento de las etiquetas de cada check sobreescribiendo la configuración global de Agent:
Desactivar las etiquetas de Autodiscovery
Por defecto, las métricas informadas por las integraciones incluyen etiquetas detectadas automáticamente en el entorno. Por ejemplo, las métricas informadas por un check Redis que se ejecuta dentro de un contenedor incluyen etiquetas asociadas al contenedor, como image_name. Puedes desactivar este comportamiento configurando el parámetro ignore_autodiscovery_tags como true.
Configurar la cardinalidad de las etiquetas por cada check de integración
Puedes definir el nivel de cardinalidad de las etiquetas (bajo, orquestador o elevado) por cada check utilizando el parámetro check_tag_cardinality. Esta acción sobreescribe la configuración global de la cardinalidad de las etiquetas definida en la configuración del Agent.
init_config:# Ignores tags coming from autodiscoveryignore_autodiscovery_tags:true# Override global tag cardinality settingcheck_tag_cardinality:low# Rest of the config here
Validación
Para validar la configuración de tu Agent y tus integraciones, ejecuta el subcomando status del Agent y busca la nueva configuración en la sección Checks (Comprobaciones).
Instalar varias integraciones
Para instalar más de una integración, basta con añadir la información de configuración en un nuevo archivo conf.yaml dentro de la carpeta <INTEGRATIONS>.d correspondiente. Busca los parámetros necesarios para la nueva integración en el archivo conf.yaml.example, añádelos al nuevo archivo conf.yaml y sigue los mismos pasos para validar tu configuración.
Integraciones detectadas de manera automática
Si configuras la recopilación de procesos, Datadog detectará de forma automática las tecnologías que se ejecutan en tus hosts. De este modo, se identificarán las integraciones de Datadog que pueden ayudarte a monitorizar estas tecnologías. Estas integraciones detectadas automáticamente se muestran en la búsqueda de integraciones:
Cada integración tiene uno de los cuatro tipos de estado:
Detected (Detectada): la tecnología se está ejecutando en un host, pero la integración no está instalada ni configurada y solo se recopilan métricas parciales. Configura la integración para obtener una cobertura completa. Para encontrar una lista de hosts que estén ejecutando una tecnología detectada automáticamente, abre el cuadro de integraciones y selecciona la pestaña Hosts.
Installed (Instalada): esta integración está instalada y configurada en un host.
Available (Disponible): todas las integraciones que no entran en las categorías Installed y Detected.
Faltan datos: No se detectaron métricas de integración en las últimas 24 horas.
Por defecto, el acceso a los recursos de una integración (cuentas, servicios, webhooks) no está restringido. Se pueden utilizar controles de acceso granulares para restringir el comportamiento de usuarios, equipos, funciones o toda la organización a nivel de recursos de la integración.
Nota: La opción de acceso restringido sólo es visible si integración admite el control de acceso granular. Para verificar si el control de acceso granular es compatible con una integración, consulta la documentación de la integración.
Mientras visualizas una integración, ve a la pestaña Configurar y busca el recurso (cuenta, servicio, webhook) al que deben aplicarse controles de acceso granular.
Haz clic en Set Permissions (Configurar permisos).
Por defecto, todos los miembros de tu organización tienen acceso total. Haz clic en Restrict Access (Restringir el acceso).
El cuadro de diálogo se actualiza para mostrar que los miembros de tu organización tienen por omisión el permiso de acceso Viewer (Visualización).
Utiliza el menú desplegable para seleccionar uno o varios roles, equipos o usuarios que pueden editar el monitor.
Nota: El permiso de gestión de integraciones también es necesario para editar recursos individuales.
Haz clic en Add (Añadir).
El cuadro de diálogo se actualiza para mostrar los permisos actualizados.
Haz clic en Save (Guardar). La página de la integración se actualiza automáticamente con los permisos actualizados.
Nota: Para mantener el acceso de edición al recurso, el sistema requiere que incluyas al menos un rol o equipo al que pertenezcas antes de guardar.
Para restablecer el acceso general a un recurso de integración con acceso restringido, sigue estos pasos:
Mientras visualizas una integración, ve a la pestaña Configurar y busca el recurso (cuenta, servicio, webhook) al que se debe restablecer el acceso general.
Haz clic en Set Permissions (Configurar permisos).
Haz clic en Restore Full Access (Restablecer acceso completo).
Haz clic en Save (Guardar). La página de la integración se actualiza automáticamente con los permisos actualizados.
¿Qué toca hacer ahora?
Después de configurar tu primera integración, explora todas las métricas que tu aplicación envía a Datadog y utilízalas para empezar a configurar dashboards y alertas para monitorizar tus datos.
El primer paso para solucionar problemas de integración es utilizar un plugin en tu editor de código o elegir alguna de las numerosas herramientas disponibles online para verificar que el YAML es válido. A continuación, ejecuta todos los pasos descritos en Solucionar problemas del Agent.
Crea el archivo conf.yaml en la carpeta conf.d/<INTEGRATION_NAME>.d, en la raíz del directorio de configuración del Agent, y utilízalo para conectar integraciones a tu sistema y para configurar sus ajustes.
check personalizado
Si tienes un sistema único y quieres monitorizarlo, o si vas a ampliar las métricas que ya se envían mediante una integración, puedes crear un check personalizado para definir y enviar métricas a Datadog. Sin embargo, si quieres monitorizar una aplicación disponible de forma general, un servicio público o un proyecto de código abierto, y la integración no existe, puedes crear una nueva integración en lugar de un check personalizado.
datadog.yaml
Se trata del archivo de configuración principal donde debes definir cómo interactúa el Agent en su totalidad con sus propias integraciones y con tu sistema. Utiliza este archivo para actualizar claves de API, proxies, etiquetas de host y otros ajustes generales.
evento
Los eventos son mensajes informativos sobre tu sistema que el explorador de eventos utiliza para que puedas crear monitores a partir de ellos.
instancia
En el archivo conf.yaml, se define y asigna la instancia de lo que se está monitorizando. Por ejemplo, en la integración http_check, defines el nombre asociado a la instancia del endpoint HTTP que vas a monitorizar durante los tiempos de actividad y caída del sistema. Puedes monitorizar varias instancias en la misma integración al definir todas las instancias en el archivo conf.yaml.
<INTEGRATION_NAME>.d
Si se trata de una configuración compleja, puedes dividirla en varios archivos YAML y, después, almacenarlos todos en la carpeta <INTEGRATION_NAME>.d para definir la configuración. El Agent carga cualquier archivo YAML válido en la carpeta <INTEGRATION_NAME>.d.
logs
Si el sistema que estás monitorizando tiene logs, personaliza los que envías a Datadog con la solución Log Management.
metadata.csv
Archivo que muestra una lista de las métricas recopiladas por cada integración y las almacena.
métricas
La lista que cada integración recopila de tu sistema. Puedes encontrar las métricas de cada integración en el archivo metadata.csv de cada integración en particular. Para obtener más información sobre las métricas, consulta la página para desarrolladores Métricas. También puedes configurar métricas personalizadas; de modo que si la integración no ofrece una métrica de forma predeterminada, puedes añadirla.
parámetros
Utiliza los parámetros del archivo conf.yaml para controlar los accesos entre tu fuente de datos de la integración y el Agent. El archivo conf.yaml.example de las integraciones incluye una lista con todos los parámetros obligatorios y opcionales.
Check de servicio
Los checks de servicio son un tipo de monitor que se utiliza para hacer un seguimiento del estado del tiempo de actividad del servicio. Para obtener más información, consulta la guía sobre checks de servicio.
Etiquetado
Las etiquetas te permiten personalizar las métricas para que puedas filtrarlas y visualizarlas de la forma que te resulte más útil.
