Intégration Dynatrace Azure : Azure Monitor et logs pas à pas

Dynatrace Azure pas à pas : principal de service, rôle Monitoring Reader, métriques Azure Monitor, logs via Event Hub et vérification DQL, SaaS et Managed.
Intégration Dynatrace Azure : Azure Monitor et logs pas à pas

Vos applications tournent sur des machines virtuelles, App Service et Azure Database, et chaque incident commence par une visite dans Azure Monitor avant d’ouvrir Dynatrace. Connecter Dynatrace Azure à vos abonnements fait remonter les métriques Azure Monitor et les journaux de ressources dans la même plateforme que vos traces et vos SLO.

Pour l’équipe d’astreinte, le gain se mesure en minutes : quand la base Azure SQL plafonne en DTU, l’information doit apparaître à côté du service qui ralentit, pas dans un portail séparé. Moins de bascules, moins de toil, un MTTR plus court.

Objectif de ce tutoriel : créer un principal de service en lecture seule, connecter un abonnement, puis transférer les logs Azure via Event Hub, et vérifier l’ensemble en DQL. Le contenu vaut pour Dynatrace SaaS et Dynatrace Managed ; les écarts sont signalés.

Les deux flux de l’intégration Dynatrace Azure

Comme pour les autres clouds, deux mécanismes indépendants coexistent :

  • Métriques et métadonnées (pull) : Dynatrace interroge l’API Azure Monitor avec l’identité d’un principal de service qui porte le rôle intégré Monitoring Reader.
  • Logs (push) : les paramètres de diagnostic des ressources envoient leurs journaux vers un Event Hub ; un transféreur de logs lit cet Event Hub et pousse vers l’API d’ingestion de logs de Dynatrace.

Un problème de rôle RBAC n’empêche pas les logs d’arriver, et un Event Hub mal configuré n’affecte pas les métriques. Diagnostiquez toujours les deux séparément.

Prérequis

  • Azure CLI (az) connectée avec un compte autorisé à créer une inscription d’application et à attribuer des rôles sur l’abonnement.
  • Le droit de modifier les réglages de l’environnement Dynatrace.
  • Un token API Dynatrace avec le scope d’ingestion de logs (logs.ingest) pour le transféreur.
  • Un namespace Event Hub dans la région des ressources à superviser.
  • En Managed : un ActiveGate qui joint les API Azure et votre cluster ; c’est lui qui interroge Azure Monitor.

Étape 1 : créer le principal de service

Créez une inscription d’application et son principal de service avec un secret client :

az ad sp create-for-rbac \
  --name "dynatrace-monitoring" \
  --query "{CLIENT_ID:appId, TENANT_ID:tenant, CLIENT_SECRET:password}" \
  --output table

Notez immédiatement les trois valeurs : le secret ne sera plus jamais affiché. Rangez-le dans votre coffre de secrets, pas dans un ticket.

Étape 2 : attribuer le rôle Monitoring Reader

Récupérez l’identifiant d’objet du principal, puis attribuez le rôle au niveau de l’abonnement :

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 donne la lecture des métriques et des métadonnées, sans droit d’écriture. Pour couvrir de nombreux abonnements, attribuez le même rôle au niveau d’un groupe d’administration avec --scope "/providers/Microsoft.Management/managementGroups/<id>" : chaque nouvel abonnement est alors couvert sans action supplémentaire.

Contrôlez l’attribution, y compris l’héritage :

az role assignment list \
  --assignee-object-id "$OBJECT_ID" \
  --role "Monitoring Reader" \
  --scope "/subscriptions/<subscription-id>" \
  --include-inherited

Un tableau vide signifie que le rôle manque : inutile d’aller plus loin côté Dynatrace.

Étape 3 : connecter l’abonnement dans Dynatrace

Dans les réglages Dynatrace, créez la connexion Azure en saisissant l’ID client, l’ID de tenant et le secret. Choisissez ensuite les services à superviser, puis filtrez par emplacement ou par tag. En SaaS récent, la connexion Azure s’appuie sur une extension gérée qui accepte aussi le filtrage par abonnement et l’enrichissement par tags Azure ; en Managed, utilisez l’écran d’intégration Azure de la version de votre cluster. Les intitulés exacts varient selon la version : la documentation de votre déploiement fait foi.

