Analyser les performances d’Azure App ServiceMonitor Azure App Service performance

L’activation de la supervision de vos applications web ASP.NET et ASP.NET Core exécutées sur Azure App Services n’a jamais été aussi facile.Enabling monitoring on your ASP.NET and ASP.NET Core based web applications running on Azure App Services is now easier than ever. Alors qu’auparavant vous deviez installer manuellement une extension de site, la dernière version de l’agent/extension est désormais intégrée à l’image App Service par défaut.Whereas previously you needed to manually install a site extension, the latest extension/agent is now built into the app service image by default. Cet article explique pas à pas comment activer la supervision Application Insights et vous donne des conseils d’automatisation du processus pour les déploiements à grande échelle.This article will walk you through enabling Application Insights monitoring as well as provide preliminary guidance for automating the process for large-scale deployments.

Notes

L’ajout manuel d’une extension de site Application Insights via Outils de développement > Extensions est une méthode dépréciée.Manually adding an Application Insights site extension via Development Tools > Extensions is deprecated. Cette méthode d’installation de l’extension était dépendante des mises à jour manuelles pour chaque nouvelle version.This method of extension installation was dependent on manual updates for each new version. La version stable la plus récente de l’extension est désormais préinstallée dans l’image App Service.The latest stable release of the extension is now preinstalled as part of the App Service image. Les fichiers se trouvent dans d:\Program Files (x86)\SiteExtensions\ApplicationInsightsAgent et sont automatiquement mis à jour avec chaque version stable.The files are located in d:\Program Files (x86)\SiteExtensions\ApplicationInsightsAgent and are automatically updated with each stable release. Si vous suivez les instructions ci-dessous pour activer la supervision basée sur un agent, l’extension dépréciée sera automatiquement supprimée.If you follow the agent based instructions to enable monitoring below, it will automatically remove the deprecated extension for you.

Activer Application InsightsEnable Application Insights

Il existe deux façons d’activer la supervision des applications hébergées par Azure App Services :There are two ways to enable application monitoring for Azure App Services hosted applications:

  • La supervision basée sur un agent de l’application (ApplicationInsightsAgent).Agent-based application monitoring (ApplicationInsightsAgent).

    • Cette méthode est la plus facile à activer, car elle ne nécessite aucune configuration avancée.This method is the easiest to enable, and no advanced configuration is required. Elle est souvent appelée supervision « runtime ».It is often referred to as "runtime" monitoring. Pour Azure App Services, nous vous conseillons d’activer ce niveau de supervision au minimum. Ensuite, selon votre scénario spécifique, vous pouvez évaluer si une supervision plus avancée par une instrumentation manuelle est nécessaire.For Azure App Services we recommend at a minimum enabling this level of monitoring, and then based on your specific scenario you can evaluate whether more advanced monitoring through manual instrumentation is needed.
  • L’instrumentation manuelle de l’application avec le code en installant le SDK Application Insights.Manually instrumenting the application through code by installing the Application Insights SDK.

Notes

Si les deux méthodes, la supervision basée sur un agent et l’instrumentation manuelle basée sur un Kit de développement logiciel (SDK), sont détectées, seuls les paramètres de l’instrumentation manuelle sont appliqués.If both agent-based monitoring and manual SDK-based instrumentation is detected, only the manual instrumentation settings will be honored. Cela évite que des données en double soient envoyées.This is to prevent duplicate data from being sent. Pour en savoir plus, consultez la section de résolution des problèmes.To learn more about this, check out the troubleshooting section below.

Activer la supervision basée sur un agentEnable agent-based monitoring

Notes

