Dans Azure

Votre utilisateur Microsoft Entra ID a besoin des permissions suivantes :

Permission de créer un enregistrement d’application

L’une des conditions suivantes doit être vraie pour l’utilisateur :

• Users can register applications a été défini sur Yes
• L’utilisateur a le rôle Développeur d’Application

Rôles d’administrateur au sein de vos abonnements

Au sein des abonnements que vous souhaitez surveiller, vous devez avoir soit :

• Le rôle Owner
• Les deux rôles Contributor et User Access Admin

Autorisation d’ajouter et de donner son consentement pour les autorisations de l’API Graph

Le rôle Administrateur de rôle privilégié contient les autorisations requises.

Dans Datadog

Le Datadog Admin Role, ou tout autre rôle avec l’autorisation azure_configurations_manage.

Choisissez la méthode de configuration Démarrage rapide si…

• Vous configurez Datadog pour la première fois.
• Vous préférez un flux de travail basé sur l’interface utilisateur et souhaitez minimiser le temps nécessaire pour créer un principal de service avec les autorisations de surveillance requises.
• Vous souhaitez automatiser les étapes de configuration dans des scripts ou des pipelines CI/CD.

Instructions

1. Dans la tuile d’intégration Azure, cliquez sur + Add New App registration, puis sélectionnez Quickstart.
2. Copiez le script de configuration et exécutez-le dans le shell Azure Cloud.
3. Retournez à l’interface utilisateur de Datadog. Vous devriez voir CONNECTED dans le coin supérieur droit du script de configuration.
4. Sélectionnez les abonnements et les groupes de gestion à partir desquels collecter des données.
5. Optionnellement, cliquez sur le commutateur de collecte de métriques pour désactiver toute collecte de métriques depuis Azure. Vous pouvez également développer le menu déroulant Advanced Configuration pour filtrer les métriques par :
   • Fournisseur de ressources
   • Étiquettes
   • Hôtes
   • Plans de service d’application
   • Container Apps

Vous pouvez également cliquer pour activer la collecte de métriques personnalisées depuis Azure Application Insights, et désactiver la collecte des métriques d’utilisation.

6. Optionnellement, cliquez sur le commutateur de collecte de ressources pour désactiver la collecte d’informations de configuration de vos ressources Azure.

7. Activez la collecte de journaux pour configurer et paramétrer les services et les paramètres de diagnostic nécessaires pour transférer les journaux vers Datadog :

   1. Si un transmetteur de journaux existe déjà dans le locataire, il est modifié pour étendre son champ d’application. Tous les paramètres modifiés s’appliquent aux abonnements ou groupes de gestion existants ainsi qu’à ceux nouvellement sélectionnés.
   2. Si vous créez un nouveau transmetteur de journaux :
      1. Entrez un nom de groupe de ressources pour stocker le plan de contrôle du transmetteur de journaux.
      2. Sélectionnez un abonnement de plan de contrôle pour l’orchestration de transfert de journaux (LFO).
      3. Sélectionnez une région pour le plan de contrôle.
         Remarque : Les champs de nom de groupe de ressources, d’abonnement de plan de contrôle et de région n’apparaissent que lors de la création d’un nouveau transmetteur de journaux.
   3. Optionnellement, ouvrez Log filtering options pour filtrer les journaux par étiquettes, ou appliquez un filtrage pour des informations spécifiques (comme les PII) en utilisant des regex.

   Consultez la section Architecture du guide de transfert de journaux automatisé pour plus d’informations sur cette architecture.

8. Cliquez Confirm pour terminer la configuration.

Choisissez la méthode de configuration Terraform si…

• Vous gérez l’infrastructure en tant que code et souhaitez maintenir l’intégration Datadog Azure sous contrôle de version.
• Vous devez configurer plusieurs locataires ou abonnements de manière cohérente avec des blocs de fournisseur réutilisables.
• Vous souhaitez un processus de déploiement répétable et auditable qui s’intègre dans votre environnement géré par Terraform.

Instructions

Suivez ces étapes pour déployer l’intégration Datadog Azure via Terraform.

resource "datadog_integration_azure" "sandbox" {
  tenant_name   = "<AZURE_TENANT_NAME>"
  client_id     = "<AZURE_CLIENT_ID>"
  client_secret = "<AZURE_CLIENT_SECRET_KEY>"
}

Gestion de plusieurs abonnements ou locataires

Vous pouvez utiliser plusieurs blocs de fournisseur avec des alias pour gérer les ressources Terraform à travers plusieurs abonnements ou locataires. Consultez Configuration du fournisseur pour plus d’informations.

Surveillez l’état d’intégration

Une fois l’intégration configurée, Datadog commence à exécuter une série continue d’appels aux API Azure pour collecter des données de surveillance critiques de votre environnement Azure. Parfois, ces appels renvoient des erreurs (par exemple, si les identifiants fournis ont expiré). Ces erreurs peuvent inhiber ou bloquer la capacité de Datadog à collecter des données de surveillance.

Lorsque des erreurs critiques sont rencontrées, l’intégration Azure génère des événements dans l’Explorateur d’événements Datadog et les republie toutes les cinq minutes. Vous pouvez configurer un Moniteur d’événements pour se déclencher lorsque ces événements sont détectés et notifier l’équipe appropriée.

