Información general

Datadog ofrece múltiples opciones de configuración para la integración con Azure. Esta guía ofrece una visión general de las distintas opciones disponibles para empezar a trabajar con Azure, con enlaces a recursos y tutoriales de Azure que abordan casos de uso específicos.

Requisitos previos

Si aún no lo has hecho, crea una cuenta de Datadog.

En Azure

Tu usuario de Microsoft Entra ID necesita los siguientes permisos:

Permiso para crear un registro de aplicación

Una de las siguientes condiciones debe ser cierta para el usuario:

Roles administrativos en tus suscripciones

Dentro de las suscripciones que deseas monitorizar, debes tener:

  • El rol de Propietario
  • Tanto los roles Contributor como User Access Admin.

Permiso para añadir y conceder consentimiento para permisos de Graph API

El rol de administrador privilegiado contiene los permisos necesarios.

En Datadog

El Datadog Admin Role, o cualquier otro rol con el permiso azure_configurations_manage.

Cloud Cost Management y Log Archives requieren el método de configuración de registro de aplicaciones. Para las cuentas de Datadog que utilizan la integración de Azure Native, sigue los pasos de configuración en esta página para crear un registro de aplicación. Si una suscripción se conecta a través de ambos métodos, aparecerá una advertencia de redundancia en el cuadro de integración de Azure. Esta advertencia puede ignorarse con seguridad para Cloud Cost Management y Log Archives.

Instalación

Sigue las instrucciones de este página para configurar la integración con Azure a través de un registro de aplicación, disponible para todos los sitios de Datadog.

Elige el método de instalación Inicio rápido si…

  • Estás configurando Datadog por primera vez.
  • Prefieres un proceso basado en la interfaz de usuario y deseas minimizar el tiempo que se tarda en crear una entidad principal de servicio con los permisos de monitorización necesarios.
  • Deseas automatizar los pasos de configuración en scripts o pipelines de Continuous Integration Continuous Delivery.

Instrucciones

  1. En el cuadro de integración de Azure, haz clic en + Add New App registration (+Añadir nuevo registro de aplicación) y, a continuación, selecciona Quickstart (Inicio rápido).
  2. Copia el script de configuración y ejecútalo en el intérprete de comandos de Azure Cloud.
  3. Vuelve a la interfaz de usuario de Datadog. Deberías ver Connected (CONECTADO) en la esquina superior derecha del script de configuración.
  4. Selecciona las suscripciones y los grupos de gestión de los que recopilar datos.
  5. Opcionalmente, haz clic en el conmutador de recopilación de métricas para desactivar toda la recopilación de métricas de Azure. También puedes ampliar el menú desplegable Advanced Configuration (Configuración avanzada) para filtrar las métricas por:
    • Proveedor de recursos
    • Etiquetas
    • Hosts
    • App Service Plans
    • Container Apps

También puedes hacer clic para activar la recopilación de métricas personalizadas de Azure Application Insights y desactivar la recopilación de métricas de uso.

  1. Opcionalmente, haz clic en el conmutador de recopilación de recursos para desactivar la recopilación de información de configuración de tus recursos de Azure.

  2. Habilita la recopilación de logs para establecer y configurar los servicios y parámetros de diagnóstico necesarios para reenviar logs a Datadog:

    1. Si ya existe un reenviador de logs en el inquilino, se modifica para ampliar su alcance. Los ajustes modificados se aplican tanto a las suscripciones o grupos de gestión existentes como a los recién seleccionados.
    2. Si estás creando un nuevo reenviador de log:
      1. Introduce un nombre de grupo de recursos para almacenar el plano de control del reenviador de log
      2. Selecciona una suscripción de plano de control para la orquestación de reenvío de logs (LFO).
      3. Selecciona una región para el plano de control.
        Nota: Los campos de nombre de grupo de recursos, suscripción del plano de control y región solo aparecen al crear un nuevo reenviador de log.
    3. Opcionalmente, abre Log filtering options (Opciones de filtrado de logs) para filtrar logs por etiquetas, o aplicar filtros para información específica (como PII) usando expresiones regulares.

    Consulta la sección de Arquitectura de la guía de reenvío automatizado de logs para obtener más información sobre esta arquitectura.

  3. Haz clic en Confirm (Confirmar) para finalizar la configuración.

Elige el método de configuración de Terraform si…

  • Gestionas la infraestructura como código y deseas mantener la integración de Azure en Datadog bajo control de versiones.
  • Es necesario configurar varios inquilinos o suscripciones de forma coherente con bloques de proveedores reutilizables.
  • Deseas un proceso de despliegue repetible y auditable que se adapte a tu entorno gestionado por Terraform.