APPINSIGHTS_JAVASCRIPT_ENABLED et urlCompression ne peuvent pas être utilisés ensemble.The combination of APPINSIGHTS_JAVASCRIPT_ENABLED and urlCompression is not supported. Pour plus d’informations, consultez la section de résolution des problèmes.For more info see the explanation in the troubleshooting section.

  1. Sélectionnez Application Insights dans le panneau de configuration Azure pour votre service d’application.Select Application Insights in the Azure control panel for your app service.

    Sous Paramètres, choisissez Application Insights

    • Choisissez de créer une nouvelle ressource, sauf si vous avez déjà configuré une ressource Application Insights pour cette application.Choose to create a new resource, unless you already set up an Application Insights resource for this application.

      Notes

      Quand vous cliquez sur OK pour créer la ressource, vous êtes invité à Appliquer les paramètres de supervision.When you click OK to create the new resource you will be prompted to Apply monitoring settings. Si vous sélectionnez Continuer, votre nouvelle ressource Application Insights est liée à votre service d’application et déclenche un redémarrage de votre service d’application.Selecting Continue will link your new Application Insights resource to your app service, doing so will also trigger a restart of your app service.

      Instrumenter votre application web

  2. Après avoir spécifié la ressource à utiliser, vous pouvez choisir la façon dont Application Insights doit collecter les données par plateforme pour votre application.After specifying which resource to use, you can choose how you want application insights to collect data per platform for your application. La supervision des applications ASP.NET est activée par défaut avec deux niveaux de collecte différents.ASP.NET app monitoring is on-by-default with two different levels of collection.

    Choisir les options par plateforme

Voici un résumé des données collectées pour chaque itinéraire :Below is a summary of data collected for each route:

DonnéesData Collection .NET Basic.NET Basic Collection Collecte Recommandé .NET.NET Recommended collection
Ajoute les tendances d’utilisation de l’UC, de la mémoire et des E/SAdds CPU, memory, and I/O usage trends OuiYes OuiYes
Collecte les tendances d’utilisation et permet la mise en corrélation des résultats de la disponibilité avec les transactionsCollects usage trends, and enables correlation from availability results to transactions OuiYes OuiYes
Collecte les exceptions non gérées par le processus hôteCollects exceptions unhandled by the host process OuiYes OuiYes
Améliore la précision des métriques APM avec charge, quand l’échantillonnage est utiliséImproves APM metrics accuracy under load, when sampling is used OuiYes OuiYes
Met en corrélation les microservices dans les limites de requête/dépendanceCorrelates micro-services across request/dependency boundaries Non (fonctionnalités APM à instance unique uniquement)No (single-instance APM capabilities only) OuiYes
  1. Pour configurer des paramètres tels que l’échantillonnage, que vous pouviez auparavant contrôler au moyen du fichier applicationinsights.config, vous pouvez maintenant interagir avec ces mêmes paramètres en définissant les paramètres de l’application avec le préfixe correspondant.To configure settings like sampling, which you could previously control via the applicationinsights.config file you can now interact with those same settings via Application settings with a corresponding prefix.

    • Par exemple, pour changer le pourcentage d’échantillonnage initial, créez un paramètre d’application MicrosoftAppInsights_AdaptiveSamplingTelemetryProcessor_InitialSamplingPercentage avec la valeur 100.For example, to change the initial sampling percentage, you can create an Application setting of: MicrosoftAppInsights_AdaptiveSamplingTelemetryProcessor_InitialSamplingPercentage and a value of 100.

    • Pour obtenir la liste des paramètres du processeur de télémétrie pris en charge pour l’échantillonnage adaptatif, consultez le code et la documentation associée.For the list of supported adaptive sampling telemetry processor settings, you can consult the code and associated documentation.

Activer la supervision côté clientEnable client-side monitoring

La supervision côté client est activée pour ASP.NET.Client-side monitoring is opt-in for ASP.NET. Pour activer la supervision côté client :To enable client-side monitoring:

  • Sélectionnez Paramètres >** Paramètres de l’application **Select Settings >** **Application settings****
    • Sous Paramètres de l’application, ajoutez un nouveau nom de paramètre d’application et la valeur associée :Under Application settings, add a new app setting name and value:

      Nom : APPINSIGHTS_JAVASCRIPT_ENABLEDName: APPINSIGHTS_JAVASCRIPT_ENABLED

      Valeur: trueValue: true

    • Enregistrez les paramètres et Redémarrez votre application.Save the settings and Restart your app.

Capture d’écran de l’interface utilisateur Paramètres de l’application

Pour désactiver la supervision côté client, supprimez la paire clé-valeur associée dans les paramètres de l’application, ou définissez la valeur sur false.To disable client-side monitoring either remove the associated key value pair from the Application settings, or set the value to false.

Automatiser la supervisionAutomate monitoring

Pour activer la collecte de données de télémétrie avec Application Insights, il vous suffit de définir les paramètres de l’application :In order to enable telemetry collection with Application Insights, only the Application settings need to be set:

Paramètres d’application App Service avec les paramètres Application Insights disponibles

Définitions des paramètres d’applicationApplication settings definitions

Nom du paramètre d’applicationApp setting name DéfinitionDefinition ValeurValue
ApplicationInsightsAgent_EXTENSION_VERSIONApplicationInsightsAgent_EXTENSION_VERSION Extension principale, qui contrôle la supervision runtime.Main extension, which controls runtime monitoring. ~2
XDT_MicrosoftApplicationInsights_ModeXDT_MicrosoftApplicationInsights_Mode Dans le mode par défaut uniquement, les fonctionnalités essentielles sont activées afin de garantir des performances optimales.In default mode only, essential features are enabled in order to insure optimal performance. default ou recommended.default or recommended.
InstrumentationEngine_EXTENSION_VERSIONInstrumentationEngine_EXTENSION_VERSION Contrôle si le moteur de réécriture binaire InstrumentationEngine est activé.Controls if the binary-rewrite engine InstrumentationEngine will be turned on. Ce paramètre impacte les performances ainsi que les temps de démarrage/démarrage à froid.This setting has performance implications and impacts cold start/startup time. ~1
XDT_MicrosoftApplicationInsights_BaseExtensionsXDT_MicrosoftApplicationInsights_BaseExtensions Contrôle si le texte de tables SQL et Azure est capturé, ainsi que les appels de dépendances.Controls if SQL & Azure table text will be captured along with the dependency calls. Avertissement de performance : le temps de démarrage à froid de l’application sera perturbé.Performance warning: application cold start up time will be affected. Ce paramètre requiert InstrumentationEngine.This setting requires the InstrumentationEngine. ~1

Paramètres d’application App Service avec Azure Resource ManagerApp Service Application settings with Azure Resource Manager

Les paramètres d’application pour App Services peuvent être gérés et configurés à l’aide de modèles Azure Resource Manager.Application settings for App Services can be managed and configured with Azure Resource Manager templates. Cette méthode s’utilise pour déployer de nouvelles ressources App Service avec Azure Resource Manager Automation, ou pour modifier les paramètres de ressources existantes.This method can be used when deploying new App Service resources with Azure Resource Manager automation, or for modifying the settings of existing resources.

La structure de base des paramètres d’application JSON pour un service d’application est celle-ci :The basic structure of the application settings JSON for an app service is below:

      "resources": [
        {
          "name": "appsettings",
          "type": "config",
          "apiVersion": "2015-08-01",
          "dependsOn": [
            "[resourceId('Microsoft.Web/sites', variables('webSiteName'))]"
          ],
          "tags": {
            "displayName": "Application Insights Settings"
          },
          "properties": {
            "key1": "value1",
            "key2": "value2"
          }
        }
      ]

Pour obtenir un exemple de modèle Azure Resource Manager où les paramètres d’application sont configurés pour Application Insights, consultez ce modèle, en particulier la section débutant à la ligne 238.For an example of an Azure Resource Manager template with Application settings configured for Application Insights, this template can be helpful, specifically the section starting on line 238.