Datadog fournit un modèle de moniteur pour vous aider à démarrer. Pour utiliser le modèle de moniteur :

1. Dans Datadog, allez à Monitors et cliquez sur le bouton Browse Templates.
2. Recherchez et sélectionnez le modèle de moniteur intitulé [Azure] Erreurs d’intégration.
3. Apportez les modifications souhaitées à la requête de recherche ou aux conditions d’alerte. Par défaut, le moniteur se déclenche chaque fois qu’une nouvelle erreur est détectée et se résout lorsque l’erreur n’a pas été détectée pendant les 15 dernières minutes.
4. Mettez à jour les messages de notification et de renotification selon vos souhaits. Notez que les événements eux-mêmes contiennent des informations pertinentes sur l’événement et sont inclus dans la notification automatiquement. Cela inclut des informations détaillées sur la portée, la réponse d’erreur et les étapes courantes pour remédier à la situation.
5. Configurer les notifications via vos canaux préférés (email, Slack, PagerDuty ou autres) pour vous assurer que votre équipe est alertée des problèmes affectant la collecte de données Azure.

Choisissez la méthode de configuration d’enregistrement d’application existante si..

• Vous avez déjà un enregistrement d’application configuré avec le rôle Monitoring Reader pour que Datadog surveille la portée fournie (abonnements ou groupes de gestion), et vous ne souhaitez pas créer de nouvelles ressources.

Si vous devez configurer un enregistrement d’application pour Datadog, consultez les méthodes de configuration Démarrage rapide ou Terraform.

Instructions

1. Dans la tuile d’intégration Datadog Azure, sélectionnez Add Existing.
2. Dans le champ Tenant ID, collez votre ID de répertoire (locataire).
3. Dans le champ Client ID, collez l’ID de l’application (client).
4. Dans le champ Client Secret Value, collez la valeur du secret client de l’enregistrement de l’application.
5. Optionnellement, cliquez sur le bouton Monitor Automuting pour désactiver l’automutation du moniteur.
6. Optionnellement, cliquez sur le bouton de collecte des métriques pour désactiver toute collecte de métriques depuis Azure. Vous pouvez également développer le menu déroulant Advanced Configuration pour filtrer les métriques par :
   • Fournisseur de ressources
   • Étiquettes
   • Hôtes
   • Plans de service d’application
   • Applications conteneurisées

Vous pouvez également cliquer pour activer la collecte de métriques personnalisées depuis Azure Application Insights, et désactiver la collecte des métriques d’utilisation.

6. Optionnellement, cliquez sur le bouton de collecte des ressources pour désactiver la collecte d’informations de configuration de vos ressources Azure.
7. Cliquez sur Create Configuration.

Choisissez la méthode de configuration du transfert de journaux automatisé si…

• Vous n’avez pas déjà configuré de journaux via la méthode de configuration Quickstart.
• Vous préférez un flux de travail basé sur une interface utilisateur et souhaitez minimiser le temps nécessaire pour créer un principal de service avec les autorisations de surveillance requises.
• Vous souhaitez automatiser les étapes de configuration dans des scripts ou des pipelines CI/CD.

Instructions

Configurer le transfert de journaux (recommandé)

Utilisez le flux Configure Log Forwarding pour configurer de nouveaux ou gérer des transmetteurs de journaux existants directement dans Datadog :

1. Dans Datadog, accédez à Integrations > Azure.
2. Cliquez sur Configure Log Forwarding.
3. Copiez la commande fournie et collez-la dans votre Azure Cloud Shell.
4. Sélectionnez les abonnements à partir desquels transférer des journaux.
5. Optionnellement, ajoutez ou supprimez des filtres de journaux.
6. Cliquez sur Confirm.

Pour plus de détails, consultez Configuration automatisée du transfert de journaux Azure.

Modèle ARM

Alternativement, déployez le transfert de journaux avec un modèle de gestion des ressources Azure (ARM) :

1. Ouvrez le modèle ARM de transfert de journaux automatisé dans Azure.
2. Configurez les détails de votre projet et de votre instance Azure dans l’onglet Informations de base.
3. Entrez vos identifiants Datadog dans l’onglet Configuration Datadog.
4. Reconnaissez les avertissements de déploiement dans l’onglet Déploiement.
5. Démarrez le processus de déploiement dans l’onglet Révision + création.

Consultez l’Architecture de transfert de journaux automatisé Azure pour plus de détails.

Choisissez la méthode de transfert de journaux de l’application de conteneur si…

• Vous préférez configurer manuellement les paramètres de diagnostic sur les ressources à partir desquelles vous souhaitez transférer des journaux.

Instructions

1. Cliquez sur le bouton ci-dessous et remplissez le formulaire sur le portail Azure. Datadog déploie automatiquement les ressources Azure nécessaires pour transférer des journaux dans votre compte Datadog.

   

2. Après la fin du déploiement du modèle, configurez les paramètres de diagnostic pour chaque source de journal afin d’envoyer les journaux de la plateforme Azure (y compris les journaux de ressources) au compte de stockage créé lors du déploiement.

Remarque : Les ressources ne peuvent diffuser que vers un compte de stockage dans la même région Azure.