Instrucciones

Sigue estos pasos para desplegar la integración de Datadog y Azure a través de Terraform.

  1. En el cuadro de integración de Azure, haz clic en + Add New App registration (+Añadir nuevo registro de aplicación) y, a continuación, selecciona Terraform.
  2. Selecciona las suscripciones y los grupos de gestión de los que recopilar datos.
  3. Opcionalmente, haz clic en el conmutador de recopilación de métricas para desactivar toda la recopilación de métricas de Azure. También puedes ampliar el menú desplegable Advanced Configuration (Configuración avanzada) para filtrar las métricas por:
    • Proveedor de recursos
    • Etiquetas
    • Hosts
    • App Service Plans
    • Container Apps

También puedes hacer clic para activar la recopilación de métricas personalizadas de Azure Application Insights y desactivar la recopilación de métricas de uso.

  1. Opcionalmente, haz clic en el conmutador de recopilación de recursos para desactivar la recopilación de información de configuración de tus recursos de Azure.

  2. Configurar la recopilación de logs: a. Si ya existe un reenviador de log en el inquilino, amplía su alcance para incluir las nuevas suscripciones o grupos de gestión. b. Si estás creando un nuevo reenviador de log: a. Introduce un nombre de grupo de recursos para almacenar el plano de control del reenviador de log. b. Selecciona una suscripción de plano de control para la orquestación de reenvío de logs (LFO). c. Selecciona una región para el plano de control. Consulta la sección de Arquitectura de la guía de reenvío automatizado de logs para obtener más información sobre esta arquitectura.

  3. Copia y ejecuta el comando en Initialize and apply the Terraform (Inicializar y aplicar el Terraform).

  • Ya tienes un registro de aplicación configurado con el rol Monitoring Reader para Datadog para monitorizar el ámbito proporcionado (suscripciones o grupos de gestión), y no deseas crear nuevos recursos.
  1. Configura el proveedor de Terraform en Datadog]200 para interactuar con la API de Datadog a través de una configuración de Terraform.

  2. Configura tu archivo de ajustes de Terraform utilizando el siguiente ejemplo como plantilla base. Asegúrate de actualizar los siguientes parámetros antes de aplicar los cambios:

    • tenant_name: tu ID de Azure Active Directory.
    • client_id: tu ID de aplicación (cliente) de Azure.
    • client_secret: tu clave secreta de aplicación web de Azure.

    Consulta la página de Recursos de la integración de Azure con Datadog en el registro de Terraform para obtener más ejemplos de uso y la lista completa de parámetros opcionales, así como recursos adicionales de Datadog.

resource "datadog_integration_azure" "sandbox" {
  tenant_name   = "<AZURE_TENANT_NAME>"
  client_id     = "<AZURE_CLIENT_ID>"
  client_secret = "<AZURE_CLIENT_SECRET_KEY>"
}
  1. Ejecuta terraform apply. Espera hasta 10 minutos para que comiencen a recopilarse los datos y, a continuación, consulta el dashboard de información general de Azure listo para usar a fin de ver las métricas enviadas por tus recursos de Azure.

Gestión de varias suscripciones o inquilinos

Puedes usar varios bloques de proveedores con alias para gestionar recursos de Terraform en varias suscripciones o inquilinos. Lee la configuración del proveedor para obtener más información.

Monitorizar el estado de la integración

Una vez que se haya configurado la integración, Datadog comienza a ejecutar una serie continua de llamadas a las APIs de Azure para recopilar datos de monitorización críticos de tu entorno de Azure. A veces, estas llamadas devuelven errores (por ejemplo, si las credenciales proporcionadas han expirado). Estos errores pueden inhibir o bloquear la capacidad de Datadog para recopilar datos de monitorización.

Cuando se detectan errores críticos, la integración de Azure genera eventos en el explorador de eventos de Datadog y los vuelve a publicar cada cinco minutos. Puedes configurar un monitor de eventos para que se active cuando se detecten estos eventos y notifique al equipo correspondiente.

