Descripción general

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

Requisitos previos

Si aún no lo ha hecho, cree una cuenta de Datadog.

En Azure

Su usuario de Microsoft Entra ID necesita los siguientes permisos:

Permiso para crear un registro de aplicación

Debe cumplirse una de las siguientes condiciones para el usuario:

Roles de administrador dentro de sus suscripciones

Dentro de las suscripciones que desea monitorear, debe tener ya sea:

  • El rol de Owner
  • Tanto el rol de Contributor como el rol de User Access Admin

El rol de Administrador de Roles Privilegiados contiene los permisos requeridos.

En Datadog

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

Cloud Cost Management y Log Archives requieren el método de configuración de registro de aplicación. Para cuentas de Datadog que utilizan la integración nativa de Azure, siga los pasos de configuración en esta página para crear un registro de aplicación. Si una suscripción está conectada a través de ambos métodos, aparece una advertencia de redundancia en el mosaico de integración de Azure. Esta advertencia se puede ignorar de manera segura para Cloud Cost Management y Log Archives.

Configuración

Siga las instrucciones en esta página para configurar el Azure integration a través de un registro de aplicación, disponible para todos los sitios de Datadog.

Elija el método de configuración de inicio rápido si…

  • Está configurando Datadog por primera vez.
  • Prefiere un flujo de trabajo basado en UI y desea minimizar el tiempo que se necesita para crear un principal de servicio con los permisos de monitoreo requeridos.
  • Desea automatizar los pasos de configuración en scripts o en pipelines de CI/CD.

