Tus aplicaciones se ejecutan en máquinas virtuales, App Service y Azure Database, y cada incidente empieza con una visita a Azure Monitor antes de abrir Dynatrace. Conectar Dynatrace Azure a tus suscripciones hace subir las métricas de Azure Monitor y los registros de recursos a la misma plataforma que tus trazas y tus SLO.
Para el equipo de guardia (on-call), la ganancia se mide en minutos: cuando la base Azure SQL toca techo en DTU, la información debe aparecer junto al servicio que se ralentiza, no en un portal aparte. Menos cambios de herramienta, menos toil, un MTTR más corto.
Objetivo de este tutorial: crear un principal de servicio de solo lectura, conectar una suscripción, transferir después los logs de Azure mediante Event Hub y verificarlo todo con DQL. El contenido vale para Dynatrace SaaS y Dynatrace Managed; las diferencias se señalan.
Los dos flujos de la integración de Dynatrace Azure
Como en los demás clouds, conviven dos mecanismos independientes:
- Métricas y metadatos (pull): Dynatrace consulta la API de Azure Monitor con la identidad de un principal de servicio que tiene el rol integrado Monitoring Reader.
- Logs (push): los ajustes de diagnóstico de los recursos envían sus registros a un Event Hub; un reenviador de logs lee ese Event Hub y envía a la API de ingesta de logs de Dynatrace.
Un problema con el rol RBAC no impide que lleguen los logs, y un Event Hub mal configurado no afecta a las métricas. Diagnostica siempre los dos por separado.
Requisitos previos
- Azure CLI (
az) conectada con una cuenta autorizada para crear un registro de aplicación y asignar roles en la suscripción. - Permiso para modificar los ajustes del entorno de Dynatrace.
- Un token de API de Dynatrace con el scope de ingesta de logs (
logs.ingest) para el reenviador. - Un namespace de Event Hub en la región de los recursos que se van a monitorizar.
- En Managed: un ActiveGate que llegue a las API de Azure y a tu clúster; es él quien consulta Azure Monitor.
Paso 1: crear el principal de servicio
Crea un registro de aplicación y su principal de servicio con un secreto de cliente:
az ad sp create-for-rbac \
--name "dynatrace-monitoring" \
--query "{CLIENT_ID:appId, TENANT_ID:tenant, CLIENT_SECRET:password}" \
--output table
Anota de inmediato los tres valores: el secreto no volverá a mostrarse. Guárdalo en tu caja fuerte de secretos, no en un ticket.
Paso 2: asignar el rol Monitoring Reader
Obtén el identificador de objeto del principal y asigna después el rol a nivel de suscripción:
OBJECT_ID=$(az ad sp list --display-name "dynatrace-monitoring" --query "[0].id" -o tsv)
az role assignment create \
--assignee-object-id "$OBJECT_ID" \
--role "Monitoring Reader" \
--scope "/subscriptions/<subscription-id>" \
--assignee-principal-type ServicePrincipal \
--description "Dynatrace Monitoring"
Monitoring Reader da lectura de métricas y metadatos, sin permiso de escritura. Para cubrir muchas suscripciones, asigna el mismo rol a nivel de un grupo de administración con --scope "/providers/Microsoft.Management/managementGroups/<id>": cada suscripción nueva queda así cubierta sin acción adicional.
Comprueba la asignación, incluida la herencia:
az role assignment list \
--assignee-object-id "$OBJECT_ID" \
--role "Monitoring Reader" \
--scope "/subscriptions/<subscription-id>" \
--include-inherited
Una tabla vacía significa que falta el rol: es inútil seguir adelante en Dynatrace.
Paso 3: conectar la suscripción en Dynatrace
En los ajustes de Dynatrace, crea la conexión de Azure introduciendo el ID de cliente, el ID de tenant y el secreto. Elige después los servicios que quieres monitorizar y filtra por ubicación o por etiqueta. En el SaaS reciente, la conexión de Azure se apoya en una extensión gestionada que también admite el filtrado por suscripción y el enriquecimiento con etiquetas de Azure; en Managed, usa la pantalla de integración de Azure de la versión de tu clúster. Los nombres exactos varían según la versión: manda la documentación de tu despliegue.
El filtrado por etiqueta (por ejemplo environment=production) es el mejor ajuste inicial: limita las llamadas a la API de Azure Monitor y el volumen de métricas ingeridas.
Paso 4: enviar los logs mediante Event Hub
Dynatrace publica un reenviador de logs de código abierto en forma de script de despliegue. Crea una Function App que lee el Event Hub y envía a tu entorno:
DEPLOYMENT_NAME=dtlogs
TARGET_URL=https://<environment-id>.live.dynatrace.com
TARGET_API_TOKEN=<token-logs-ingest>
RESOURCE_GROUP=rg-observability
EVENT_HUB_CONNECTION_STRING="<connection-string-event-hub>"
REQUIRE_VALID_CERTIFICATE=true
wget -q https://github.com/dynatrace-oss/dynatrace-azure-log-forwarder/releases/latest/download/dynatrace-azure-logs.sh \
-O dynatrace-azure-logs.sh && chmod +x ./dynatrace-azure-logs.sh
./dynatrace-azure-logs.sh \
--deployment-name $DEPLOYMENT_NAME \
--target-url $TARGET_URL \
--target-api-token $TARGET_API_TOKEN \
--resource-group $RESOURCE_GROUP \
--event-hub-connection-string "$EVENT_HUB_CONNECTION_STRING" \
--require-valid-certificate $REQUIRE_VALID_CERTIFICATE
En Managed, TARGET_URL apunta a tu ActiveGate (https://<activegate>/e/<environment-id>); el script ofrece también una opción para reutilizar un ActiveGate existente. El script admite además una identidad administrada en lugar de la cadena de conexión, lo que evita un secreto más.
Falta conectar los recursos al Event Hub con un ajuste de diagnóstico:
az monitor diagnostic-settings create \
--name to-dynatrace \
--resource "<resource-id>" \
--event-hub-rule "<authorization-rule-id>" \
--event-hub "<event-hub-name>" \
--logs '[{"categoryGroup":"allLogs","enabled":true}]'
Elige allLogs solo para los recursos críticos. Para los demás, apunta a categorías concretas: el volumen baja y la señal sigue siendo legible.
Cómo comprobar que funciona
En Azure, abre el Event Hub: el gráfico Incoming Messages debe subir tras unos minutos, y Outgoing Messages debe seguirlo. Si solo progresan los mensajes entrantes, el reenviador no consume: revisa los logs de la Function App.
En Dynatrace, abre un notebook y ejecuta:
fetch logs, from: now() - 1h
| filter matchesValue(cloud.provider, "Azure")
| summarize count(), by: {azure.resource.type}
| sort `count()` desc
Si el campo azure.resource.type no existe en tus registros, quita la agrupación e inspecciona un registro sin procesar para ver los atributos disponibles. Para las métricas, busca «azure» en el explorador de métricas y muestra el consumo de CPU de una máquina virtual conocida. Encontrarás más consultas de control en nuestros ejemplos de consultas DQL de explotación.
Buenas prácticas
- Un principal de servicio por ámbito (producción, no producción), para revocar sin cortarlo todo.
- Rota el secreto de cliente con
az ad app credential reset --append: el secreto antiguo sigue siendo válido hasta que lo actualices en Dynatrace. - Propaga las etiquetas de Azure a Dynatrace y apóyate en ellas para las Management zones y el etiquetado automático.
- Reserva un consumer group para el reenviador: si se comparte con otra herramienta, provoca pérdidas de mensajes.
- Vigila el silencio de una fuente crítica: consulta detectar los huecos en la ingesta de logs.
Preguntas frecuentes
¿Basta con Monitoring Reader, o hace falta Reader?
Para la recogida de métricas y metadatos, la documentación pide Monitoring Reader. Algunas funciones avanzadas pueden requerir lecturas adicionales; la documentación ofrece una plantilla de rol personalizado con acciones de solo lectura por proveedor de recursos. Evita Contributor: nada lo justifica.
¿Qué diferencia hay entre SaaS y Managed?
En SaaS, Dynatrace consulta Azure desde su infraestructura. En Managed, el ActiveGate de tu entorno realiza esas llamadas y debe llegar a las API de Azure; los logs también pasan por él. Consulta Environment ActiveGate o Cluster ActiveGate para decidir dónde colocarlo.
Los logs llegan, pero las métricas no: ¿qué comprobar?
Los dos flujos son independientes. Comprueba la asignación del rol con --include-inherited, la caducidad del secreto de cliente y, después, los filtros de la conexión: un filtro por etiqueta demasiado estricto lo excluye todo sin señalar ningún error.
Conclusión
Un principal de servicio de solo lectura, un rol Monitoring Reader y un Event Hub bastan para traer Azure Monitor a Dynatrace. El interés no es duplicar el portal de Azure, sino correlacionar: el recurso administrado que se satura aparece en el mismo problema que el servicio afectado. Empieza por una suscripción de producción, verifica con DQL y amplía después por grupo de administración. El procedimiento de referencia está en docs.dynatrace.com.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.