Pour créer un modèle Azure Resource Manager configuré avec tous les paramètres Application Insights par défaut, commencez le même processus que si vous souhaitiez créer une application web avec Application Insights activé.To create an Azure Resource Manager template with all the default Application Insights settings configured, begin the process as if you were going to create a new Web App with Application Insights enabled.

Sélectionnez Options d’automatisationSelect Automation options

Menu pour créer une application web App Service

Cette option génère le dernier modèle Azure Resource Manager configuré avec tous les paramètres nécessaires.This option generates the latest Azure Resource Manager template with all required settings configured.

Modèle d’application web App Service

Dans l’exemple ci-dessous, remplacez toutes les instances de AppMonitoredSite par le nom de votre site :Below is a sample, replace all instances of AppMonitoredSite with your site name:

{
    "resources": [
        {
            "name": "[parameters('name')]",
            "type": "Microsoft.Web/sites",
            "properties": {
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPINSIGHTS_INSTRUMENTATIONKEY",
                            "value": "[reference('microsoft.insights/components/AppMonitoredSite', '2015-05-01').InstrumentationKey]"
                        },
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference('microsoft.insights/components/AppMonitoredSite', '2015-05-01').ConnectionString]"
                        },
                        {
                            "name": "ApplicationInsightsAgent_EXTENSION_VERSION",
                            "value": "~2"
                        }
                    ]
                },
                "name": "[parameters('name')]",
                "serverFarmId": "[concat('/subscriptions/', parameters('subscriptionId'),'/resourcegroups/', parameters('serverFarmResourceGroup'), '/providers/Microsoft.Web/serverfarms/', parameters('hostingPlanName'))]",
                "hostingEnvironment": "[parameters('hostingEnvironment')]"
            },
            "dependsOn": [
                "[concat('Microsoft.Web/serverfarms/', parameters('hostingPlanName'))]",
                "microsoft.insights/components/AppMonitoredSite"
            ],
            "apiVersion": "2016-03-01",
            "location": "[parameters('location')]"
        },
        {
            "apiVersion": "2016-09-01",
            "name": "[parameters('hostingPlanName')]",
            "type": "Microsoft.Web/serverfarms",
            "location": "[parameters('location')]",
            "properties": {
                "name": "[parameters('hostingPlanName')]",
                "workerSizeId": "[parameters('workerSize')]",
                "numberOfWorkers": "1",
                "hostingEnvironment": "[parameters('hostingEnvironment')]"
            },
            "sku": {
                "Tier": "[parameters('sku')]",
                "Name": "[parameters('skuCode')]"
            }
        },
        {
            "apiVersion": "2015-05-01",
            "name": "AppMonitoredSite",
            "type": "microsoft.insights/components",
            "location": "West US 2",
            "properties": {
                "ApplicationId": "[parameters('name')]",
                "Request_Source": "IbizaWebAppExtensionCreate"
            }
        }
    ],
    "parameters": {
        "name": {
            "type": "string"
        },
        "hostingPlanName": {
            "type": "string"
        },
        "hostingEnvironment": {
            "type": "string"
        },
        "location": {
            "type": "string"
        },
        "sku": {
            "type": "string"
        },
        "skuCode": {
            "type": "string"
        },
        "workerSize": {
            "type": "string"
        },
        "serverFarmResourceGroup": {
            "type": "string"
        },
        "subscriptionId": {
            "type": "string"
        }
    },
    "$schema": "https://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0"
}

Activation par le biais de PowerShellEnabling through PowerShell

Pour activer la supervision de l’application avec PowerShell, modifiez uniquement les paramètres de l’application sous-jacents.In order to enable the application monitoring through PowerShell, only the underlying application settings need to be changed. L’exemple ci-dessous active la supervision de l’application pour un site web appelé « AppMonitoredSite » dans le groupe de ressources « AppMonitoredRG », et configure les données à envoyer à la clé d’instrumentation « 012345678-abcd-ef01-2345-6789abcd ».Below is a sample, which enables application monitoring for a website called "AppMonitoredSite" in the resource group "AppMonitoredRG", and configures data to be sent to the "012345678-abcd-ef01-2345-6789abcd" instrumentation key.

Notes

Cet article a été mis à jour pour tenir compte de l’utilisation du nouveau module Az d’Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Vous pouvez toujours utiliser le module AzureRM, qui continue à recevoir des correctifs de bogues jusqu’à au moins décembre 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Pour en savoir plus sur le nouveau module Az et la compatibilité avec AzureRM, consultez Présentation du nouveau module Az d’Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Pour des instructions d’installation du module Az, consultez Installer Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

$app = Get-AzWebApp -ResourceGroupName "AppMonitoredRG" -Name "AppMonitoredSite" -ErrorAction Stop
$newAppSettings = @{} # case-insensitive hash map
$app.SiteConfig.AppSettings | %{$newAppSettings[$_.Name] = $_.Value} # preserve non Application Insights application settings.
$newAppSettings["APPINSIGHTS_INSTRUMENTATIONKEY"] = "012345678-abcd-ef01-2345-6789abcd"; # set the Application Insights instrumentation key
$newAppSettings["APPLICATIONINSIGHTS_CONNECTION_STRING"] = "InstrumentationKey=012345678-abcd-ef01-2345-6789abcd"; # set the Application Insights connection string
$newAppSettings["ApplicationInsightsAgent_EXTENSION_VERSION"] = "~2"; # enable the ApplicationInsightsAgent
$app = Set-AzWebApp -AppSettings $newAppSettings -ResourceGroupName $app.ResourceGroup -Name $app.Name -ErrorAction Stop

Mise à niveau de l’agent/extension de supervisionUpgrade monitoring extension/agent

Mise à niveau à partir des versions 2.8.9 et ultérieuresUpgrading from versions 2.8.9 and up

La mise à niveau à partir de la version 2.8.9 s’effectue automatiquement, sans aucune action supplémentaire de votre part.Upgrading from version 2.8.9 happens automatically, without any additional actions. Les nouveaux bits de supervision sont remis en arrière-plan au service d’application cible, et sont collectés au redémarrage de l’application.The new monitoring bits are delivered in the background to the target app service, and on application restart they will be picked up.

Pour connaître la version de votre extension, consultez http://yoursitename.scm.azurewebsites.net/ApplicationInsightsTo check which version of the extension you are running visit http://yoursitename.scm.azurewebsites.net/ApplicationInsights

Capture d’écran du chemin d’URL http://yoursitename.scm.azurewebsites.net/ApplicationInsights

Mise à niveau à partir des versions 1.0.0 - 2.6.5Upgrade from versions 1.0.0 - 2.6.5

À compter de la version 2.8.9, l’extension de site préinstallée est utilisée.Starting with version 2.8.9 the pre-installed site extension is used. Si vous avez une version antérieure, vous pouvez la mettre à jour de deux façons :If you are an earlier version, you can update via one of two ways:

  • Mettre à niveau par activation dans le portail.Upgrade by enabling via the portal. (Même si vous avez installé l’extension Application Insights pour Azure App Service, l’interface utilisateur affiche uniquement le bouton Activer.(Even if you have the Application Insights extension for Azure App Service installed, the UI shows only Enable button. En arrière-plan, l’ancienne extension de site privée sera supprimée.)Behind the scenes, the old private site extension will be removed.)

  • Mettre à niveau par le biais de PowerShell :Upgrade through PowerShell:

    1. Définissez les paramètres de l’application pour activer l’extension de site préinstallée ApplicationInsightsAgent.Set the application settings to enable the pre-installed site extension ApplicationInsightsAgent. Consultez Activation par le biais de PowerShell.See Enabling through powershell.
    2. Supprimez manuellement l’extension de site privée nommée extension Application Insights pour Azure App Service.Manually remove the private site extension named Application Insights extension for Azure App Service.

