Remarque : les instructions de configuration sont différentes pour l’intégration native Azure (disponible pour les clients utilisant le site Datadog US3). Si vous utilisez l’intégration native Azure, modifiez le sélecteur de site pour afficher les instructions propres au site US3. Pour en savoir plus, consultez la rubrique Présentation.

Installation

Intégrez votre compte Microsoft Azure à Datadog à l’aide de l’outil d’interface de ligne de commande Azure ou du portail Azure. Cette méthode d’intégration fonctionne automatiquement sur tous les clouds Azure : Public, Chine, Allemagne et Government.

Suivez les instructions ci-dessous afin que Datadog détecte automatiquement le type de cloud que vous utilisez pour terminer l’intégration.

Intégration via l’interface de ligne de commande Azure

Afin d’intégrer Datadog à Azure à l’aide de l’interface de ligne de commande Azure, assurez-vous que celle-ci est bien installée.

az login

az account show

az ad sp create-for-rbac --role "Monitoring Reader" --scopes /subscriptions/{id_abonnement}

azure login

az account show

azure ad sp create -n <NOM> -p <MOTDEPASSE>

azure role assignment create --objectId <ID_OBJET> -o "Monitoring Reader" -c /subscriptions/<ID_ABONNEMENT>/

azure login

az account show

azure ad app create --name "<NOM>" --home-page "<URL>" --identifier-uris "<URL>" --password "<MOTDEPASSE>"

azure ad sp create {app-id}

azure ad sp create -a {app-id}

azure role assignment create --objectId <ID_OBJET> --roleName "Monitoring Reader" --subscription <ID_ABONNEMENT>

Intégration via le portail Azure

1. Créez une inscription d’application dans votre Active Directory et envoyez les bons identifiants à Datadog.
2. Donnez à l’application une autorisation de lecture pour tous les abonnements que vous souhaitez surveiller.

Créer l’inscription d’application

1. Sous Azure Active Directory, accédez à App Registrations et cliquez sur New application registration :

2. Saisissez les informations suivantes et cliquez sur le bouton Create. Le nom et l’URL de connexion ne sont pas utilisés et sont seulement requis dans le cadre du processus de configuration.

   • Name : Datadog Auth
   • Supported Account Types : Accounts in this organizational directory only (Datadog)
   • Redirect URI :

Accorder un accès en lecture à l’application

1. Accédez à la section Subscriptions en utilisant la barre de recherche ou depuis la barre latérale de gauche :

2. Cliquez sur l’abonnement que vous souhaitez surveiller.

3. Sélectionnez Access control (IAM) dans le menu d’abonnement et cliquez sur Add -> Add role assignment :

4. Pour Role, sélectionnez Monitoring Reader. Sous Select, choisissez le nom de l’application que vous avez créée :

5. Cliquez sur Save.

6. Répétez ce processus pour tout autre abonnement que vous souhaitez surveiller à l’aide de Datadog. Remarque : les utilisateurs d’Azure Lighthouse peuvent ajouter les abonnements des locataires clients.

Remarque : les diagnostics doivent être activés pour que les machines virtuelles déployées avec ARM puissent recueillir des métriques. Consultez la section Activer les diagnostics.

Terminer l’intégration

1. Sous App Registrations, sélectionnez l’application que vous avez créée, copiez les valeurs Application ID et Tenant ID, puis collez-les dans le carré d’intégration Azure de Datadog, sous Client ID et Tenant ID.

2. Pour cette même application, accédez à Manage -> Certificates and secrets.

3. Ajoutez un nouveau Client Secret intitulé datadogClientSecret, sélectionnez un intervalle pour Expires, puis cliquez sur Add :

4. Une fois la valeur de la clé indiquée, collez-la dans le carré d’intégration Azure de Datadog, sous Client Secret, puis cliquez sur Install Integration ou Update Configuration.

Remarque : les modifications apportées à la configuration Azure peuvent mettre jusqu’à 20 minutes à être appliquées dans Datadog.

Configuration

Pour limiter la collecte de ressources pour des hosts Azure, ouvrez le carré d’intégration Azure, accédez à l’onglet Configuration, puis ouvrez App Registrations. Saisissez ensuite la liste des tags dans la zone de texte sous Metric Collection Filters.

Cette liste de tags au format <KEY>:<VALUE> est séparée par des virgules. Elle définit un filtre utilisé pour la collecte des métriques. Des wildcards, tels que ? (pour un seul caractère) et * (pour plusieurs caractères), peuvent également être utilisés.

Seules les VM qui correspondent à l’un des tags définis sont importées dans Datadog. Les autres VM sont ignorées. Ajoutez ! devant un tag pour exclure la VM correspondant à ce tag. Exemple :

datadog:monitored,env:production,!env:staging,instance-type:c1.*

Surveiller le statut de l’intégration

Une fois l’intégration configurée, Datadog commence à appeler en continu les API Azure pour recueillir les données de surveillance critiques de votre environnement Azure. Ces appels renvoient parfois des erreurs (si les identifiants fournis ont expiré, par exemple). Ces erreurs peuvent empêcher Datadog de recueillir les données de surveillance.

En cas d’erreurs critiques, l’intégration Azure génère des événements dans l’Events Explorer de Datadog et les republie toutes les cinq minutes. Vous pouvez configurer un monitor d’événement pour qu’il se déclenche lors de la détection de ces événements et envoie une notification à l’équipe appropriée.

Datadog fournit un monitor conseillé que vous pouvez utiliser comme modèle pour commencer. Pour utiliser le monitor conseillé :

1. Dans Datadog, accédez à Monitors -> New Monitor et sélectionnez l’onglet Recommended Monitors.
2. Sélectionnez le monitor conseillé nommé [Azure] Integration Errors.
3. Apportez les modifications voulues à la requête de recherche ou aux conditions d’alerte. Par défaut, le monitor se déclenche à chaque fois qu’une nouvelle erreur est détectée et se résout si l’erreur en question n’a pas été détectée au cours des 15 dernières minutes.
4. Modifiez les messages pour la notification initiale et les notifications suivantes selon vos besoins. Notez que les événements eux-mêmes contiennent des informations pertinentes qui seront automatiquement incluses dans la notification, notamment des informations détaillées concernant le contexte, l’erreur renvoyée et les actions courantes pour y remédier.
5. Configurez les notifications de sorte qu’elles soient envoyées via les canaux privilégiés (e-mail, Slack, PagerDuty ou autres) afin de garantir que votre équipe soit prévenue en cas de problèmes liés à la collecte des données Azure.

Collecte de métriques

Une fois le carré d’intégration configuré, les métriques sont recueillies par un crawler. Pour recueillir des métriques supplémentaires, déployez l’Agent Datadog sur vos machines virtuelles :

Installation de l’Agent

Vous pouvez utiliser l’extension Azure pour installer l’Agent Datadog sur les machines virtuelles Windows, Linux x64 et Linux ARM.

1. Dans le portail Azure, accédez à votre machine virtuelle, cliquez sur Settings > Extensions > Add, puis sélectionnez Datadog Agent.
2. Cliquez sur Create, saisissez votre clé d’API Datadog et cliquez sur OK.

Pour effectuer l’installation de l’Agent en fonction du système d’exploitation ou de l’outil CI/CD, consultez les instructions d’installation de l’Agent Datadog.

Remarque : lors de l’installation de l’Agent Datadog avec l’extension Azure, les contrôleurs de domaine ne sont pas pris en charge.

Validation

Vous devrez peut-être patienter quelques minutes avant que les métriques des applications apparaissent sous le nouvel abonnement.

Accédez au dashboard par défaut des machines virtuelles Azure pour visualiser les données de votre infrastructure, qui s’ajoutent automatiquement au dashboard.

Collecte de logs

Remarque : les instructions de configuration sont différentes pour l’intégration native Azure (disponible pour les clients utilisant le site Datadog US3). Si vous utilisez l’intégration native Azure, modifiez le sélecteur de site pour afficher les instructions propres au site US3. Pour en savoir plus, consultez la rubrique Présentation.

Pour envoyer les logs depuis Azure vers Datadog, la meilleure approche consiste à utiliser l’Agent ou un DaemonSet. Si cela n’est pas possible pour certaines ressources, nous vous conseillons de créer un pipeline de transfert de logs à l’aide d’un Event Hub Azure pour recueillir les logs de la plate-forme Azure. Si une ressource ne prend pas en charge la diffusion des logs de la plate-forme Azure vers un Event Hub, vous pouvez les transférer via le service Stockage Blob Azure.

Pour commencer, cliquez sur le bouton ci-dessous et remplissez le formulaire sur le portail Azure. Les ressources Azure requises pour la transmission des logs d’activité à votre compte Datadog seront déployées pour vous.

Datadog met également à votre disposition deux scripts automatisés.

Le premier script crée et configure les ressources Azure requises pour que les logs d’activité soient diffusés vers votre compte Datadog. Ces ressources incluent les paramètres de diagnostic des logs d’activité, les fonctions Azure, les espaces de nommage d’Event Hub et l’Event Hub.

Le second script est une option plus générique qui déploie uniquement l’Event Hub et les fonctions Azure, sans aucun paramètre de diagnostic. Il peut être utilisé pour configurer les sources de diffusion. Dans les deux cas, les Event Hubs peuvent être utilisés par d’autres sources de diffusion.

Exemple :

Si vous souhaitez diffuser à la fois les logs d’activité et les logs de ressource provenant de westus, exécutez le premier script en spécifiant le paramètre facultatif -ResourceGroupLocation westus (les logs d’activité sont une source au niveau de l’abonnement, vous pouvez donc leur créer un pipeline dans n’importe quelle région). Une fois le script déployé, vous pouvez envoyer les logs de ressource via le même Event Hub en ajoutant les paramètres de diagnostic à vos ressources dans westus.

Remarques :

L’intégration ne recueille pas d’événement.

Envoyer des logs d’activité depuis Azure vers Datadog

Étape 1 :* dans le portail Azure, accédez à votre Cloud Shell.

Étape 2 : exécutez la commande ci-dessous pour télécharger le script d’automatisation dans votre environnement Cloud Shell.

Logs d'activité Étape 1

Copy

(New-Object System.Net.WebClient).DownloadFile("https://raw.githubusercontent.com/DataDog/datadog-serverless-functions/master/azure/eventhub_log_forwarder/activity_logs_deploy.ps1", "activity_logs_deploy.ps1")

Vous pouvez également afficher le contenu du script.

Étape 3 : invoquez le script en exécutant la commande ci-dessous, en ayant remplacé <clé_api> par votre token d’API Datadog et <id_abonnement> par votre ID d’abonnement Azure. Vous pouvez également ajouter des paramètres facultatifs supplémentaires pour configurer votre déploiement. Consultez la rubrique Paramètres facultatifs.

Logs d'activité Étape 2

Copy

./activity_logs_deploy.ps1 -ApiKey <clé_api> -SubscriptionId <id_abonnement> 

Envoyer des logs de la plate-forme Azure à Datadog

Une solution générique pour envoyer des logs de plateforme Azure, y compris les logs de ressource, consiste à déployer uniquement l’Event Hub et le forwarder de logs. Une fois ce pipeline déployé, vous pouvez créer des paramètres de diagnostic pour chaque source de logs et les configurer pour qu’elles diffusent leur contenu vers Datadog.

Étape 1 :* dans le portail Azure, accédez à votre Cloud Shell.

Étape 2 : exécutez la commande ci-dessous pour télécharger le script d’automatisation dans votre environnement Cloud Shell.

Logs de plateforme Étape 1

Copy

(New-Object System.Net.WebClient).DownloadFile("https://raw.githubusercontent.com/DataDog/datadog-serverless-functions/master/azure/eventhub_log_forwarder/resource_deploy.ps1", "resource_deploy.ps1")

Vous pouvez également afficher le contenu du script.

Étape 3 : invoquez le script en exécutant la commande ci-dessous, en ayant remplacé <clé_api> par votre token d’API Datadog et <id_abonnement> par votre ID d’abonnement Azure. Vous pouvez également ajouter des paramètres facultatifs supplémentaires pour configurer votre déploiement. Consultez la rubrique Paramètres facultatifs.

Logs de plateforme Étape 2

Copy

./resource_deploy.ps1 -ApiKey <clé_api> -SubscriptionId <id_abonnement> 

Étape 4 : créez des paramètres de diagnostic pour toutes les ressources Azure qui envoient des logs à Datadog. Configurez ces paramètres de diagnostic de façon à initier la diffusion des logs vers l’Event Hub que vous venez de créer.

Remarque : les ressources peuvent diffuser des logs uniquement aux Event Hubs qui se trouvent dans la même région Azure. Vous devez donc répéter l’étape 2 pour chaque région à partir de laquelle vous souhaitez diffuser des logs de ressource.

Remarque : les valeurs Ressource-Groupe-Emplacement sont ajoutées au nom par défaut de chaque ressource Azure déployée pour le pipeline de logs de plateforme. Exemple : datadog-eventhub-westus. Toutefois, vous pouvez modifier cette convention en remplaçant ce paramètre.

Paramètres facultatifs

Remarque : lorsque vous personnalisez les paramètres, assurez-vous que le nom de chacune de vos ressources personnalisées est unique. Vérifiez que le nom de la ressource ne figure pas déjà dans votre liste de ressources Azure.

-Flag <paramètre par défaut>	Description
-DatadogSite <datadoghq.com>	Personnalisez votre instance Datadog en ajoutant ce flag avec comme paramètre un autre site Datadog. Votre site Datadog est .
-Environment <AzureCloud>	Gérez le stockage des clouds Azure indépendants en ajoutant ce flag comme paramètre. Vous pouvez également utiliser les options AzureChinaCloud, AzureGermanCloud et AzureUSGovernment.
-ResourceGroupLocation <westus2>	Vous pouvez sélectionner la région dans laquelle votre groupe de ressources et vos ressources Azure sont déployés en ajoutant ce flag avec la nouvelle région Azure.
-ResourceGroupName <gr-forwarder-logs-datadog>	Personnalisez le nom de votre groupe de ressources Azure en ajoutant ce flag avec un paramètre mis à jour.
-EventhubNamespace <datadog-ns-4c6c53b4-1abd-4798-987a-c8e671a5c25e>	Personnalisez l’espace de nommage de votre Event Hub Azure en ajoutant ce flag avec un paramètre mis à jour. Par défaut, datadog-ns-<ID-globale-unique> est généré.
-EventhubName <eventhub-datadog>	Personnalisez le nom de votre Event Hub Azure en ajoutant ce flag avec un paramètre mis à jour.
-FunctionAppName <datadog-functionapp-1435ad2f-7c1f-470c-a4df-bc7289d8b249>	Personnalisez le nom de votre application de fonctions Azure en ajoutant ce flag avec un paramètre mis à jour. Par défaut, datadog-functionapp-<ID-unique-globale> est généré.
-FunctionName <fonction-datadog>	Personnalisez le nom de votre fonction Azure en utilisant ce flag avec un paramètre mis à jour.
-DiagnosticSettingName <paramètre-diagnostic-logs-activités-datadog>	Personnalisez le nom de votre paramètre de diagnostic Azure en ajoutant ce flag avec un paramètre mis à jour. Ce flag sert uniquement à envoyer des logs d’activité pertinents.

Si l’installation échoue, consultez la section Dépannage pour résoudre rapidement les erreurs courantes.

Pour envoyer des logs depuis Azure vers Datadog, suivez cette méthode globale :

1. Créez un Event Hub Azure.
2. Configurez la fonction Datadog/Azure avec un déclencheur Event Hub pour transmettre les logs à Datadog.
3. Configurez vos services Azure de façon à ce que leurs logs soient envoyés au Event Hub à l’aide d’un nouveau paramètre de diagnostic.

Les instructions qui suivent permettent d’effectuer une première configuration basique à l’aide du portail Azure. Toutes ces étapes peuvent être effectuées via l’interface de ligne de commande, Powershell ou des modèles de ressources. Pour ce faire, référez-vous à la documentation Azure.

Event Hub Azure

Créez un Event Hub Azure :

Créez un espace de nommage ou ajoutez un nouvel Event Hub à un espace de nommage existant en suivant les instructions ci-dessous.

1. Dans le portail Azure, accédez à la vue d’ensemble Event Hubs et cliquez sur Create.
2. Indiquez le nom, le niveau tarifaire, l’abonnement et le groupe de ressources.
3. Sélectionnez une région. Remarque : l’Event Hub doit se trouver dans la même région que la ressource dont les logs doivent être transférés. Pour les logs d’activité ou toute autre source de logs propres à l’ensemble du compte, la région n’a pas d’importance.
4. Sélectionnez les options de votre choix pour les unités de débit, les zones de disponibilité et l’inflation automatique.
5. Cliquez sur Create.

Ajoutez un Event Hub à votre espace de nommage Event Hub.

1. Dans le portail Azure, créez un espace de nommage ou accédez à un espace de nommage existant.
2. Cliquez sur + Event Hub.
3. Sélectionnez les options de votre choix pour le nom, le nombre de partitions et la rétention des messages.
4. Cliquez sur Create.

Fonction Azure Datadog

Configurez la fonction Datadog/Azure avec un déclencheur Event Hub pour transmettre les logs à Datadog :

Créez une application de fonctions ou utilisez une application de fonctions existante et passez à la section suivante.

1. Dans le portail Azure, accédez à la vue d’ensemble Function Apps et cliquez sur Create.
2. Sélectionnez un abonnement, un groupe de ressources et une région, puis nommez votre application de fonctions.
3. Définissez Publish sur Code, Runtime stack sur Node.js et Version sur 16 LTS.
4. Sélectionnez un système d’exploitation et un type de plan.
5. Cliquez sur Next:Hosting.
6. Sélectionnez un compte de stockage.
7. Vérifiez les informations, puis créez votre application de fonctions.
8. Attendez que votre déploiement se termine.

Ajoutez une nouvelle fonction à votre application de fonctions en utilisant le modèle de déclencheur Event Hub.

1. Sélectionnez une application de fonctions nouvelle ou existante dans la liste des applications de fonctions.
2. Sélectionnez Functions dans le menu de fonctions et cliquez sur Create.
3. Sélectionnez un déclencheur Event Hub Azure dans le menu de modèles.
4. Sous Event Hub connection, sélectionnez votre espace de nommage et votre Event Hub.
5. Cliquez sur Create.

Pointez votre déclencheur Event Hub vers Datadog.

1. Sélectionnez votre nouveau déclencheur Event Hub dans la vue des fonctions.
2. Cliquez sur Code + Test dans le menu latéral pour les développeurs.
3. Ajoutez le code de la fonction Datadog/Azure à votre fichier index.js.
4. Ajoutez votre clé d’API en créant une variable d’environnement DD_API_KEY dans l’onglet de configuration de votre application de fonctions, ou copiez-la dans le code de la fonction en remplaçant <CLÉ_API_DATADOG> à la ligne 22.
5. Si vous n’utilisez pas le site Datadog US1, définissez votre site Datadog avec une variable d’environnement DD_SITE dans l’onglet de configuration de votre application de fonctions, ou copiez le paramètre de site dans le code de la fonction à la ligne 23.
6. Enregistrez la fonction.
7. Cliquez sur Integration, puis sur Azure Event Hubs sous le déclencheur et vérifiez les paramètres suivants :
   a. Event Parameter Name doit être défini sur eventHubMessages.
   b. Event Hub Cardinality doit être défini sur Many.
   c. Event Hub Data Type doit être vide.
8. Cliquez sur Save.
9. Vérifiez que votre configuration est valide en exécutant la fonction et en recherchant le message de test dans le Log Explorer de Datadog.
   Remarque : l’événement de log de test doit être dans un format JSON valide.

Logs d’activité

1. Dans le portail Azure, accédez à la section Activity Log.
2. Cliquez sur Diagnostic Settings.
3. Cliquez sur Add diagnostic setting.
4. Dans la section réservée aux catégories, sélectionnez les catégories de logs à envoyer à Datadog.
5. Dans la section réservée à la destination, sélectionnez Stream to an event hub.
6. Définissez l’espace de nommage et le nom de l’Event Hub. Ces derniers doivent correspondre à l’espace de nommage et au nom de l’Event Hub que vous avez utilisés pour créer votre déclencheur Event Hub.
7. Définissez la clé d’accès partagé. Celle-ci doit être configurée avec un accès en envoi ou en gestion.
8. Cliquez sur Save.
9. Vérifiez que les logs de cette ressource sont présents dans le Log Explorer de Datadog pour confirmer que votre configuration est valide.

Logs de ressource

Configurez vos services Azure de façon à ce que leurs logs soient envoyés au Event Hub à l’aide d’un nouveau paramètre de diagnostic.

1. Dans le portail Azure, accédez à la ressource dont les logs doivent être envoyés à Datadog.
2. Dans la section relative à la surveillance du volet de la ressource, cliquez sur Diagnostic settings.
3. Cliquez sur Add diagnostic setting.
4. Dans la section réservée aux catégories, sélectionnez les catégories de logs à envoyer à Datadog.
5. Dans la section réservée à la destination, sélectionnez Stream to an event hub.
6. Définissez l’espace de nommage et le nom de l’Event Hub. Ces derniers doivent correspondre à l’espace de nommage et au nom de l’Event Hub que vous avez utilisés pour créer votre déclencheur Event Hub.
7. Définissez la clé d’accès partagé. Celle-ci doit être configurée avec un accès en envoi ou en gestion.
8. Cliquez sur Save.
9. Vérifiez que les logs de cette ressource sont présents dans le Log Explorer de Datadog pour confirmer que votre configuration est valide.

Pour recueillir des logs à partir de l’ensemble de vos Azure App Services, suivez cette méthode globale :

1. Configurez Stockage Blob Azure depuis le portail Azure, l’Explorateur Stockage Azure, l’interface de ligne de commande Azure ou Powershell.
2. Configurez la fonction Datadog/Azure chargée de transmettre les logs depuis votre stockage blob vers Datadog.
3. Configurez vos Azure App Services de façon à transférer leurs logs à Stockage Blob.

Créer une fonction Stockage Blob Azure

Si vous n’avez jamais utilisé de fonction Azure, consultez l’article Bien démarrer avec Azure Functions pour découvrir comment créer votre première fonction.

1. Dans le portail Azure, accédez à la vue d’ensemble Function Apps et cliquez sur Create.
2. Sélectionnez un abonnement, un groupe de ressources et une région, puis nommez vos applications de fonctions.
3. Définissez Publish sur Code, Runtime stack sur Node.js et Version sur 16 LTS.
4. Sélectionnez le système d’exploitation Windows et un type de plan.
5. Cliquez sur Next:Hosting.
6. Sélectionnez un compte de stockage.
7. Vérifiez les informations, puis créez votre fonction.
8. Une fois le déploiement terminé, sélectionnez votre nouvelle fonction dans la liste des applications de fonctions.
9. Choisissez de générer votre fonction In-portal et utilisez le modèle de déclencheur de Stockage Blob (sous More templates…). Si besoin, installez l’extension Microsoft.Azure.WebJobs.Extensions.EventHubs.
10. Sélectionnez ou ajoutez la connexion du compte de stockage et cliquez sur Create.
11. Créez un fichier index.js et ajoutez le code de la fonction Datadog/Azure (remplacez <DATADOG_API_KEY> par votre clé d’API Datadog).
12. Enregistrez la fonction.
13. Pour la section Integrate, définissez Blob Parameter Name sur blobContent et cliquez sur Save.
14. Vérifiez que vos logs apparaissent dans le Log Explorer Datadog pour confirmer que votre configuration est valide.

Prérequis

Autorisations requises

Pour configurer l’intégration native Azure, vous devez bénéficier d’un accès Owner pour chacun des abonnements Azure que vous souhaitez associer, et d’un accès Admin pour l’organisation Datadog que vous leur associez. Vérifiez que c’est bien le cas avant de commencer la configuration.

Configuration SSO

(Facultatif) Vous pouvez configurez l’authentification unique (SSO) lors de la création d’une organisation dans Azure. Le SSO peut également est configuré ultérieurement. Pour effectuer la configuration dès la création initiale, commencez par créer une application de galerie professionnelle Datadog.

Installation

Pour configurer l’intégration Azure, il est nécessaire de créer une ressource Datadog dans Azure. Ces ressources représentent la connexion ou le lien entre une organisation Datadog et un abonnement Azure. Vous devez créer une ressource Datadog pour chaque abonnement que vous souhaitez surveiller avec Datadog.

Deux options s’offrent à vous lors de la création d’une ressource Datadog dans Azure :

1. Associer un abonnement à une organisation Datadog existante. Il s’agit de la méthode la plus courante. Cela vous permet de configurer votre organisation Datadog afin de surveiller un abonnement Azure qui n’a pas encore été lié. Cette action n’a aucun impact sur votre offre Datadog.

2. Créer une nouvelle organisation Datadog. Ce processus est moins courant. Utilisez cette option si vous n’avez pas encore d’organisation Datadog et que vous souhaitez souscrire un abonnement payant via la Place de marché Azure. Ce flux crée une organisation Datadog, permet de sélectionner une offre et lie l’abonnement Azure associé afin qu’il puisse être surveillé.

Remarque : aucun essai n’est proposé via l’option Create a new Datadog organization dans Azure. Pour commencer un essai gratuit, créez une organisation Datadog d’essai sur notre site US3, puis liez les abonnements que vous souhaitez surveiller.

Une fois que vous avez créé une ressource Datadog, la collecte des données commence pour l’abonnement associé. Consultez notre guide pour savoir comment utiliser cette ressource pour configurer, gérer et déployer Datadog.

Gestion automatique

Les instructions présentées sur cette page indiquent comment configurer l’intégration native Azure via le portail Azure. Si vous préférez utiliser des options automatiques, vous pouvez également consulter les ressources suivantes :

• Azure CLI pour Datadog

• Fournisseur Terraform Azure pour Datadog (veillez à inclure le bloc d’attribution de rôle)

Si vous souhaitez surveiller de nombreux abonnements avec l’intégration native Azure, nous vous recommandons d’utiliser Terraform pour créer les ressources Datadog. Pour savoir comment configurer Terraform pour plusieurs abonnements, consultez cet article de blog dédié au déploiement sur plusieurs abonnements Azure avec Terraform.

Créer une ressource Datadog

Pour commencer à surveiller un abonnement Azure, accédez à la page Service de Datadog dans Azure, puis sélectionnez l’option permettant de créer une ressource Datadog :

Choisissez Link Azure subscription to an existing Datadog organization ou Create a new Datadog organization. Associer un abonnement est l’action la plus courante. Cela vous permet de configurer la surveillance pour un abonnement Azure qui n’a pas encore été lié. Ne choisissez le flux Create que si vous n’êtes pas encore client Datadog et que vous souhaitez souscrire un abonnement payant.

Remarque : les coûts associés aux nouvelles organisations Datadog créées via le portail Azure sont automatiquement intégrés à la facturation Azure. Les données d’utilisation associées seront prises en compte pour le calcul de l’Engagement de consommation Microsoft Azure (MACC), le cas échéant.

Configuration

Éléments de base

Après avoir choisi d’associer une organisation Datadog existante, le portail affiche un formulaire permettant de créer la ressource Datadog :

Renseignez les champs suivants :

Propriété	Description
Subscription	L’abonnement Azure à surveiller avec Datadog. La ressource Datadog figurera dans cet abonnement. Vous devez disposer d’un accès propriétaire.
Resource group	Créez un groupe de ressources ou utilisez un groupe existant. Un groupe de ressources est un conteneur avec des ressources connexes pour une solution Azure.
Resource name	Attribuez un nom à la ressource Datadog. Voici le format recommandé : nom_abonnement-nom_org_datadog.
Emplacement	La région est West US 2. Il s’agit de la région dans laquelle le site US3 de Datadog est hébergé dans Azure. Comme tous les sites Datadog, le site US3 est entièrement SaaS et prend en charge la surveillance de toutes les régions Azure, ainsi que d’autres fournisseurs de cloud et des hosts sur site.
Datadog organization	Une fois l’étape d’authentification terminée, le nom de l’organisation Datadog est défini sur celui de l’organisation Datadog liée, et le site Datadog est défini sur US3.

Cliquez sur Link to Datadog organization pour ouvrir une fenêtre d’authentification Datadog, puis connectez-vous à Datadog.

Par défaut, Azure associe votre organisation Datadog actuelle à votre ressource Datadog. Si vous souhaitez associer une autre organisation, sélectionnez-la dans la fenêtre d’authentification :

Une fois le fllux oauth terminé, vérifiez que le nom de votre organisation Datadog est correct.

Après avoir terminé la configuration de base, cliquez sur l’option Next: Metrics and logs.

Éléments de base

Après avoir choisi de créer une organisation Datadog, le portail affiche un formulaire permettant de créer la ressource et l’organisation Datadog :

Renseignez les champs suivants :

Propriété	Description
Subscription	L’abonnement Azure à surveiller avec Datadog. La ressource Datadog figurera dans cet abonnement. Vous devez disposer d’un accès propriétaire.
Resource group	Créez un groupe de ressources ou utilisez un groupe existant. Un groupe de ressources est un conteneur avec des ressources connexes pour une solution Azure.
Resource name	Le nom de la ressource Datadog. Ce nom est attribué à la nouvelle organisation Datadog.
Emplacement	La région est West US 2. Il s’agit de la région dans laquelle le site US3 de Datadog est hébergé dans Azure. Comme tous les sites Datadog, le site US3 est entièrement SaaS et prend en charge la surveillance de toutes les régions Azure, ainsi que d’autres fournisseurs de cloud et des hosts sur site.
Datadog organization	Le nom de l’organisation Datadog correspond au nom de la ressource. Le site Datadog est défini sur US3.
Pricing plan	La liste des offres tarifaires Datadog disponibles. Si vous utilisez une offre exclusive, celle-ci figure dans cette liste déroulante.
Billing term	La facturation s’effectue mensuellement.

Section Metrics and logs

Collecte de métriques

Par défaut, les métriques de toutes les ressources Azure incluses dans l’abonnement sont automatiquement recueillies. Pour envoyer toutes les métriques à Datadog, aucune action supplémentaire n’est requise.

Règles de tag pour l’envoi de métriques

Vous avez la possibilité de restreindre la collecte de métriques pour les VM Azure et les plans App Service. Pour ce faire, utilisez les tags Azure associés à vos ressources.

• Les machines virtuelles, les groupes de machines virtuelles identiques et les plans App Service qui possèdent des tags include envoient des métriques à Datadog.
• À l’inverse, les machines virtuelles, les groupes de machines virtuelles identiques et les plans App Service qui possèdent des tags exclude n’envoient pas de métriques à Datadog.
• En cas de conflit entre des règles d’inclusion et d’exclusion, la règle d’exclusion est prioritaire.
• Il n’est pas possible de limiter la collecte de métriques pour d’autres ressources.

Collecte de logs

Trois types de logs peuvent être envoyés par Azure à Datadog.

Les logs au niveau de l’abonnement fournissent des informations clés sur les opérations réalisées sur vos ressources dans le plan de contrôle. Les modifications apportées aux événements Service Health sont également incluses. Utilisez le log d’activité pour déterminer la nature des opérations d’écriture (PUT, POST et DELETE), la personne à leur origine et leur date.

Pour envoyer les logs au niveau de l’abonnement à Datadog, sélectionnez Send subscription activity logs. Si vous ne sélectionnez pas cette option, aucun log au niveau de l’abonnement ne sera envoyé à Datadog.

Les logs de ressource Azure fournissent des informations clés sur les opérations réalisées sur les ressources Azure dans le plan de données. Les opérations du plan de données consistent par exemple à récupérer un secret à partir d’un coffre de clés ou à transmettre une requête à une base de données. Le contenu de ces logs de ressources varie en fonction du service Azure et du type de ressource.

Pour envoyer des logs de ressource Azure à Datadog, sélectionnez Send Azure resource logs for all defined resources. Les types de logs de ressource Azure sont répertoriés dans les catégories de logs de ressource d’Azure Monitor. Si vous sélectionnez cette option, tous les logs de ressource seront envoyés à Datadog, y compris pour les nouvelles ressources créées dans l’abonnement.

Il est possible de filtrer l’ensemble des ressources Azure transmettant des logs à Datadog à l’aide de tags de ressource Azure.

Règles de tag pour l’envoi de logs

• Les ressources Azure qui possèdent des tags include envoient des logs à Datadog.
• Les ressources Azure qui possèdent des tags exclude n’envoient pas de logs à Datadog.
• En cas de conflit entre des règles d’inclusion et d’exclusion, la règle d’exclusion est prioritaire.

Par exemple, avec la règle de tag de la capture d’écran ci-dessous, seuls les machines virtuelles, groupes de machines virtuelles identiques et plans App Service avec le tag Datadog = True envoient des métriques et des logs à Datadog.

Les logs Azure Active Directory (Azure AD) contiennent l’historique des activités de connexion ainsi qu’une piste d’audit des modifications apportées dans Azure AD pour un client donné. Pour envoyer ces logs à Datadog, commencez par créer une ressource Datadog. Après avoir créé une ressource Datadog dans Azure, suivez la procédure de configuration indiquée dans le guide Datadog sur le portail Azure.

Après avoir terminé la configuration des métriques et logs, sélectionnez l’option Next: Security.

Securité

Grâce à la solution Cloud Security Posture Management (CSPM), vous pouvez évaluer et visualiser facilement la posture de sécurité actuelle et historique de votre environnement cloud, automatiser la collecte de preuves pour l’audit et détecter les problèmes de configuration susceptibles de rendre votre organisation vulnérable face à d’éventuelles attaques.

Pour activer la solution CSPM, sélectionnez Enable Datadog Cloud Security Posture Management. Cela active la solution CSPM pour tous les abonnements associés à la ressource Datadog.

Après avoir terminé la configuration de la solution CSPM, sélectionnez l’option Next: Single sign-on.

Authentification unique

(Facultatif) Si vous utilisez le fournisseur d’identité Azure Active Directory, activez l’authentification unique depuis le portail Azure vers Datadog.

Si vous associez la ressource Datadog à une organisation Datadog existante, vous ne pouvez pas configurer l’authentification unique lors de cette étape. Vous devez d’abord créer la ressource Datadog. Pour en savoir plus, consultez la section Reconfigurer l’authentification unique.

Pour effectuer l’authentification unique via Azure Active Directory, cochez la case Enable single sign-on through Azure Active Directory.

Le portail Azure récupère la ou les applications Datadog pertinentes depuis Azure Active Directory. Les apps d’entreprise Datadog créées avant de commencer le processus de création de la ressource Datadog sont répertoriées.

Sélectionnez l’application Datadog à utiliser. Si vous n’avez pas encore créé d’application, consultez la section de la documentation relative à la création d’une app de galerie Azure AD.

Sélectionnez l’option Next: Tags.

Tags

(Facultatif) Configurer des tags personnalisés pour votre nouvelle ressource Datadog. Attribuez-leur un nom et des paires de valeurs pour les appliquer à la ressource Datadog.

Après avoir ajouté les tags, sélectionnez l’option Next: Review + create.

Vérification et création

Vérifiez vos paramètres et les conditions d’utilisation. Une fois le processus de validation terminé, cliquez sur Create. Azure déploie alors la ressource Datadog. Cette dernière lie l’abonnement à votre compte Datadog et active un certain nombre de fonctionnalités pour la gestion continue de l’intégration. Vous trouverez de plus amples détails et des instructions dans notre guide sur la gestion de Datadog sur le portail Azure.

Une fois le déploiement terminé, sélectionnez Go to Resource pour afficher votre ressource Datadog.

Accéder à Datadog

Maintenant que votre ressource Datadog est créée, accédez à l’organisation Datadog associée. La méthode à suivre varie selon que vous avez créé une nouvelle organisation ou associé une organisation existante.

Avec le SSO

Si vous avez créé une nouvelle organisation Datadog en ayant pris soin de configurer le SSO, utilisez le lien dans le volet de la ressource Datadog pour vous identifier. Il s’agit d’un lien SAML qui vous permet de vous connecter directement à votre organisation Datadog depuis la ressource Datadog dans Azure.

Sans le SSO

Si vous avez créé une organisation Datadog sans configurer le SSO, utilisez le lien de l’organisation Datadog situé dans le volet de vue d’ensemble pour configurer votre mot de passe Datadog. Une fois votre mot de passe configuré, vous pouvez utiliser le lien, qui correspond à une URL Datadog standard.

Si vous avez associé une organisation Datadog existante, la méthode d’accès à votre organisation demeure inchangée.

Surveiller le statut de l’intégration

Une fois l’intégration configurée, Datadog commence à appeler en continu les API Azure pour recueillir les données de surveillance critiques de votre environnement Azure. Ces appels renvoient parfois des erreurs (si les identifiants fournis ont expiré, par exemple). Ces erreurs peuvent empêcher Datadog de recueillir les données de surveillance.

En cas d’erreurs critiques, l’intégration Azure génère des événements dans l’Events Explorer de Datadog et les republie toutes les cinq minutes. Vous pouvez configurer un monitor d’événement pour qu’il se déclenche lors de la détection de ces événements et envoie une notification à l’équipe appropriée.

Datadog fournit un monitor conseillé que vous pouvez utiliser comme modèle pour commencer. Pour utiliser le monitor conseillé :

1. Dans Datadog, accédez à Monitors -> New Monitor et sélectionnez l’onglet Recommended Monitors.
2. Sélectionnez le monitor conseillé nommé [Azure] Integration Errors.
3. Apportez les modifications voulues à la requête de recherche ou aux conditions d’alerte. Par défaut, le monitor se déclenche à chaque fois qu’une nouvelle erreur est détectée et se résout si l’erreur en question n’a pas été détectée au cours des 15 dernières minutes.
4. Modifiez les messages pour la notification initiale et les notifications suivantes selon vos besoins. Notez que les événements eux-mêmes contiennent des informations pertinentes qui seront automatiquement incluses dans la notification, notamment des informations détaillées concernant le contexte, l’erreur renvoyée et les actions courantes pour y remédier.
5. Configurez les notifications de sorte qu’elles soient envoyées via les canaux privilégiés (e-mail, Slack, PagerDuty ou autres) afin de garantir que votre équipe soit prévenue en cas de problèmes liés à la collecte des données Azure.

Configuration du SSO SAML

Pour utiliser l’authentification unique (SSO) Security Assertion Markup Language (SAML) dans la ressource Datadog, vous devez configurer une application d’entreprise.

Pour ajouter une application d’entreprise, il est nécessaire d’avoir un rôle d’administrateur global, d’administrateur d’application dans le cloud, d’administrateur d’application ou de propriétaire du service principal.

Suivez les étapes ci-dessous pour configurer une application d’entreprise :

1. Accédez au portail Azure et sélectionnez Azure Active Directory.

2. Dans le volet de gauche, sélectionnez Enterprise applications.

3. Sélectionnez New Application.

4. Sous la section Add from the gallery, recherchez Datadog. Sélectionnez le résultat de recherche, puis cliquez sur Add.

5. Une fois l’application créée, accédez à Properties dans le volet latéral. Configurez User assignment required? sur No, puis cliquez sur Save.

6. Accédez à Single sign-on dans le volet latéral, puis sélectionnez SAML.

7. Sélectionnez Yes pour enregistrer vos réglages d’authentification unique.

8. La configuration de l’authentification unique est désormais terminée.