L’instrumentation automatique de Datadog repose sur l’API de profilage .NET CLR. Cette API n’autorise qu’un seul abonné (par exemple, le traceur .NET de Datadog avec le profileur activé). Pour garantir une visibilité maximale, exécutez une seule solution APM au sein de votre environnement d’application.

De plus, si vous utilisez l’intégration Azure Native, vous pouvez utiliser la ressource Datadog dans Azure pour ajouter l’extension à vos applications .NET. Pour obtenir des instructions, consultez la section de l’extension App Service du guide d’intégration Azure Native de Datadog.

La prise en charge des applications Web Java est en préversion pour l’extension v2.4+.

Il n’y a aucune incidence sur la facturation pour le traçage des applications Web Java pendant cette période.

Localement

Installez la CLI Datadog

npm install -g @datadog/datadog-ci @datadog/datadog-ci-plugin-aas

Installez la CLI Azure et authentifiez-vous avec az login.

Ensuite, exécutez la commande suivante pour configurer le conteneur sidecar :

export DD_API_KEY=<DATADOG_API_KEY>
export DD_SITE=<DATADOG_SITE>
datadog-ci aas instrument -s <subscription-id> -g <resource-group-name> -n <app-service-name>

Définissez votre site Datadog sur . La valeur par défaut est datadoghq.com.

L’interface de ligne de commande Datadog déduira automatiquement l’environnement d’exécution de votre application et installera l’application correspondante. Si cela échoue pour une raison quelconque, vous pouvez remplacer ce comportement en spécifiant un environnement d’exécution avec l’indicateur --windows-runtime.

Des indicateurs supplémentaires, comme --service et --env, peuvent être utilisés pour définir les tags de service et d’environnement. Pour une liste complète des options, exécutez datadog-ci aas instrument --help.

datadog-ci aas instrument n’a besoin d’être exécuté qu’une seule fois pour configurer l’instrumentation. Vous n’avez pas besoin de le réexécuter à chaque déploiement de code, réexécutez-le uniquement pour modifier votre configuration Datadog.

Azure Cloud Shell

Pour utiliser la CLI Datadog dans Azure Cloud Shell, ouvrez un cloud shell, définissez votre clé d’API et votre site dans les variables d’environnement DD_API_KEY et DD_SITE, et utilisez npx pour exécuter la CLI directement :

export DD_API_KEY=<DATADOG_API_KEY>
export DD_SITE=<DATADOG_SITE>
npx @datadog/datadog-ci aas instrument -s <subscription-id> -g <resource-group-name> -n <app-service-name>

Le module Terraform Datadog pour les applications Web Windows enveloppe la ressource azurerm_windows_web_app et configure automatiquement votre application Web pour Datadog Serverless Monitoring en ajoutant les variables d’environnement requises et l’extension d’application Web Windows pour votre environnement d’exécution.

Si vous n’avez pas encore configuré Terraform, installez Terraform, créez un nouveau répertoire et créez un fichier appelé main.tf.

Ensuite, ajoutez ce qui suit à votre configuration Terraform, en la mettant à jour si nécessaire selon vos besoins :

variable "datadog_api_key" {
  description = "Your Datadog API key"
  type        = string
  sensitive   = true
}

provider "azurerm" {
  features {}
  subscription_id = "00000000-0000-0000-0000-000000000000" // Replace with your subscription ID
}

resource "azurerm_service_plan" "my_asp" {
  name                = "my-app-service-plan" // Replace with your app service plan name
  resource_group_name = "my-resource-group"   // Replace with your resource group
  os_type             = "Windows"
  location            = "eastus"
  sku_name            = "P1v2"
}

module "my_web_app" {
  source  = "DataDog/web-app-datadog/azurerm//modules/windows"
  version = "~> 1.0"

  name                = "my-web-app"        // Replace with your web app name
  resource_group_name = "my-resource-group" // Replace with your resource group
  service_plan_id     = azurerm_service_plan.my_asp.id
  location            = "eastus"

  datadog_api_key = var.datadog_api_key
  datadog_service = "my-service" // Replace with your service name
  datadog_env     = "prod"       // Replace with your environment (e.g. prod, staging)
  datadog_version = "0.0.0"      // Replace with your application version

  site_config = {
    application_stack = {
      node_version = "~22" // change for your specific runtime
    }
  }
  app_settings = {
    DD_TRACE_ENABLED = "true" // Example setting
  }
}

Enfin, exécutez terraform apply et suivez les instructions.

Le module d’application Web Windows Datadog déploie uniquement la ressource et l’extension d’application Web, vous devez donc déployer votre code séparément.

Mettez à jour votre application Web existante pour inclure les paramètres d’application et l’extension Datadog nécessaires, comme suit :

// Version: 1.0.0
@secure()
param datadogApiKey string

resource webApp 'Microsoft.Web/sites@2025-03-01' = {
  // ...
  properties: {
    // ...
    siteConfig: {
      // ...
      appSettings: [
        //... Your existing app settings
        { name: 'DD_API_KEY', value: datadogApiKey }
        { name: 'DD_SITE', value: 'datadoghq.com' }  // Replace with your Datadog site
        { name: 'DD_SERVICE', value: 'my-service' }  // Replace with your service name
        { name: 'DD_ENV', value: 'prod' }            // Replace with your environment (e.g. prod, staging)
        { name: 'DD_VERSION', value: '0.0.0' }       // Replace with your application version
        // Add any additional options here
      ]
    }
  }
}

resource datadogExtension 'Microsoft.Web/sites/siteextensions@2025-03-01' = {
  parent: webApp
  // Uncomment the extension for your runtime:
  // name: 'Datadog.AzureAppServices.Node.Apm'
  // name: 'Datadog.AzureAppServices.DotNet'
  // name: 'Datadog.AzureAppServices.Java.Apm'
}

Déployez votre modèle mis à jour :

az deployment group create --resource-group <RESOURCE GROUP> --template-file <TEMPLATE FILE>

Remarque : Vous devrez arrêter et démarrer l’application manuellement (ou via un script), sinon le traçage automatique ne fonctionnera pas. Pour les mises à jour, vous devez vous assurer que l’application est arrêtée avant de déployer le modèle, et redémarrée une fois le déploiement terminé.

Consultez l’Manualonglet pour obtenir les descriptions de toutes les variables d’environnement.

Mettez à jour votre application Web existante pour inclure les paramètres d’application Datadog et le sidecar nécessaires, comme suit :

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": { "version": "1.0.0" },
  "parameters": {
    "webAppName": {
      "type": "string"
    },
    // ...
    "datadogApiKey": {
      "type": "securestring"
    }
  },
  "resources": {
    "webApp": {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2025-03-01",
      "name": "[parameters('webAppName')]",
      // ...
      "properties": {
        // ...
        "siteConfig": {
          // ...
          "appSettings": [
            //... Your existing app settings
            { "name": "DD_API_KEY", "value": "[parameters('datadogApiKey')]" },
            { "name": "DD_SITE", "value": "datadoghq.com" }, // Replace with your Datadog site
            { "name": "DD_SERVICE", "value": "my-service" }, // Replace with your service name
            { "name": "DD_ENV", "value": "prod" },           // Replace with your environment (e.g. prod, staging)
            { "name": "DD_VERSION", "value": "0.0.0" },      // Replace with your application version
            // Add any additional options here
          ]
        }
      }
    },
    "datadogExtension": {
      "type": "Microsoft.Web/sites/siteextensions",
      "apiVersion": "2025-03-01",
      // Uncomment the extension for your runtime:
      // "name": "[concat(parameters('webAppName'), '/Datadog.AzureAppServices.Node.Apm')]"
      // "name": "[concat(parameters('webAppName'), '/Datadog.AzureAppServices.DotNet')]"
      // "name": "[concat(parameters('webAppName'), '/Datadog.AzureAppServices.Java.Apm')]"
    }
  }
}

Déployez votre modèle mis à jour :

az deployment group create --resource-group <RESOURCE GROUP> --template-file <TEMPLATE FILE>

Remarque : Vous devrez arrêter et démarrer l’application manuellement (ou via un script), sinon le traçage automatique ne fonctionnera pas. Pour les mises à jour, vous devez vous assurer que l’application est arrêtée avant de déployer le modèle, et redémarrée une fois le déploiement terminé.

Consultez l’Manualonglet pour obtenir les descriptions de toutes les variables d’environnement.

1. Dans votre portail Azure, accédez au dashboard de l’application Azure que vous souhaitez instrumenter avec Datadog.

2. Configurez les paramètres d’application suivants :

   Variables d’environnement requises

   DD_API_KEY

   Valeur : Votre clé d’API Datadog.
   Consultez Organization Settings > API Keys dans Datadog.
   

   DD_SITE

   Valeur : Votre site Datadog
   Votre site Datadog. Par défaut datadoghq.com.
   

   Unified Service Tagging

   Datadog recommande de marquer votre application avec les tags env, service et version pour le unified service tagging.

   DD_SERVICE

   Valeur : Le nom de service de votre application.
   

   DD_ENV

   Valeur : Le nom d’environnement de votre application.
   Il n’y a pas de valeur par défaut pour ce champ.
   

   DD_VERSION

   Valeur : La version de votre application.
   Il n’y a pas de valeur par défaut pour ce champ.
   

   Variables d’environnement supplémentaires

   DD_LOGS_INJECTION

   Valeur : true (recommandé)
   Active la corrélation trace-log en injectant des identifiants de trace dans les logs de votre application.
   Cela vous permet de corréler les logs avec les traces dans l’interface utilisateur Datadog.
   

3. Cliquez sur Save. Cela redémarre votre application.

4. Arrêtez votre application en cliquant sur Stop.

   Vous devez arrêter votre application pour installer Datadog avec succès.

5. Dans votre portail Azure, accédez à la page Extensions et sélectionnez l’extension Datadog APM.

6. Acceptez les conditions légales, cliquez sur OK et attendez que l’installation se termine.

   Cette étape nécessite que votre application soit à l'arrêt.

7. Démarrez l’application principale, cliquez sur Start :

8. Vérifiez que l’extension est installée et en cours d’exécution en consultant la page Extensions dans votre portail Azure.

1. Add the DogStatsD NuGet package to your Visual Studio project.
2. Initialize DogStatsD and write custom metrics in your application.
3. Deploy your code to Azure App Service.
4. If you have not already, install the Datadog App Service extension.

To send metrics, use this code:

// Configure your DogStatsd client and configure any tags
if (!DogStatsd.Configure(new StatsdConfig() { ConstantTags = new[] { "app:sample.mvc.aspnetcore" } }))
{
    // `Configure` returns false if the necessary environment variables are not present.
    // These environment variables are present in Azure App Service, but
    // need to be set in order to test your custom metrics: DD_API_KEY:{api_key}, DD_AGENT_HOST:localhost
    // Ignore or log the error as it suits you
    Console.WriteLine("Cannot initialize DogstatsD.");
}

// Send a metric
DogStatsd.Increment("sample.startup");

1. Ajoutez le client DogStatsD à votre projet.
2. Initialisez DogStatsD et écrivez des métriques personnalisées dans votre application.
3. Déployez votre code sur une Azure Web App prise en charge.
4. Si ce n’est pas déjà fait, installez l’extension Datadog App Service.

Pour envoyer des métriques, utilisez ce code :

// Configure your DogStatsd client and configure any tags
StatsDClient client = new NonBlockingStatsDClientBuilder()
                            .constantTags("app:sample.service")
                            .build();
// Send a metric
client.Increment("sample.startup");

1. Initialisez DogStatsD et écrivez des métriques personnalisées dans votre application.
2. Déployez votre code sur une Azure Web App prise en charge.
3. Si ce n’est pas déjà fait, installez l’extension Node.js Azure App Service de Datadog.

Pour envoyer des métriques, utilisez ce code :

const tracer = require('dd-trace');
tracer.init();

tracer.dogstatsd.increment('example_metric.increment', 1, { environment: 'dev' });
tracer.dogstatsd.decrement('example_metric.decrement', 1, { environment: 'dev' });

You can send logs from your application in Azure App Service to Datadog in one of the following ways:

• Use the installation steps on this page to enable APM with the Datadog APM extension. Then enable Agentless logging.
• Use Agentless logging with the Serilog sink.

Both methods allow trace ID injection, making it possible to connect logs and traces in Datadog. To enable trace ID injection with the extension, add the application setting DD_LOGS_INJECTION:true.

L’envoi de logs depuis votre application dans Azure App Service vers Datadog nécessite la diffusion des logs vers Datadog directement depuis votre application. La soumission de logs avec cette méthode permet l’injection d’ID de trace, ce qui permet de connecter les logs et les traces dans Datadog.

L’envoi de logs depuis votre application dans Azure App Service vers Datadog nécessite la diffusion des logs vers Datadog directement depuis votre application. La soumission de logs avec cette méthode permet l’injection d’ID de trace, ce qui permet de connecter les logs et les traces dans Datadog.

Exemple de code : journalisation native Microsoft

Un exemple de configuration de la journalisation dans une application .NET à l’aide de Microsoft.Extensions.Logging :

using Microsoft.Extensions.Logging;

public class WeatherForecastController : ControllerBase
{
    private readonly ILogger<WeatherForecastController> _logger;

    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }

    [HttpGet]
    public IActionResult Get()
    {
        _logger.LogInformation("Processing weather forecast request");

        // Your business logic here
        var forecast = GetWeatherForecast();

        _logger.LogInformation("Weather forecast retrieved for user: {UserId}", userId);

        return Ok(forecast);
    }
}

Configuration de Program.cs

using Microsoft.Extensions.Logging;

var builder = WebApplication.CreateBuilder(args);

// Configure logging
builder.Logging.ClearProviders();
builder.Logging.AddConsole();
builder.Logging.AddDebug();

// Add structured logging with JSON format
builder.Logging.AddJsonConsole(options =>
{
    options.JsonWriterOptions = new JsonWriterOptions
    {
        Indented = true
    };
});

var app = builder.Build();
// ... rest of your application configuration

Configuration d’appsettings.json

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    },
    "Console": {
      "FormatterName": "json",
      "FormatterOptions": {
        "IncludeScopes": true,
        "TimestampFormat": "yyyy-MM-dd HH:mm:ss "
      }
    }
  }
}

Cette configuration inclut automatiquement la corrélation de trace lorsque DD_LOGS_INJECTION=true est défini dans les paramètres de votre application Azure App Service.

Consultez [Diffuser les logs directement vers l’Agent][1] pour configurer la journalisation des applications pour Java dans Azure App Service.

[1]: /logs/log_collection/java/ stream-logs-directly-to-the-agent

Pour configurer la journalisation des applications pour Node.js dans Azure App Service, consultez Journalisation Agentless avec Node.js.

Datadog fournit des scripts pour mettre à jour ou installer l’extension Azure App Service à l’aide de PowerShell. La gestion des extensions par script vous permet de mettre à jour les extensions en masse par groupe de ressources et de désigner l’installation de versions spécifiques de l’extension de site. Vous pouvez également utiliser des scripts pour ajouter l’extension par programmation dans les pipelines CI/CD, ainsi que pour découvrir et mettre à jour les extensions déjà installées.

Prérequis

• L’Azure CLI ou Azure Cloud Shell.
• Identifiants au niveau de l’utilisateur Azure App Service. Si vous ne disposez pas déjà d’identifiants, accédez à votre portail Azure et accédez à votre Web App ou Function App. Accédez à Deployment > Deployment Center pour créer ou récupérer vos identifiants au niveau de l’utilisateur.

Installation de l’extension pour la première fois

Le script d’installation ajoute la dernière version de l’extension à une application Azure Web App ou Azure Function App. Cela se produit par application, plutôt qu’au niveau du groupe de ressources.

1. Ouvrez l’interface de ligne de commande Azure (Azure CLI) ou Azure Cloud Shell.

2. Téléchargez le script d’installation à l’aide de la commande suivante :

   Invoke-WebRequest -Uri "https://raw.githubusercontent.com/DataDog/datadog-aas-extension/master/management-scripts/extension/install-latest-extension.ps1" -OutFile "install-latest-extension.ps1"
   

3. Exécutez la commande suivante en transmettant les arguments requis et facultatifs selon vos besoins.

   .\install-latest-extension.ps1 -Username <USERNAME> -Password <PASSWORD> -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -SiteName <SITE_NAME> -DDApiKey <DATADOG_API_KEY> -DDSite <DATADOG_SITE> -DDEnv <DATADOG_ENV> -DDService <DATADOG_SERVICE> -DDVersion <DATADOG_VERSION> [-SlotName <SLOT_NAME>]
   

Remarque : Les arguments suivants sont requis pour la commande ci-dessus :

• <USERNAME> : Votre nom d’utilisateur au niveau de l’utilisateur Azure.
• <PASSWORD> : Votre mot de passe au niveau de l’utilisateur Azure.
• <SUBSCRIPTION_ID> : Votre ID d’abonnement Azure.
• <RESOURCE_GROUP_NAME> : Le nom de votre groupe de ressources Azure.
• <SITE_NAME> : Le nom de votre application.
• <DATADOG_API_KEY> : Votre clé d’API Datadog.

Définissez également DATADOG_SITE sur votre site Datadog. DATADOG_SITE a pour valeur par défaut datadoghq.com. Votre site est : .

Pour cibler un emplacement de déploiement au lieu de l’application principale, ajoutez -SlotName <SLOT_NAME>. Sur les Azure Function Apps, cela applique également automatiquement le paramètre d’emplacement fixe WEBSITE_PRIVATE_EXTENSIONS=0 pour éviter les échecs d’installation de l’extension. Consultez l’extension APM .NET pour Azure Functions pour plus de détails.

Mise à jour de l’extension pour un groupe de ressources

Le script de mise à jour s’applique à un groupe de ressources entier. Ce script met à jour chaque Web App ou Function App sur laquelle l’extension est installée. Les applications App Service sur lesquelles l’extension Datadog n’est pas installée ne sont pas affectées.

1. Ouvrez l’interface de ligne de commande Azure (Azure CLI) ou Azure Cloud Shell.

2. Téléchargez le script de mise à jour à l’aide de la commande suivante :

   $baseUri="https://raw.githubusercontent.com/DataDog/datadog-aas-extension/master/management-scripts/extension"; Invoke-WebRequest -Uri "$baseUri/update-all-site-extensions.ps1" -OutFile "update-all-site-extensions.ps1"; Invoke-WebRequest -Uri "$baseUri/install-latest-extension.ps1" -OutFile "install-latest-extension.ps1"
   

3. Exécutez la commande suivante. Tous les arguments sont obligatoires.

   .\update-all-site-extensions.ps1 -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -Username <USERNAME> -Password <PASSWORD>
   

Installer une version spécifique de l’extension

L’interface utilisateur d’Azure App Service ne prend pas en charge la possibilité d’installer une version spécifique d’une extension. Vous pouvez le faire avec le script d’installation ou de mise à jour.

Installer une version spécifique sur une ressource unique

Pour installer une version spécifique sur une instance unique, suivez les instructions d’installation de l’extension pour la première fois et ajoutez le paramètre -ExtensionVersion à la commande d’installation.

.\install-latest-extension.ps1 -Username <USERNAME> -Password <PASSWORD> -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -SiteName <SITE_NAME> -DDApiKey <DATADOG_API_KEY> -ExtensionVersion <EXTENSION_VERSION>

Remplacez <EXTENSION_VERSION> par la version de l’extension que vous souhaitez installer. Par exemple, 1.4.0.

Installer une version spécifique sur un groupe de ressources entier

Pour installer une version spécifique pour un groupe de ressources, suivez les instructions de mise à jour de l’extension pour un groupe de ressources et ajoutez le paramètre -ExtensionVersion à la commande d’installation.

.\update-all-site-extensions.ps1 -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -Username <USERNAME> -Password <PASSWORD> -ExtensionVersion <EXTENSION_VERSION>

Remplacez <EXTENSION_VERSION> par la version de l’extension que vous souhaitez installer. Par exemple, 1.4.0.

Modèle ARM

De nombreuses organisations utilisent des modèles Azure Resource Management (ARM) pour mettre en œuvre la pratique de l’infrastructure en tant que code. Pour intégrer l’extension App Service dans ces modèles, incorporez les modèles d’installation de l’extension App Service de Datadog dans vos déploiements afin d’ajouter l’extension et de la configurer avec vos ressources App Service.