Datadog proporciona una plantilla de monitor para ayudarte a empezar. Para utilizar la plantilla de monitor:

  1. En Datadog, ve a Monitors (Monitores) y haz clic en el botón Browse Templates (Buscar plantillas).
  2. Busca y selecciona la plantilla de monitor titulada Errores de integración de [Azure].
  3. Realiza las modificaciones que quieras en la consulta de búsqueda o en las condiciones de alerta. De manera predeterminada, el monitor se activa cuando se detecta un error nuevo y se resuelve cuando no se ha detectado el error durante los últimos 15 minutos.
  4. Actualiza los mensajes de notificación y notificación nueva según lo consideres. Ten en cuenta que los eventos en sí contienen información relevante sobre el evento y se incluyen en la notificación de manera automática. Esto incluye información detallada sobre el contexto, la respuesta a errores y los pasos comunes para solucionarlos.
  5. Configura notificaciones a través de tus canales preferidos (correo electrónico, Slack, PagerDuty u otros) para asegurarte de que tu equipo esté alerta sobre los problemas que afectan la recopilación de datos de Azure.

Elige el método de configuración de registro de aplicación existente si..

  • Ya tienes un registro de aplicación configurado con el rol Monitoring Reader para Datadog para monitorizar el ámbito proporcionado (suscripciones o grupos de gestión), y no deseas crear nuevos recursos.

Si necesitas configurar un registro de aplicación para Datadog, consulta los métodos de configuración de Quickstart o Terraform.

Instrucciones

  1. En el cuadro de integración de Datadog Azure, selecciona Add Existing (Añadir existente).
  2. En el campo **Tenant ID (ID de inquilino), pega tu ID de directorio (inquilino).
  3. En el campo Client ID (ID de cliente), pega el ID de la aplicación (cliente).
  4. En el campo Client Secret Value (Valor del secreto del cliente), pega el valor del secreto del cliente del registro de la aplicación.
  5. Opcionalmente, haz clic en el conmutador Monitor Automuting (Automatización del monitor) para desactivar la automatización del monitor.
  6. Opcionalmente, haz clic en el conmutador de recopilación de métricas para desactivar toda la recopilación de métricas de Azure. También puedes ampliar el menú desplegable Advanced Configuration (Configuración avanzada) para filtrar las métricas por:
    • Proveedor de recursos
    • Etiquetas
    • Hosts
    • App Service Plans
    • Container Apps

También puedes hacer clic para activar la recopilación de métricas personalizadas de Azure Application Insights y desactivar la recopilación de métricas de uso.

  1. Opcionalmente, haz clic en el conmutador de recopilación de recursos para desactivar la recopilación de información de configuración de tus recursos de Azure.
  2. Haz clic en Create Configuration (Crear configuración).

Recopilación de métricas

La integración de Azure de Datadog está diseñada para recopilar todas las métricas del monitor de Azure. La página de integraciones muestra una lista de subintegraciones predefinidas que proporcionan dashboards y monitores adicionales para servicios de Azure específicos. Muchas de estas integraciones se instalan por defecto cuando Datadog reconoce los datos procedentes de tu cuenta de Azure. Sin embargo, Datadog puedes ingerir métricas de cualquier recurso compatible con el monitor de Azure, incluso si no tiene un cuadro de subintegración dedicado.

Puedes encontrar tus métricas de Azure en la página de resumen de métricas en la plataforma de Datadog navegando a Metrics > Summary y buscando Azure.

Imagen de resumen de métricas

Activar la recopilación de log

Puedes utilizar la función de reenvío automatizado de logs para establecer y configurar los servicios y los parámetros de diagnóstico necesarios para reenviar logs a Datadog. Si ya existe un plano de control de reenvío automatizado de logs en el inquilino, este flujo lo modifica y amplía su alcance para incluir las suscripciones o los grupos de gestión seleccionados. Para obtener más detalles, consulta Azure Automated Log Forwarding Setup.

Datadog recomienda utilizar el Agent o DaemonSet para enviar logs desde Azure. Si la transmisión directa no es posible, puedes utilizar una plantilla de Azure Resource Manager (ARM) para automatizar la configuración de reenvío de logs en todo tu entorno de Azure sin configuración manual. Esta función gestiona y escala automáticamente los servicios de reenvío de logs.

Elige el método de configuración de reenvío automatizado de logs si…

  • Todavía no has configurado logs a través del Método de configuración rápida.
  • Prefieres un proceso basado en la interfaz de usuario y deseas minimizar el tiempo que se tarda en crear una entidad principal de servicio con los permisos de monitorización necesarios.
  • Deseas automatizar los pasos de configuración en scripts o pipelines de Continuous Integration Continuous Delivery.

Instrucciones

  1. Abre la plantilla ARM de reenvío automatizado de logs en Azure.
  2. Configura tu proyecto de Azure y los detalles de la instancia en la pestaña Ajustes básicos.
  3. Introduce tus credenciales de Datadog en la pestaña de Configuración de Datadog.
  4. Reconoce las advertencias de despliegue en la pestaña de Despliegue.
  5. Inicia el proceso de despliegue en la pestaña Review + create (Revisar + crear).
Los Log Archives requieren el método de configuración de registro de aplicaciones. Para las cuentas de Datadog que utilizan la integración de Azure Native, sigue los pasos de esta página para crear un registro de aplicación.

Consulta Azure Automated Log Forwarding Architecture para obtener más detalles.

Elige el método de reenvío de logs de Container App si…

Instrucciones

  1. Haz clic en el botón siguiente y rellena el formulario en el portal de Azure. Datadog despliega automáticamente los recursos de Azure necesarios para reenviar logs a tu cuenta de Datadog.

    Despliegue en Azure

  2. Una vez finalizado el despliegue de la plantilla, configura la configuración de diagnóstico de cada fuente de logs para enviar logs de la plataforma de Azure (incluidos logs de recursos) a la cuenta de almacenamiento creada durante el despliegue.

Nota: Los recursos solo pueden transmitirse a una cuenta de almacenamiento en la misma región de Azure.

Log archiving

Archiving logs to Azure Blob Storage requires an App Registration. If you haven’t already, follow the automatic or manual setup instructions to configure the integration using an App Registration. App Registrations created for archiving purposes do not need the Monitoring Reader role.

After configuring an App Registration, create a log archive that writes to Azure Blob Storage.

Note: If your storage bucket is in a subscription being monitored through the Azure Native integration, a redundancy warning appears in the Azure integration tile. This warning can be safely ignored for log archiving.

Obtén más información de la plataforma de Datadog

Instala el Agent para obtener una mayor visibilidad de tu aplicación.

Después de configurar tu integración con Azure, los rastreadores de Datadog recopilan automáticamente las métricas de Azure, pero puedes obtener una mayor visibilidad de tus instancias de Azure con el Datadog Agent. La instalación del Datadog Agent en tu entorno te permite recopilar datos adicionales que incluyen, entre otros:

  • Estado de la aplicación
  • Utilización del proceso
  • Métricas a nivel de sistema

También puedes utilizar el cliente StatsD incorporado para enviar métricas personalizadas desde tus aplicaciones, para correlacionar lo que está sucediendo con tus aplicaciones, usuarios y sistema. Consulta la guía sobre ¿Por qué debería instalar el Datadog Agent en mis instancias en la nube? para obtener más información sobre las ventajas de instalar el Datadog Agent en tus instancias.

Utiliza la extensión de Azure para instalar el Datadog Agent en VMs de Windows, Linux x64 y Linux ARM. También puedes utilizar AKS Cluster Extension para desplegar el Agent en tus clústeres de AKS.

  1. En Azure Portal, selecciona la VM adecuada.
  2. En la barra lateral izquierda, en Settings (Configuración), selecciona **Extensions + applications (Extensiones + aplicaciones).
  3. Haz clic en + Add (+ Añadir).
  4. Busca y selecciona la extensión Datadog Agent.
  5. Haz clic en Siguiente.
  6. Ingresa tu clave de API de Datadog y sitio de Datadog, y haz clic en OK (Aceptar).

Para instalar el Agent en función del sistema operativo o herramienta de CI y CD, consulta las instrucciones de instalación del Datadog Agent.

Nota: Los controladores de dominio no son compatibles al instalar el Datadog Agent con la extensión de Azure.

Datadog AKS Cluster Extension te permite desplegar el Datadog Agent de forma nativa en Azure AKS, evitando la complejidad de las herramientas de gestión de terceros. Para instalar el Datadog Agent con AKS Cluster Extension:

  1. Dirígete a tu clúster de AKS en Azure Portal.
  2. En la barra lateral izquierda del clúster de AKS, selecciona Extensions + applications (Extensiones + aplicaciones) en Settings (Configuración).
  3. Busca y selecciona Datadog AKS Cluster Extension (Extensión del clúster de AKS de Datadog).
  4. Haz clic en Create (Crear) y sigue las instrucciones del cuadro con tus credenciales de Datadog y el sitio de Datadog.

Solucionar problemas

Consulta Solución de problemas en la guía de configuración avanzada de Azure.

¿Necesitas más ayuda? Ponte en contacto con el servicio de asistencia de Datadog.

Referencias adicionales