Introducción a las integraciones
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 manage_integrations es necesario para interactuar con un cuadro de integración. Ver roles RBAC para obtener más información.
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. Cada una cuenta 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.
- Reinicia el Datadog Agent.
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:
init_config:
service: apache
instances:
- apache_status_url: http://localhost/server-status?auto
logs:
- type: file
path: /var/log/apache2/access.log
source: apache
sourcecategory: http_web_access
- type: file
path: /var/log/apache2/error.log
source: apache
sourcecategory: http_web_access
Si deseas monitorear varias instancias de Apache en el mismo check del Agent, añade más instancias a la sección instances:
init_config:
instances:
- apache_status_url: "http://localhost/server-status?auto"
service: local-apache
- apache_status_url: "http://<REMOTE_APACHE_ENDPOINT>/server-status?auto"
service: remote-apache
Intervalo de recopilación
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 (tags) 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 monitorear 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.
De forma predeterminada, las métricas que envían las integraciones incluyen etiquetas del entorno detectadas automáticamente. Por ejemplo, las métricas que envía un check de Redis ejecutadas dentro de un contenedor incluyen etiquetas que hacen referencia a dicho contenedor, como image_name. Si deseas desactivar este comportamiento, configura el parámetro ignore_autodiscovery_tags con el valor true:
init_config:
ignore_autodiscovery_tags: true
# 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.
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 automáticamente
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 monitorear estas tecnologías. Estas integraciones detectadas automáticamente se muestran en la sección de búsqueda de Integrations (Integraciones):
Cada integración tiene uno de estos tres tipos de estado:
- 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 autodetectada, abre el cuadro de integraciones y selecciona la pestaña hosts.
- Instalada: esta integración está instalada y configurada en un host.
- Disponible: todas las integraciones que no entran en las categorías Instalada y Detectada.
Protocolos de seguridad
Para obtener información sobre cómo Datadog maneja tus datos y otras cuestiones de seguridad, consulta la documentación acerca de la seguridad.
¿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 monitorear tus datos.
Consulta también las siguientes soluciones de Datadog: Log Management, APM y la Synthetic Monitoring.
Solucionar problemas
El primer paso para solucionar problemas de integración es utilizar un plugin en tu editor de código o utilizar una de las numerosas herramientas disponibles en línea para verificar que el YAML es válido. A continuación, ejecuta todos los pasos descritos en Solucionar problemas del Agent.
Si sigues teniendo problemas, ponte en contacto con el equipo de asistencia de Datadog.
Términos clave
conf.yaml- 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 monitorearlo, o si vas a ampliar las métricas ya enviadas por una integración, puedes crear un check personalizado para definir y enviar métricas a Datadog. Sin embargo, si lo que quieres es monitorear 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á monitoreando. Por ejemplo, en la integración http_check, defines el nombre asociado a la instancia del endpoint HTTP que vas a monitorear durante los tiempos de actividad y caída del sistema. Puedes monitorear 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 brinda 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 realizar 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 (tags) te permiten personalizar las métricas para que puedas filtrarlas y visualizarlas de la forma que te resulte más útil.
Leer más
Más enlaces, artículos y documentación útiles:
