Usa esta guía a fin de configurar de manera manual la integración de Azure con Datadog a través de un registro de aplicaciones con permisos de lectura para las suscripciones monitorizadas.
Todos los sitios: todos los sitios de Datadog pueden usar los pasos de esta página a fin de completar el proceso de credenciales de registro de aplicaciones para la recopilación de métricas de Azure y la configuración del centro de eventos para enviar logs de la plataforma de Azure.
US3: si tu organización se encuentra en el sitio US3 de Datadog, puedes usar la integración nativa de Azure para optimizar la gestión y la recopilación de datos para tu entorno de Azure. Datadog recomienda usar este método cuando sea posible. La configuración implica la creación de un recurso de Datadog en Azure para vincular tus suscripciones de Azure a tu organización de Datadog. Esto reemplaza el proceso de credenciales de registro de aplicaciones para la recopilación de métricas y la configuración del centro de eventos para el reenvío de logs. Consulta la guía de configuración manual nativa de Azure para obtener más información.
Configuración
Permisos necesarios para la configuración de la integración
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:
Users can register applications se ha fijado en Yes
--scopes puede admitir varios valores y puedes añadir varias suscripciones o grupos de gestión a la vez. Consulta los ejemplos en la documentación de az ad sp.
Añade --name <CUSTOM_NAME> para usar un nombre seleccionado de manera manual; de lo contrario, Azure genera uno único. El nombre no se usa en el proceso de configuración.
Añade --password <CUSTOM_PASSWORD> para usar una contraseña seleccionada de manera manual. De lo contrario, Azure genera una contraseña única. Esta contraseña se debe ingresar en el cuadro de integración de Azure con Datadog en Client Secret (Secreto de cliente).
El grupo de gestión es una opción válida y recomendada para el contexto. Por ejemplo:
az account management-group entities list --query "[?inheritedPermissions!='noaccess' && permissions!='noaccess'].{Name:displayName,Id:id}" --output table
En este comando se muestran todas las suscripciones y grupos de gestión a los que tiene acceso un usuario.
Une los IDs y crea la entidad de servicio. Puedes ejecutar este comando para crear un usuario y asignar roles a cada grupo de gestión o suscripción.
Primero, inicia sesión en la cuenta de Azure que quieres integrar con Datadog:
Este comando le otorga a la entidad de servicio el rol monitoring reader (lector de monitorización) para la suscripción que quieres monitorizar.
El Service Principal Name (Nombre de entidad de servicio) generado a partir de este comando se debe ingresar en el cuadro de integración de Azure con Datadog en Client ID (ID de cliente).
<SUBSCRIPTION_ID> es la suscripción de Azure que quieres monitorizar y aparece como ID con azure account show (visualización de cuenta de azure) o en el portal.
Integración a través de Azure Portal
En el cuadro de integración de Azure, selecciona Configuration > New App Registration > Using Azure Portal (Configuración > Registro de aplicación nueva > Con Azure Portal).
Selecciona Management Group (Auto-Discover) (Grupo de gestión [detección automática]) o Individual Subscriptions (Suscripciones individuales).
Si seleccionas el grupo de gestión, Datadog detecta y monitoriza de manera automática todas las suscripciones en ese contexto seleccionado, incluidas las suscripciones que se creen en el futuro. Debes tener seleccionado el rol de propietario en el grupo de gestión.
Si seleccionas las suscripciones individuales, debes tener el rol de propietario en todas las suscripciones que quieras monitorizar.
Haz clic en Open Template (Abrir plantilla).
Selecciona la Region (Región), Subscription (Suscripción) y Resource Group (Grupo de recursos) para la plantilla que se desplegará.
Nota: La selección de región, suscripción y grupo de recursos solo define dónde se despliega esta plantilla. No tiene ningún efecto en las suscripciones que monitoriza Datadog.
Haz clic en Siguiente.
Selecciona la opción Create new (Crear nuevo) en Service principal type (Tipo de entidad de servicio).
Haz clic en el enlace Change selection (Cambiar selección) en Service principal (Entidad de servicio).
Aparece un formulario para crear un registro de aplicaciones nuevo:
Ingresa un nombre para el registro de aplicaciones, selecciona los tipos de cuentas admitidos y haz clic en Register (Registrar).
Se abrirá una página para crear un secreto de cliente. Haz clic en + New client secret (+ Secreto de cliente nuevo) para añadir un secreto de cliente.
Copia el valor del secreto de cliente y haz clic en el botón de cerrar (X) en la esquina superior derecha de la pantalla.
Pega el valor del secreto de cliente en el campo correspondiente de la plantilla y haz clic en Next (Siguiente).
Proporciona una clave de API de Datadog y un valor de clave de aplicación de Datadog en los campos correspondientes. Si iniciaste la plantilla desde la página de la integración de Azure en Datadog, puedes copiar las claves que se proporcionan allí. De lo contrario, puedes encontrar las claves de API y de aplicación en la sección de Acceso de los parámetros de organización.
Nota: Si has elegido monitorizar suscripciones individuales en lugar de un grupo de gestión, selecciona las suscripciones a monitorizar en el menú desplegable Subscriptions to monitor (Suscripciones a monitorizar).
Selecciona tu sitio de Datadog, así como cualquier otra opción de configuración de la integración, como filtros de host y si deseas recopilar recursos para Cloud Security.
Haz clic en Review + create (Revisar + crear) y, a continuación, en Create (Crear).
Una vez finalizado el despliegue, haz clic en Done (Hecho) en la página de integración de Azure en Datadog para actualizar la lista y revisar el registro de la aplicación recién añadida.
En Microsoft Entra ID, ve a App registrations (Registros de aplicaciones).
Haz clic en New registration (Nuevo registro).
Proporciona un nombre y confirma que los Supported account types (Tipos de cuenta admitidos) están configuradod en Accounts in this organizational directory only.
Haz clic en Register (Registrar).
Dar permisos de lectura a la aplicación
Asigna el acceso a nivel de suscripción individual o de grupo de gestión.
Para asignar el acceso a nivel de suscripción, ve a Subscriptions (Suscripciones) a través del cuadro de búsqueda o de la barra lateral izquierda.
Para asignar el acceso a nivel de grupo de gestión, ve a Management Groups (Grupos de gestión) y selecciona el grupo de gestión que contiene el conjunto de suscripciones a monitorizar. Nota: La asignación de acceso a nivel de grupo de gestión significa que cualquier nueva suscripción que se añada al grupo será detectada y supervisada automáticamente por Datadog.
Haz clic en la suscripción o grupo de gestión que desees monitorizar.
Selecciona Access control (IAM) (Control de acceso (IAM)) en el menú de suscripción y haz clic en Add role assignment (Añadir asignación de roles):
En la pestaña Role (Rol), selecciona Reader (Lector).
En la pestaña Members (Miembros), haz clic en Select members (Seleccionar miembros).
Haz clic en Review + assign (Revisar + asignar) para completar la creación.
Repite este proceso para las suscripciones o grupos de gestión adicionales que desees monitorizar con Datadog.
Notas:
Los usuarios de Azure Lighthouse pueden añadir suscripciones de arrendatarios de clientes.
Los diagnósticos deben estar habilitados para que las máquinas virtuales desplegadas en ARM recopilen métricas, consulta Habilitar diagnósticos.
Completar la integración
En App Registrations (Registros de aplicaciones), selecciona la aplicación que creaste, copia el Application (client) ID (ID de aplicación (cliente)) y el Directory (tenant) ID (ID de directorio (inquilino)), y pega los valores en el cuadro de integración de Azure con Datadog en Client ID (ID de cliente) y Tenant ID (ID de inquilino).
Para la misma aplicación, dirígete a Manage > Certificates and secrets (Gestionar > Certificados y secretos).
Haz clic en + New client secret: (+ Nuevo secreto de cliente):
Opcionalmente, proporciona una descripción.
Selecciona un plazo de expiración en el campo Expires (Expiración).
Haz clic en Create Configuration (Crear configuración).
Nota: Las actualizaciones de la configuración de Azure pueden tardar hasta 20 minutos en reflejarse en Datadog.
Configuración
A fin de limitar la recopilación de métricas para los hosts basados en Azure, abre el cuadro de integración de Azure. Selecciona la pestaña Configuration (Configuración) y, a continuación, abre App Registrations (Registros de aplicaciones). Ingresa una lista de etiquetas (tags) en el cuadro de texto debajo de Metric Collection Filters (Filtros de recopilación de métricas).
Esta lista de etiquetas en formato <KEY>:<VALUE> se encuentra separada por comas y define un filtro que se usa al recopilar métricas. También se pueden usar comodines como ? (para caracteres individuales) y * (para varios caracteres).
Solo las VMs que coinciden con una de las etiquetas definidas se importan a Datadog. El resto se ignoran. Las VMs que coinciden con una etiqueta determinada también se pueden excluir al añadir ! antes de la etiqueta. Por ejemplo:
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:
En Datadog, ve a Monitors (Monitores) y haz clic en Browse Templates (Buscar plantillas).
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.
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.
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.
Recopilación de métricas
Una vez que se haya configurado el cuadro de integración, un rastreador recopila las métricas. Para recopilar métricas adicionales, despliega el Datadog Agent en tus VMs:
Instalación del Agent
Puedes usar la extensión de Azure para instalar el Datadog Agent en VMs de Windows, Linux x64 y Linux basadas en ARM. También puedes usar la extensión del clúster de AKS para desplegar el Agent en tus clústeres de AKS.
Nota: Los controladores de dominio no son compatibles al instalar el Datadog Agent con la extensión de Azure.
La extensión del clúster de AKS de Datadog te permite desplegar el Datadog Agent de manera nativa en Azure AKS, lo que evita la complejidad de las herramientas de gestión de terceros. Para instalar el Datadog Agent con la extensión del clúster de AKS:
Dirígete a tu clúster de AKS en Azure Portal.
En la barra lateral izquierda del clúster de AKS, selecciona Extensions + applications (Extensiones + aplicaciones) en Settings (Configuración).
Busca y selecciona Datadog AKS Cluster Extension (Extensión del clúster de AKS de Datadog).