Le filtrage par tag (par exemple environment=production) est le meilleur réglage de départ : il limite les appels à l’API Azure Monitor et le volume de métriques ingérées.

Étape 4 : envoyer les logs via Event Hub

Dynatrace publie un transféreur de logs open source sous forme de script de déploiement. Il crée une Function App qui lit l’Event Hub et envoie vers votre environnement :

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 pointe vers votre ActiveGate (https://<activegate>/e/<environment-id>) ; le script propose aussi une option pour réutiliser un ActiveGate existant. Le script accepte également une identité managée à la place de la chaîne de connexion, ce qui évite un secret de plus.

Il reste à brancher les ressources sur l’Event Hub avec un paramètre de diagnostic :

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}]'

Ne choisissez allLogs que pour les ressources critiques. Pour les autres, ciblez des catégories précises : le volume baisse et le signal reste lisible.

Comment vérifier que ça fonctionne

Côté Azure, ouvrez l’Event Hub : le graphe Incoming Messages doit monter après quelques minutes, et Outgoing Messages doit suivre. Si seuls les messages entrants progressent, le transféreur ne consomme pas : consultez les logs de la Function App.

Côté Dynatrace, ouvrez un notebook et lancez :

fetch logs, from: now() - 1h
| filter matchesValue(cloud.provider, "Azure")
| summarize count(), by: {azure.resource.type}
| sort `count()` desc

Si le champ azure.resource.type n’existe pas dans vos enregistrements, retirez le regroupement et inspectez un enregistrement brut pour voir les attributs disponibles. Pour les métriques, cherchez « azure » dans l’explorateur de métriques et affichez la consommation CPU d’une machine virtuelle connue. Retrouvez d’autres requêtes de contrôle dans nos exemples de requêtes DQL d’exploitation.

Bonnes pratiques

  • Un principal de service par périmètre (production, hors production), pour révoquer sans tout couper.
  • Faites tourner le secret client avec az ad app credential reset --append : l’ancien secret reste valide jusqu’à la mise à jour dans Dynatrace.
  • Propagez les tags Azure vers Dynatrace et appuyez-vous dessus pour les management zones et le tagging automatique.
  • Réservez un consumer group au transféreur : partagé avec un autre outil, il provoque des pertes de messages.
  • Surveillez le silence d’une source critique : voir détecter les trous dans l’ingestion de logs.

Questions fréquentes

Monitoring Reader suffit-il, ou faut-il Reader ?

Pour la collecte des métriques et des métadonnées, la documentation demande Monitoring Reader. Certaines fonctions avancées peuvent demander des lectures supplémentaires ; la documentation fournit un modèle de rôle personnalisé avec des actions en lecture seule par fournisseur de ressources. Évitez Contributor : rien ne le justifie.

Quelle différence entre SaaS et Managed ?

En SaaS, Dynatrace interroge Azure depuis son infrastructure. En Managed, l’ActiveGate de votre environnement porte ces appels et doit joindre les API Azure ; les logs passent aussi par lui. Voir Environment ActiveGate ou Cluster ActiveGate pour le placer.

Les logs arrivent, mais pas les métriques : que vérifier ?

Les deux flux sont indépendants. Vérifiez l’attribution du rôle avec --include-inherited, l’expiration du secret client, puis les filtres de la connexion : un filtre par tag trop strict exclut tout sans signaler d’erreur.

Conclusion

Un principal de service en lecture seule, un rôle Monitoring Reader et un Event Hub suffisent à rapatrier Azure Monitor dans Dynatrace. L’intérêt n’est pas de dupliquer le portail Azure, mais de corréler : la ressource managée qui sature apparaît dans le même problème que le service touché. Commencez par un abonnement de production, vérifiez en DQL, puis étendez par groupe d’administration. La procédure de référence est sur docs.dynatrace.com.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Dynatrace est une marque de son propriétaire. Les noms d’écrans et les procédures évoluent : vérifiez toujours la documentation officielle avant un changement en production.

Total
0
Shares
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Intégration Dynatrace AWS : CloudWatch, métriques et logs pas à pas

Intégration Dynatrace AWS : CloudWatch, métriques et logs pas à pas

Next Post
Extension Dynatrace base de données : superviser PostgreSQL ou Oracle avec Extensions 2.0

Extension Dynatrace base de données : superviser PostgreSQL ou Oracle avec Extensions 2.0

Related Posts