Si vous réalisez la mise à niveau à partir d’une version antérieure à 2.5.1, vérifiez que les DLL ApplicationInsigths sont supprimées du dossier bin de l’application. Pour plus d’informations, consultez les étapes de résolution des problèmes.If the upgrade is done from a version prior to 2.5.1, check that the ApplicationInsigths dlls are removed from the application bin folder see troubleshooting steps.

DépannageTroubleshooting

Vous trouverez ci-après les étapes à suivre pas à pas pour résoudre les problèmes rencontrés avec la supervision basée sur un agent/une extension pour les applications .NET et .NET Core exécutées sur Azure App Services.Below is our step-by-step troubleshooting guide for extension/agent based monitoring for .NET and .NET Core based applications running on Azure App Services.

Notes

Les applications Java sont prises en charge sur Azure App Services seulement via l’instrumentation manuelle basée sur un SDK. Les étapes ci-dessous ne s’appliquent donc pas à ces scénarios.Java applications are only supported on Azure App Services via manual SDK based instrumentation and therefore the steps below do not apply to these scenarios.

  1. Vérifiez que l’application est supervisée via ApplicationInsightsAgent.Check that the application is monitored via ApplicationInsightsAgent.

    • Vérifiez que le paramètre d’application ApplicationInsightsAgent_EXTENSION_VERSION est défini à une valeur « ~2 ».Check that ApplicationInsightsAgent_EXTENSION_VERSION app setting is set to a value of "~2".
  2. Assurez-vous que l’application remplit les prérequis de la supervision.Ensure that the application meets the requirements to be monitored.

    • Accédez à https://yoursitename.scm.azurewebsites.net/ApplicationInsightsBrowse to https://yoursitename.scm.azurewebsites.net/ApplicationInsights

    Capture d’écran de la page de résultats https://yoursitename.scm.azurewebsites/applicationinsights

    • Vérifiez que l’extension est en cours d’exécution (Application Insights Extension Status affiche Pre-Installed Site Extension, version 2.8.12.1527, is running.)Confirm that the Application Insights Extension Status is Pre-Installed Site Extension, version 2.8.12.1527, is running.

    • Vérifiez la présence d’une source d’état similaire à cette valeur : Status source D:\home\LogFiles\ApplicationInsights\status\status_RD0003FF0317B6_4248_1.jsonConfirm that the status source exists and looks like: Status source D:\home\LogFiles\ApplicationInsights\status\status_RD0003FF0317B6_4248_1.json

      • S’il n’y en a pas, cela signifie que l’application n’est pas en cours d’exécution ou n’est pas prise en charge.If a similar value is not present, it means the application is not currently running or is not supported. Pour vous assurer que l’application est en cours d’exécution, essayez d’accéder manuellement à l’URL ou aux points de terminaison de l’application, afin d’exposer les informations d’exécution.To ensure that the application is running, try manually visiting the application url/application endpoints, which will allow the runtime information to become available.
    • Vérifiez que IKeyExists a la valeur trueConfirm that IKeyExists is true

      • Si la valeur est false, ajoutez APPINSIGHTS_INSTRUMENTATIONKEY et APPLICATIONINSIGHTS_CONNECTION_STRING avec votre GUID iKey aux paramètres de votre application.If it is false, add APPINSIGHTS_INSTRUMENTATIONKEY and APPLICATIONINSIGHTS_CONNECTION_STRING with your ikey guid to your application settings.
    • Vérifiez qu’il n’y a pas d’entrées AppAlreadyInstrumented, AppContainsDiagnosticSourceAssembly et AppContainsAspNetTelemetryCorrelationAssembly.Confirm that there are no entries for AppAlreadyInstrumented, AppContainsDiagnosticSourceAssembly, and AppContainsAspNetTelemetryCorrelationAssembly.

      • S’il y en a, supprimez les packages suivants de votre application : Microsoft.ApplicationInsights, System.Diagnostics.DiagnosticSource et Microsoft.AspNet.TelemetryCorrelation.If any of these entries exist, remove the following packages from your application: Microsoft.ApplicationInsights, System.Diagnostics.DiagnosticSource, and Microsoft.AspNet.TelemetryCorrelation.

Ce tableau explique plus en détail la signification de ces valeurs d’erreur, leurs causes sous-jacentes et les corrections conseillées :The table below provides a more detailed explanation of what these values mean, their underlying causes, and recommended fixes:

Valeur d’erreurProblem Value ExplicationExplanation FixFix
AppAlreadyInstrumented:true Cette valeur indique que l’extension a détecté que certains éléments du SDK sont déjà présents dans l’application et qu’ils seront mis en back-off.This value indicates that the extension detected that some aspect of the SDK is already present in the Application, and will back-off. Cela peut être dû à la présence d’une référence à System.Diagnostics.DiagnosticSource, Microsoft.AspNet.TelemetryCorrelation ou Microsoft.ApplicationInsightsIt can be due to a reference to System.Diagnostics.DiagnosticSource, Microsoft.AspNet.TelemetryCorrelation, or Microsoft.ApplicationInsights Supprimez la référence.Remove the references. Certaines de ces références sont ajoutées par défaut à partir de certains modèles Visual Studio, et les versions antérieures de Visual Studio ajoutent parfois des références à Microsoft.ApplicationInsights.Some of these references are added by default from certain Visual Studio templates, and older versions of Visual Studio may add references to Microsoft.ApplicationInsights.
AppAlreadyInstrumented:true Si l’application cible .NET Core 2.1 ou 2.2 et fait référence au métapaquet Microsoft.AspNetCore.All, elle utilise Application Insights, et l’extension sera mise en back-off.If the application is targeting .NET Core 2.1 or 2.2, and refers to Microsoft.AspNetCore.All meta-package, then it brings in Application Insights, and extension will back-off. Pour les clients sur .NET Core 2.1 ou 2.2, il est conseillé d’utiliser le métapaquet Microsoft.AspNetCore.App à la place.Customers on .NET Core 2.1,2.2 are recommended to use Microsoft.AspNetCore.App meta-package instead.
AppAlreadyInstrumented:true Cette valeur peut également être due à la présence des DLL ci-dessus, d’un déploiement précédent, dans le dossier de l’application.This value can also be caused by the presence of the above dlls in the app folder from a previous deployment. Supprimez ces DLL du dossier de l’application.Clean the app folder to ensure that these dlls are removed. Vérifiez le répertoire bin de votre application locale et le répertoire wwwroot sur l’App Service.Check both your local app's bin directory, and the wwwroot directory on the App Service. (Pour vérifier le répertoire wwwroot de votre application web App Service : Outils avancés (Kudu) > Console de débogage > CMD > home\site\wwwroot).(To check the wwwroot directory of your App Service web app: Advanced Tools (Kudu) > Debug console > CMD > home\site\wwwroot).
AppContainsAspNetTelemetryCorrelationAssembly: true Cette valeur indique que l’extension a détecté la présence de références à Microsoft.AspNet.TelemetryCorrelation dans l’application et qu’elle sera mise en back-off.This value indicates that extension detected references to Microsoft.AspNet.TelemetryCorrelation in the application, and will back-off. Supprimez la référence.Remove the reference.
AppContainsDiagnosticSourceAssembly**:true Cette valeur indique que l’extension a détecté la présence de références à System.Diagnostics.DiagnosticSource dans l’application et qu’elle sera mise en back-off.This value indicates that extension detected references to System.Diagnostics.DiagnosticSource in the application, and will back-off. Supprimez la référence.Remove the reference.
IKeyExists:false Cette valeur indique que la clé d’instrumentation n’est pas présente dans le paramètre d’application APPINSIGHTS_INSTRUMENTATIONKEY.This value indicates that the instrumentation key is not present in the AppSetting, APPINSIGHTS_INSTRUMENTATIONKEY. Causes possibles : Vous avez peut-être supprimé accidentellement les valeurs, oublié de définir les valeurs dans le script d’automatisation, etc.Possible causes: The values may have been accidentally removed, forgot to set the values in automation script, etc. Vérifiez que le paramètre est défini dans les paramètres d’application App Service.Make sure the setting is present in the App Service application settings.

APPINSIGHTS_JAVASCRIPT_ENABLED et urlCompression ne sont pas pris en chargeAPPINSIGHTS_JAVASCRIPT_ENABLED and urlCompression is not supported

Si vous utilisez APPINSIGHTS_JAVASCRIPT_ENABLED = true là où du contenu est encodé, vous pouvez voir ce type d’erreur :If you use APPINSIGHTS_JAVASCRIPT_ENABLED=true in cases where content is encoded, you might get errors like:

  • Erreur de réécriture d’URL 500500 URL rewrite error
  • Erreur du module de réécriture d’URL 500.53 avec un message indiquant que les règles de réécriture sortantes ne peuvent pas être appliquées quand le contenu de la réponse HTTP est encodé (« gzip »).500.53 URL rewrite module error with message Outbound rewrite rules cannot be applied when the content of the HTTP response is encoded ('gzip').

Cela est dû au fait que le paramètre d’application APPINSIGHTS_JAVASCRIPT_ENABLED est défini sur true alors qu’il y a du contenu encodé en même temps.This is due to the APPINSIGHTS_JAVASCRIPT_ENABLED application setting being set to true and content-encoding being present at the same time. Ce scénario n’est pas pris en charge actuellement.This scenario is not supported yet. La solution de contournement consiste à supprimer APPINSIGHTS_JAVASCRIPT_ENABLED de vos paramètres d’application.The workaround is to remove APPINSIGHTS_JAVASCRIPT_ENABLED from your application settings. Malheureusement, cela signifie que si l’instrumentation JavaScript côté client/navigateur est toujours requise, des références manuelles au SDK sont nécessaires pour vos pages web.Unfortunately this means that if client/browser-side JavaScript instrumentation is still required, manual SDK references are needed for your webpages. Suivez les instructions pour activer l’instrumentation manuelle avec le SDK JavaScript.Please follow the instructions for manual instrumentation with the JavaScript SDK.

Pour avoir les toutes dernières informations sur l’extension/agent Application Insights, consultez les notes de publication.For the latest information on the Application Insights agent/extension, check out the release notes.

PHP et WordPress ne sont pas pris en chargePHP and WordPress are not supported

Les sites PHP et WordPress ne sont pas pris en charge.PHP and WordPress sites are not supported. Il n’existe actuellement aucun SDK/agent officiellement pris en charge pour la supervision côté serveur de ces charges de travail.There is currently no officially supported SDK/agent for server-side monitoring of these workloads. Toutefois, il est possible d’opérer manuellement des transactions côté client sur un site PHP ou WordPress en ajoutant le JavaScript côté client à vos pages web à l’aide du SDK JavaScript.However, manually instrumenting client-side transactions on a PHP or WordPress site by adding the client-side javascript to your web pages can be accomplished by using the JavaScript SDK.

Chaîne de connexion et clé d’instrumentationConnection string and instrumentation key

Lorsque l’analyse sans code est utilisée, seule la chaîne de connexion est requise.When codeless monitoring is being used, only the connection string is required. Toutefois, nous vous recommandons quand même de définir la clé d’instrumentation pour préserver la compatibilité descendante avec les versions antérieures du SDK lorsque l’instrumentation manuelle est exécutée.However, we still recommend setting the instrumentation key to preserve backwards compatibility with older versions of the SDK when manual instrumentation is being performed.

Étapes suivantesNext steps