Instrucciones

  1. En el mosaico de integración de Azure, haga clic en
  2. Add New App registration
  3. , luego seleccione Quickstart. 2. Copie el script de configuración y ejecútelo en Azure Cloud Shell. 3. Regrese a la interfaz de usuario de Datadog. Deberá ver CONNECTED en la esquina superior derecha del script de configuración. 4. Seleccione las suscripciones y los grupos de administración de los cuales desea recopilar datos. 5. Opcionalmente, haga clic en el interruptor de recopilación de métricas para deshabilitar toda la recopilación de métricas de Azure. También puede expandir el menú desplegable Advanced Configuration para filtrar métricas por: - Proveedor de recursos - Etiquetas - Servidores - Planes de App Service - Container Apps

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

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

    2. Habilita la recopilación de registros para configurar y establecer los servicios y ajustes de diagnóstico necesarios para enviar registros a Datadog:

      1. Si ya existe un reenvío de registros en el inquilino, se modifica para ampliar su alcance. Cualquier configuración cambiada se aplica a las suscripciones o grupos de administración existentes, así como a los recién seleccionados.
      2. Si estás creando un nuevo reenvío de registros:
        1. Ingresa un nombre de grupo de recursos para almacenar el plano de control del reenvío de registros.
        2. Selecciona una suscripción del plano de control para la orquestación del reenvío de registros (LFO).
        3. Selecciona una región para el plano de control.
          Nota: El nombre del grupo de recursos, la suscripción del plano de control y los campos de región solo aparecen al crear un nuevo reenvío de registros.
      3. Opcionalmente, abre Log filtering options para filtrar registros por etiquetas, o aplica filtrado para información específica (como PII) usando regex.

      Consulta la sección de Arquitectura de la guía de reenvío automático de registros para más información sobre esta arquitectura.

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

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

    • Gestione infraestructura como código y mantenga la integración de Datadog Azure bajo control de versiones.
    • Necesita configurar múltiples inquilinos o suscripciones de manera consistente con bloques de proveedor reutilizables.
    • Desea un proceso de implementación repetible y auditable que se ajuste a su entorno gestionado por Terraform.

    Instrucciones

    Siga estos pasos para implementar la integración de Datadog Azure a través de Terraform.

    1. En el mosaico de integración de Azure, haga clic en
    2. Add New App registration
    3. , luego seleccione Terraform. 2. Seleccione las suscripciones y los grupos de administración de los cuales desea recopilar datos. 3. Opcionalmente, haga clic en el interruptor de recopilación de métricas para deshabilitar toda la recopilación de métricas de Azure. También puede expandir el menú desplegable Advanced Configuration para filtrar métricas por: - Proveedor de recursos - Etiquetas - Servidores - App Service Plans - Aplicaciones de Contenedor

      También puede hacer clic para habilitar la recopilación de métricas personalizadas desde Azure Application Insights, y deshabilitar la recopilación de métricas de uso. 4. Opcionalmente, haga clic en el interruptor de recopilación de recursos para deshabilitar la recopilación de información de configuración de sus recursos de Azure. 5. Configure la recopilación de registros:

      • Si ya existe un reenvío de registros en el inquilino, amplíe su alcance para incluir nuevas suscripciones o grupos de administración.
      • Si está creando un nuevo reenvío de registros:
        1. Ingrese un nombre de grupo de recursos para almacenar el plano de control del reenvío de registros.
        2. Seleccione una suscripción del plano de control para la orquestación de reenvío de registros (LFO).
        3. Seleccione una región para el plano de control.

      Consulte la sección de Arquitectura de la guía de reenvío de registros automatizado para obtener más información sobre esta arquitectura. 6. Copie y ejecute el comando bajo Initialize and apply the Terraform.

      • Ya tiene un registro de aplicación configurado con el rol Monitoring Reader para que Datadog monitoree el alcance proporcionado (suscripciones o grupos de administración), y no desea crear nuevos recursos.
      1. Configure el proveedor de Datadog Terraform para interactuar con la API de Datadog a través de una configuración de Terraform.

      2. Configure su archivo de configuración de Terraform utilizando el ejemplo a continuación como plantilla base. Asegúrese de actualizar los siguientes parámetros antes de aplicar los cambios:

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

        Consulte la página de integración de Datadog con Azure 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. Ejecute terraform apply. Espere hasta 10 minutos para que los datos comiencen a ser recolectados, y luego visualice el Azure overview dashboard para ver las métricas enviadas por sus recursos de Azure.

      Gestionando múltiples suscripciones o inquilinos

      Puede usar múltiples bloques de proveedor con alias para gestionar recursos de Terraform a través de múltiples suscripciones o inquilinos. Lea Configuración del Proveedor para obtener más información.

      Monitoree el estado de la integración

      Después de que la integración esté configurada, Datadog comienza a efectuar una serie continua de llamadas a las APIs de Azure para recolectar datos críticos de monitoreo de su 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 recolectar datos de monitoreo.

      Cuando se encuentran 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 Seguimiento de Eventos para que se active cuando se detecten estos eventos y notificar al equipo correspondiente.

      Datadog proporciona una plantilla de seguimiento para ayudarte a comenzar. Para usar la plantilla de seguimiento:

      1. En Datadog, ve a Monitors y haz clic en el botón Browse Templates.
      2. Busca y selecciona la plantilla de seguimiento titulada [Azure] Errores de Integración.
      3. Realiza las modificaciones deseadas en la consulta de búsqueda o en las condiciones de alerta. Por defecto, el seguimiento se activa cada vez que se detecta un nuevo error y se resuelve cuando no se ha detectado el error en los últimos 15 minutos.
      4. Actualiza los mensajes de notificación y re-notificación según lo desees. Ten en cuenta que los eventos en sí contienen información pertinente sobre el evento y se incluyen automáticamente en la notificación. Esto incluye información detallada sobre el contexto, la respuesta de error y los pasos comunes para remediar.
      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 problemas que afecten la recolecció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 que Datadog monitoree el alcance proporcionado (suscripciones o grupos de administración), y no deseas crear nuevos recursos.

      Si necesitas configurar un registro de aplicación para Datadog, consulta los métodos de configuración Guía Rápida o Terraform.

      Instrucciones

      1. En el mosaico de integración de Datadog Azure, selecciona Add Existing.
      2. En el campo Tenant ID, pega tu ID de Directorio (inquilino).
      3. En el campo Client ID, pega el ID de la aplicación (cliente).
      4. En el campo Client Secret Value, pega el valor del secreto del cliente del registro de la aplicación.
      5. Opcionalmente, haz clic en el interruptor Monitor Automuting para desactivar la automatización del seguimiento.
      6. Opcionalmente, haz clic en el interruptor de recolección de métricas para desactivar toda la recolección de métricas de Azure. También puedes expandir el Advanced Configuration menú desplegable para filtrar métricas por:
        • Proveedor de recursos
        • Etiquetas
        • Hosts
        • Planes de servicio de aplicaciones
        • Aplicaciones de contenedor

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

      1. Opcionalmente, haz clic en el interruptor de colecció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.

      Recopilación de métricas

      La integración de Azure de Datadog está diseñada para recopilar todas las métricas de Azure Monitor. La página de Integraciones muestra una lista curada de sub-integraciones predefinidas que proporcionan paneles y monitores adicionales listos para usar para servicios específicos de Azure. Muchas de estas integraciones se instalan por defecto cuando Datadog reconoce datos provenientes de tu cuenta de Azure. Sin embargo, Datadog puede ingerir métricas de cualquier recurso compatible con Azure Monitor, incluso si no tiene un mosaico de sub-integració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

      Filtrado de etiquetas de recursos para métricas

      Utiliza filtros de etiquetas para controlar qué recursos de Azure tienen sus métricas recopiladas por Datadog. Configura filtros de etiquetas en la pestaña Configuration del mosaico de integración de Azure. Un filtro de etiquetas es una lista de etiquetas separadas por comas en la forma key:value. Solo los recursos que coinciden con al menos una etiqueta en el filtro tienen sus métricas recopiladas.

      Puedes usar comodines en tus filtros de etiquetas:

      • ? coincide con un solo carácter.
      • * coincide con múltiples caracteres.

      Para excluir recursos con una etiqueta dada, antepón la etiqueta con !. La exclusión tiene prioridad sobre la inclusión. Un recurso coincide con el filtro si coincide con alguna etiqueta en la lista.

      Por ejemplo: datadog:monitored,env:production,!plan_tier:basic,instance-type:c1.*

      Este filtro recopila métricas de recursos etiquetados con datadog:monitored o env:production, excluye recursos etiquetados con plan_tier:basic, e incluye recursos con una etiqueta instance-type que coincida con c1.*.

      Si no se establece un filtro de etiquetas, Datadog recopila métricas de todos los recursos de Azure.

      Habilitar la recopilación de registros

      Puedes usar la función de reenvío automático de registros para configurar los servicios y los ajustes de diagnóstico necesarios para reenviar registros a Datadog. Si ya existe un plano de control de reenvío automático de registros en el inquilino, este flujo lo modifica y amplía su alcance para incluir las suscripciones o grupos de administración seleccionados. Para más detalles, consulta Configuración de reenvío automático de registros de Azure.

      Datadog recomienda usar el Agente o DaemonSet para enviar registros desde Azure. Si el streaming directo no es posible, usa el flujo Configure Log Forwarding en la integración de Azure para configurar y gestionar el reenvío automático de registros directamente en Datadog. También puedes implementar el reenvío de registros con una plantilla de Administrador de Recursos de Azure (ARM). Ambos métodos gestionan y escalan automáticamente los servicios de reenvío de registros.

      Elige el método de configuración de reenvío automático de registros si…

      • No has configurado ya los registros a través del método de configuración Guía rápida.
      • Prefieres un flujo de trabajo basado en la interfaz de usuario y deseas minimizar el tiempo que toma crear un principal de servicio con los permisos de monitoreo requeridos.
      • Deseas automatizar los pasos de configuración en scripts o en pipelines de CI/CD.

      Instrucciones

      Utiliza el flujo Configure Log Forwarding para configurar nuevos o gestionar los reenvíos de registros existentes directamente en Datadog:

      1. En Datadog, navega a Integrations > Azure.
      2. Haz clic en Configure Log Forwarding.
      3. Copia el comando proporcionado y pégalo en tu Azure Cloud Shell.
      4. Selecciona las suscripciones de las cuales deseas reenviar registros.
      5. Opcionalmente, agrega o quita filtros de registros.
      6. Haz clic en Confirm.

      Para más detalles, consulta Configuración de reenvío automático de registros de Azure.

      Plantilla ARM

      Alternativamente, despliega el reenvío de registros con una plantilla de Administrador de Recursos de Azure (ARM):

      1. Abre la plantilla ARM de reenvío automático de registros en Azure.
      2. Configura los detalles de tu proyecto e instancia de Azure en la pestaña Básicos.
      3. Ingresa 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 Revisar + crear.
      Los Archivos de Registros requieren el método de configuración de registro de aplicación. Para cuentas de Datadog que utilizan la integración nativa de Azure, sigue los pasos en esta página para crear un registro de aplicación.

      Consulte Arquitectura de reenvío automático de registros de Azure para más detalles.

      Elija el método de reenvío de registros de la Aplicación de Contenedor si…

      Instrucciones

      1. Haz clic en el botón de abajo y completa el formulario en el Portal de Azure. Datadog despliega automáticamente los recursos de Azure necesarios para reenviar registros a tu cuenta de Datadog.

        Desplegar en Azure

      2. Después de que finalice el despliegue de la plantilla, configure los ajustes de diagnóstico para cada fuente de registro para enviar registros de la plataforma de Azure (incluidos los registros de recursos) a la Cuenta de Almacenamiento creada durante el despliegue.

      Nota: Los recursos solo pueden transmitir 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.

      Filtrado de etiquetas de recursos para registros

      Utilice filtros de etiquetas para controlar qué recursos de Azure tienen sus registros reenviados a Datadog. Para configurar filtros de etiquetas para registros, haga clic en Configure Log Forwarding en el mosaico de integración de Azure y siga el flujo. Un filtro de etiquetas es una lista de etiquetas separadas por comas en la forma key:value. Solo los recursos que coinciden con al menos una etiqueta en el filtro tienen sus registros reenviados.

      Puede usar comodines en sus filtros de etiquetas:

      • ? coincide con un solo carácter.
      • * coincide con múltiples caracteres.

      Para excluir recursos con una etiqueta dada, anteponga la etiqueta con !. La exclusión tiene prioridad sobre la inclusión. Un recurso coincide con el filtro si coincide con alguna etiqueta en la lista.

      Por ejemplo: datadog:monitored,env:production,!plan_tier:basic,instance-type:c1.*

      Este filtro reenvía registros de recursos etiquetados con datadog:monitored o env:production, excluye recursos etiquetados con plan_tier:basic, e incluye recursos con una etiqueta instance-type que coincida con c1.*.

      Si no se establece ningún filtro de etiquetas, Datadog reenvía registros de todos los recursos de Azure.

      Obtenga más de la Plataforma de Datadog

      Instale el Agente para obtener mayor visibilidad en su aplicación

      Después de configurar su integración de Azure, los rastreadores de Datadog recopilan automáticamente métricas de Azure, pero puede obtener una visibilidad aún más profunda en sus instancias de Azure con el Datadog Agent. Instalar el Datadog Agent en su entorno le permite recopilar datos adicionales, incluyendo, pero no limitándose a:

      • Salud de la aplicación
      • Utilización de procesos
      • Métricas a nivel de sistema

      También puede utilizar el cliente StatsD integrado para enviar métricas personalizadas desde sus aplicaciones, para correlacionar lo que está sucediendo con sus aplicaciones, usuarios y sistema. Consulte 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 los beneficios de instalar el Datadog Agent en sus instancias.

      Utilice la extensión de Azure para instalar el Datadog Agent en VMs de Windows, VMs de Linux x64 y VMs de Linux basadas en ARM. También puede utilizar la Extensión de Clúster AKS para desplegar el Datadog Agent en sus Clústeres AKS.

      1. En el portal de Azure, seleccione la VM apropiada.
      2. Desde la barra lateral izquierda, bajo Settings, seleccione Extensions + applications.
      3. Haga clic en
      4. Add
      5. . 4. Busque y seleccione la extensión Datadog Agent. 5. Haga clic en Next. 6. Ingrese su [clave de API de Datadog][2] y [sitio de Datadog][1], y haga clic en OK.

        Para instalar el Datadog Agent según el sistema operativo o herramienta de CI o CD, consulte 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.

        La Datadog AKS Cluster Extension permite desplegar el Datadog Agent de manera nativa dentro de Azure AKS, evitando la complejidad de las herramientas de gestión de terceros. Para instalar el Datadog Agent con la Extensión del Clúster AKS:

        1. Vaya a su clúster AKS en el portal de Azure.
        2. Desde la barra lateral izquierda del clúster AKS, seleccione Extensions + applications bajo Settings.
        3. Busque y seleccione el Datadog AKS Cluster Extension.
        4. Haga clic en Create, y siga las instrucciones en el mosaico usando sus credenciales de Datadog y sitio de Datadog.

        Solución de Problemas

        Consulte Solución de Problemas en la guía de Configuración Avanzada de Azure.

        ¿Aún necesita ayuda? Contacte a soporte de Datadog.

        Lectura Adicional