Azure App Service-prestaties bewakenMonitor Azure App Service performance

Inschakelen van de controle van uw .NET en .NET Core op basis van webtoepassingen die worden uitgevoerd op Azure App Services is nu eenvoudiger dan ooit.Enabling monitoring on your .NET and .NET Core based web applications running on Azure App Services is now easier than ever. Dat u eerder hebt u nodig hebt om een site-extensie handmatig installeren, worden de nieuwste extensie/agent nu in de installatiekopie van het app service standaard ingebouwd.Whereas previously you needed to manually install a site extension, the latest extension/agent is now built into the app service image by default. In dit artikel wordt u stapsgewijs door het inschakelen van bewaking van Application Insights, evenals voorlopige richtlijnen voor het automatiseren van het proces voor grootschalige implementaties.This article will walk you through enabling Application Insights monitoring as well as provide preliminary guidance for automating the process for large-scale deployments.

Notitie

Handmatig toevoegen van een Application Insights-extensie voor site via ontwikkeltools > extensies is afgeschaft.Manually adding an Application Insights site extension via Development Tools > Extensions is deprecated. Deze methode van de installatie van de extensie is afhankelijk van handmatige updates voor elke nieuwe versie.This method of extension installation was dependent on manual updates for each new version. De nieuwste stabiele versie van de extensie is nu vooraf als onderdeel van de installatiekopie van het App Service.The latest stable release of the extension is now preinstalled as part of the App Service image. De bestanden bevinden zich in d:\Program Files (x86)\SiteExtensions\ApplicationInsightsAgent en worden automatisch bijgewerkt met elke stabiele versie.The files are located in d:\Program Files (x86)\SiteExtensions\ApplicationInsightsAgent and are automatically updated with each stable release. Als u de agent op basis van-instructies voor het inschakelen van bewaking volgt hieronder, de afgeschafte extensie automatisch worden verwijderd voor u.If you follow the agent based instructions to enable monitoring below, it will automatically remove the deprecated extension for you.

Application Insights inschakelenEnable Application Insights

Er zijn twee manieren om in te schakelen toepassingsbewaking voor toepassingen in Azure App Services die worden gehost:There are two ways to enable application monitoring for Azure App Services hosted applications:

  • Bewaking van toepassingen op basis van een agent (ApplicationInsightsAgent).Agent-based application monitoring (ApplicationInsightsAgent).

    • Deze methode is de eenvoudigste manier om in te schakelen en er zijn geen geavanceerde configuratie is vereist.This method is the easiest to enable, and no advanced configuration is required. Dit wordt vaak aangeduid als '' runtimecontrole.It is often referred to as "runtime" monitoring. Voor Azure App Services we raden ten minste inschakelen dit niveau van controle en klik vervolgens op basis van uw specifieke scenario die u evalueren kunt of meer geavanceerde controle via handmatige instrumentation nodig is.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.
  • De toepassing via code handmatig te instrumenteren door het installeren van de Application Insights-SDK.Manually instrumenting the application through code by installing the Application Insights SDK.

Notitie

Als de controle van de agent op basis van zowel handmatige SDK op basis van instrumentation wordt gedetecteerd dat alleen de instellingen voor handmatige instrumentation zal worden herkend.If both agent based monitoring and manual SDK based instrumentation is detected only the manual instrumentation settings will be honored. Zo wordt voorkomen dat dubbele gegevens verzonden.This is to prevent duplicate data from sent. Voor meer informatie over deze controle uit de sectie troubleshooting hieronder.To learn more about this check out the troubleshooting section below.

Schakel bewaking .NET op basis van een agentEnable agent-based monitoring .NET

Notitie

De combinatie van APPINSIGHTS_JAVASCRIPT_ENABLED en urlCompression wordt niet ondersteund.The combination of APPINSIGHTS_JAVASCRIPT_ENABLED and urlCompression is not supported. Zie voor meer informatie de uitleg in de sectie troubleshooting.For more info see the explanation in the troubleshooting section.

  1. Selecteer Application Insights in de Azure-Configuratiescherm voor uw appservice.Select Application Insights in the Azure control panel for your app service.

    Kies Application Insights onder instellingen.

    • Te kiezen om een nieuwe resource te maken, tenzij u al een Application Insights-resource voor deze toepassing instellen.Choose to create a new resource, unless you already set up an Application Insights resource for this application.

      Notitie

      Wanneer u klikt op OK te maken van de nieuwe resource wordt u gevraagd naar controle-instellingen toepassen.When you click OK to create the new resource you will be prompted to Apply monitoring settings. Selecteren doorgaan uw nieuwe Application Insights-resource wordt gekoppeld aan uw appservice, doet dit het geval is, wordt ook activeert u opnieuw opstarten van uw appservice.Selecting Continue will link your new Application Insights resource to your app service, doing so will also trigger a restart of your app service.

      Uw web-app instrumenteren

  2. Na het op te geven welke resource moet worden gebruikt, kunt u kiezen hoe application insights voor het verzamelen van gegevens per platform voor uw toepassing.After specifying which resource to use, you can choose how you want application insights to collect data per platform for your application. ASP.NET-app-controle op standaard wordt met twee verschillende niveaus van de verzameling.ASP.NET app monitoring is on-by-default with two different levels of collection.

    Kies opties per platform

    • .NET basic verzameling niveau essentiële single instance APM mogelijkheden biedt..NET Basic collection level offers essential single-instance APM capabilities.

    • .NET verzameling aanbevolen niveau:.NET Recommended collection level:

      • Voegt de CPU, geheugen en i/o trends in gebruik.Adds CPU, memory, and I/O usage trends.
      • Correleert microservices grenzen van de aanvraag/afhankelijkheid.Correlates micro-services across request/dependency boundaries.
      • Trends in gebruik worden verzameld, en kunt correlatie van resultaten van beschikbaarheid voor transacties.Collects usage trends, and enables correlation from availability results to transactions.
      • Verzamelt de uitzonderingen die niet is verwerkt door het hostproces.Collects exceptions unhandled by the host process.
      • Verbetert de nauwkeurigheid van de APM-metrische gegevens onder belasting, wanneer steekproeven wordt gebruikt.Improves APM metrics accuracy under load, when sampling is used.
  3. Als u wilt configureren van instellingen, zoals steekproeven, die u eerder via het bestand applicationinsights.config beheren kan kunt u nu communiceert met die dezelfde instellingen via de toepassingsinstellingen in met een overeenkomende voorvoegsel.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.

    • Als u wilt wijzigen van de eerste voorbeeldpercentage, kunt u bijvoorbeeld een toepassingsinstelling van maken: MicrosoftAppInsights_AdaptiveSamplingTelemetryProcessor_InitialSamplingPercentage en een waarde van 100.For example, to change the initial sampling percentage, you can create an Application setting of: MicrosoftAppInsights_AdaptiveSamplingTelemetryProcessor_InitialSamplingPercentage and a value of 100.

    • U kunt raadplegen voor een lijst van ondersteunde adaptieve steekproeven telemetrie processor-instellingen, de code en die zijn gekoppeld documentatie.For the list of supported adaptive sampling telemetry processor settings, you can consult the code and associated documentation.

Monitoring .NET Core op basis van een agent inschakelenEnable agent-based monitoring .NET Core

De volgende versies van .NET Core worden ondersteund: ASP.NET Core 2.0, ASP.NET Core, 2.1, ASP.NET Core 2.2The following versions of .NET Core are supported: ASP.NET Core 2.0, ASP.NET Core 2.1, ASP.NET Core 2.2

Die gericht is op het volledige framework vanaf .NET Core, onafhankelijke implementatie- en ASP.NET Core 3.0 zijn momenteel niet ondersteund met agentextensie op basis van bewaking.Targeting the full framework from .NET Core, self-contained deployment, and ASP.NET Core 3.0 are currently not supported with agent/extension based monitoring. (Handmatige instrumentation via programmacode werkt in alle vorige scenario's.)(Manual instrumentation via code will work in all of the previous scenarios.)

  1. Selecteer Application Insights in de Azure-Configuratiescherm voor uw appservice.Select Application Insights in the Azure control panel for your app service.

    Kies Application Insights onder instellingen.

    • Te kiezen om een nieuwe resource te maken, tenzij u al een Application Insights-resource voor deze toepassing instellen.Choose to create a new resource, unless you already set up an Application Insights resource for this application.

      Notitie

      Wanneer u klikt op OK te maken van de nieuwe resource wordt u gevraagd naar controle-instellingen toepassen.When you click OK to create the new resource you will be prompted to Apply monitoring settings. Selecteren doorgaan uw nieuwe Application Insights-resource wordt gekoppeld aan uw appservice, doet dit het geval is, wordt ook activeert u opnieuw opstarten van uw appservice.Selecting Continue will link your new Application Insights resource to your app service, doing so will also trigger a restart of your app service.

      Uw web-app instrumenteren

  2. Na het op te geven welke resource moet worden gebruikt, kunt u kiezen hoe Application Insights voor het verzamelen van gegevens per platform voor uw toepassing.After specifying which resource to use, you can choose how you want Application Insights to collect data per platform for your application. .NET core biedt verzameling aanbevolen of uitgeschakelde voor .NET Core 2.0 en 2.1 2.2..NET Core offers Recommended collection or Disabled for .NET Core 2.0, 2.1, and 2.2.

    Kies opties per platform

Client-side monitoring .NET inschakelenEnable client-side monitoring .NET

Bewaking aan clientzijde is aanmelden voor ASP.NET.Client-side monitoring is opt-in for ASP.NET. Aan de clientzijde bewaking inschakelen:To enable client-side monitoring:

  • Selecteer instellingen > ** ** toepassing instellingen ***Select Settings >** **Application settings****
    • Voeg een nieuwe onder toepassingsinstellingen, naam van de app-instelling en waarde:Under Application settings, add a new app setting name and value:

      Naam: APPINSIGHTS_JAVASCRIPT_ENABLEDName: APPINSIGHTS_JAVASCRIPT_ENABLED

      Waarde:trueValue: true

    • Sla de instellingen op met Opslaan en start de app opnieuw met Opnieuw opstarten.Save the settings and Restart your app.

Schermopname van de toepassing van instellingen voor gebruikersinterface

Client-side bewaking een verwijderen van de bijbehorende sleutel-waardepaar uit de toepassingsinstellingen uitschakelen of de waarde ingesteld op false.To disable client-side monitoring either remove the associated key value pair from the Application settings, or set the value to false.

Client-side monitoring .NET Core inschakelenEnable client-side monitoring .NET Core

Bewaking aan clientzijde is standaard ingeschakeld voor .NET Core-apps met verzameling aanbevolen, ongeacht of de app-instelling 'APPINSIGHTS_JAVASCRIPT_ENABLED' aanwezig is.Client-side monitoring is enabled by default for .NET Core apps with Recommended collection, regardless of whether the app setting 'APPINSIGHTS_JAVASCRIPT_ENABLED' is present.

Als u wilt om een bepaalde reden Schakel bewaking aan clientzijde uit:If for some reason you would like to disable client-side monitoring:

  • Selecteer instellingen > toepassingsinstellingenSelect Settings > Application settings
    • Voeg een nieuwe onder toepassingsinstellingen, naam van de app-instelling en waarde:Under Application settings, add a new app setting name and value:

      Naam: APPINSIGHTS_JAVASCRIPT_ENABLEDname: APPINSIGHTS_JAVASCRIPT_ENABLED

      Waarde:falseValue: false

    • Sla de instellingen op met Opslaan en start de app opnieuw met Opnieuw opstarten.Save the settings and Restart your app.

Schermopname van de toepassing van instellingen voor gebruikersinterface

Bewaking automatiserenAutomate monitoring

Alleen de instellingen van de toepassing moeten worden ingesteld zodat de verzameling van apparaattelemetrie met Application Insights:In order to enable telemetry collection with Application Insights, only the Application settings need to be set:

App Service-toepassing-instellingen met de beschikbare Application Insights-instellingen

Definities van Application-instellingenApplication settings definitions

Naam van de App-instellingApp setting name DefinitieDefinition ValueValue
ApplicationInsightsAgent_EXTENSION_VERSIONApplicationInsightsAgent_EXTENSION_VERSION Belangrijkste uitbreiding, waarmee wordt bepaald runtimecontrole.Main extension, which controls runtime monitoring. ~2
XDT_MicrosoftApplicationInsights_ModeXDT_MicrosoftApplicationInsights_Mode In zijn de modus alleen essentiële functies ingeschakeld om te verzekeren van optimale prestaties.In default mode only, essential features are enabled in order to insure optimal performance. default of recommended.default or recommended.
InstrumentationEngine_EXTENSION_VERSIONInstrumentationEngine_EXTENSION_VERSION Bepaalt of de engine voor het binaire bestand herschrijven InstrumentationEngine wordt ingeschakeld.Controls if the binary-rewrite engine InstrumentationEngine will be turned on. Deze instelling heeft gevolgen voor de prestaties en heeft gevolgen voor koude start/opstarttijd.This setting has performance implications and impacts cold start/startup time. ~1
XDT_MicrosoftApplicationInsights_BaseExtensionsXDT_MicrosoftApplicationInsights_BaseExtensions Controleert of SQL en Azure-tabel tekst wordt samen met de afhankelijkheidsaanroepen worden vastgelegd.Controls if SQL & Azure table text will be captured along with the dependency calls. Van Prestatiewaarschuwing: deze instelling moet de InstrumentationEngine.Performance warning: this setting requires the InstrumentationEngine. ~1

Instellingen voor App Service-toepassing met Azure Resource ManagerApp Service Application settings with Azure Resource Manager

Toepassingsinstellingen voor App Services kunnen worden beheerd en geconfigureerd met Azure Resource Manager-sjablonen.Application settings for App Services can be managed and configured with Azure Resource Manager templates. Deze methode kan worden gebruikt bij het implementeren van nieuwe App Service-resources met Azure Resource Manager-automatisering, of voor het wijzigen van de instellingen van bestaande resources.This method can be used when deploying new App Service resources with Azure Resource Manager automation, or for modifying the settings of existing resources.

Lager is dan de basisstructuur van de toepassingsinstellingen JSON voor een appservice: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"
          }
        }
      ]

Voor een voorbeeld van een Azure Resource Manager-sjabloon met toepassingsinstellingen geconfigureerd voor Application Insights, dit sjabloon kan nuttig zijn, name de sectie vanaf regel 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.

Beginnen met het proces voor het maken van een Azure Resource Manager-sjabloon met alle standaard Application Insights instellingen die zijn geconfigureerd, als u van plan zijn een nieuwe Web-App maken met Application Insights is ingeschakeld.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.

Selecteer opties voor AutomationSelect Automation options

Menu voor App Service web-app maken

Deze optie wordt de meest recente Azure Resource Manager-sjabloon gegenereerd met alle vereiste instellingen die zijn geconfigureerd.This option generates the latest Azure Resource Manager template with all required settings configured.

App Service web app-sjabloon

Hieronder volgt een voorbeeld, Vervang alle exemplaren van AppMonitoredSite met de sitenaam van uw: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": "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"
}

Notitie

De sjabloon wordt toepassingsinstellingen gegenereerd in de modus 'standaard'.The template will generate application settings in “default” mode. Deze modus is geoptimaliseerd voor prestaties, maar u kunt de sjabloon voor het activeren van ongeacht welke functies u wilt aanpassen.This mode is performance optimized, though you can modify the template to activate whichever features you prefer.

Inschakelen via PowerShellEnabling through PowerShell

De onderliggende toepassingsinstellingen moeten worden gewijzigd zodat de toepassing bewaken via PowerShell.In order to enable the application monitoring through PowerShell, only the underlying application settings need to be changed. Hieronder volgt een voorbeeld waarmee toepassingsbewaking voor een website met de naam 'AppMonitoredSite' in de resourcegroep 'AppMonitoredRG', en worden verzonden naar de instrumentatiesleutel '012345678-abcd-ef01-2345-6789abcd' configureert.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.

Notitie

Dit artikel is bijgewerkt voor het gebruik van de nieuwe Azure PowerShell Az-module.This article has been updated to use the new Azure PowerShell Az module. U kunt nog steeds de AzureRM-module die blijven ontvangen van oplossingen voor problemen tot ten minste December 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Zie voor meer informatie over de nieuwe Az-module en compatibiliteit met AzureRM Introductie van de nieuwe Az-module van Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Zie voor instructies over Az-module installeren, Azure PowerShell installeren.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"; # enable the ApplicationInsightsAgent
$newAppSettings["ApplicationInsightsAgent_EXTENSION_VERSION"] = "~2"; # enable the ApplicationInsightsAgent
$app = Set-AzWebApp -AppSettings $newAppSettings -ResourceGroupName $app.ResourceGroup -Name $app.Name -ErrorAction Stop

Controle-extensie/agent bijwerkenUpgrade monitoring extension/agent

Upgraden van versies 2.8.9 en omhoogUpgrading from versions 2.8.9 and up

Upgraden vanaf versie 2.8.9 gebeurt automatisch, zonder extra handelingen.Upgrading from version 2.8.9 happens automatically, without any additional actions. De nieuwe controle bits worden geleverd op de achtergrond voor de doel-app-service en toepassing opnieuw wordt opgestart ze opgehaald.The new monitoring bits are delivered in the background to the target app service, and on application restart they will be picked up.

Als u wilt controleren welke versie van de extensie wordt bezoek uitgevoerd http://yoursitename.scm.azurewebsites.net/ApplicationInsightsTo check which version of the extension you are running visit http://yoursitename.scm.azurewebsites.net/ApplicationInsights

Schermopname van het url-pad http://yoursitename.scm.azurewebsites.net/ApplicationInsights

Een upgrade uitvoert van versies 1.0.0 - 2.6.5Upgrade from versions 1.0.0 - 2.6.5

Vanaf versie 2.8.9 wordt de vooraf geïnstalleerde site-extensie gebruikt.Starting with version 2.8.9 the pre-installed site extension is used. Als u een eerdere versie, kunt u bijwerken via twee manieren:If you are an earlier version, you can update via one of two ways:

  • Werk bij vóór inschakelen via de portal.Upgrade by enabling via the portal. (Zelfs als u de extensie Application Insights voor Azure App Service is geïnstalleerd hebt, de gebruikersinterface geeft alleen inschakelen knop.(Even if you have the Application Insights extension for Azure App Service installed, the UI shows only Enable button. Achter de schermen, wordt de oude persoonlijke site-extensie verwijderd.)Behind the scenes, the old private site extension will be removed.)

  • Bijwerken via PowerShell:Upgrade through PowerShell:

    1. Stel de toepassingsinstellingen in de vooraf geïnstalleerde site-extensie ApplicationInsightsAgent inschakelen.Set the application settings to enable the pre-installed site extension ApplicationInsightsAgent. Zie inschakelen via powershell.See Enabling through powershell.
    2. Verwijder handmatig de persoonlijke site-extensie met de naam van Application Insights-extensie voor Azure App Service.Manually remove the private site extension named Application Insights extension for Azure App Service.

Als de upgrade van een eerdere versie dan 2.5.1 is voltooid, controleert u dat de ApplicationInsigths dll-bestanden zijn verwijderd uit de map bin Zie stappen voor probleemoplossing.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.

Problemen oplossenTroubleshooting

Hieronder vindt u onze stapsgewijze gids voor probleemoplossing voor de extensie/agent op basis van bewaking van .NET en .NET Core-toepassingen uitvoeren in 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.

Notitie

Java en Node.js-toepassingen worden alleen ondersteund in Azure App Services via handmatige op basis van SDK instrumentatie en daarom de onderstaande stappen niet van toepassing op deze scenario's.Java and Node.js 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. Controleer of de toepassing wordt bewaakt via ApplicationInsightsAgent.Check that the application is monitored via ApplicationInsightsAgent.

    • Controleer of ApplicationInsightsAgent_EXTENSION_VERSION app-instelling is ingesteld op een waarde van '~ 2'.Check that ApplicationInsightsAgent_EXTENSION_VERSION app setting is set to a value of "~2".
  2. Zorg ervoor dat de toepassing voldoet aan de vereisten om te worden bewaakt.Ensure that the application meets the requirements to be monitored.

    • Blader naar https://yoursitename.scm.azurewebsites.net/ApplicationInsightsBrowse to https://yoursitename.scm.azurewebsites.net/ApplicationInsights

    Schermafbeelding van https://yoursitename.scm.azurewebsites/applicationinsights pagina met zoekresultaten

    • Bevestig dat de Application Insights Extension Status is 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.

    • Controleer of de status-bron bestaat en lijkt op: 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

      • Als een vergelijkbare waarde niet aanwezig is, betekent dat de toepassing is op dit moment niet uitgevoerd of wordt niet ondersteund.If a similar value is not present, it means the application is not currently running or is not supported. Om ervoor te zorgen dat de toepassing wordt uitgevoerd, opnieuw handmatig naar de eindpunten van de url/toepassing toepassingen, waarmee de runtime-gegevens beschikbaar.To ensure that the application is running, try manually visiting the application url/application endpoints, which will allow the runtime information to become available.
    • Bevestig dat IKeyExists is trueConfirm that IKeyExists is true

      • Als deze ONWAAR is, voegt u toe ' APPINSIGHTS_INSTRUMENTATIONKEY met uw ikey guid naar de toepassingsinstellingen van uw.If it is false, add `APPINSIGHTS_INSTRUMENTATIONKEY with your ikey guid to your application settings.
    • Bevestig dat er zijn geen vermeldingen voor AppAlreadyInstrumented, AppContainsDiagnosticSourceAssembly, en AppContainsAspNetTelemetryCorrelationAssembly.Confirm that there are no entries for AppAlreadyInstrumented, AppContainsDiagnosticSourceAssembly, and AppContainsAspNetTelemetryCorrelationAssembly.

      • Als een van deze gegevens bestaat, verwijdert u de volgende pakketten van uw toepassing: Microsoft.ApplicationInsights, System.Diagnostics.DiagnosticSource, en 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.

De onderstaande tabel bevat een meer gedetailleerde uitleg van de betekenis van deze waarden, de onderliggende zorgt ervoor dat en aanbevolen oplossingen:The table below provides a more detailed explanation of what these values mean, their underlying causes, and recommended fixes:

Probleem-waardeProblem Value UitlegExplanation OplossenFix
AppAlreadyInstrumented:true Deze waarde geeft aan dat de extensie wordt gedetecteerd dat een bepaald aspect van de SDK al aanwezig in de toepassing is, en wordt uitstel.This value indicates that the extension detected that some aspect of the SDK is already present in the Application, and will back-off. Dit kan worden veroorzaakt door een verwijzing naar System.Diagnostics.DiagnosticSource, Microsoft.AspNet.TelemetryCorrelation, of Microsoft.ApplicationInsightsIt can be due to a reference to System.Diagnostics.DiagnosticSource, Microsoft.AspNet.TelemetryCorrelation, or Microsoft.ApplicationInsights Verwijder de verwijzingen.Remove the references. Sommige van deze verwijzingen worden standaard toegevoegd uit bepaalde Visual Studio-sjablonen en oudere versies van Visual Studio kunnen de verwijzingen naar toevoegen 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 Als de toepassing is gemaakt voor .NET Core 2.1 of 2.2 en naar verwijst Microsoft.AspNetCore.All meta-pakket, brengt in Application Insights en extensie wordt uitstel.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. Klanten met een .NET Core 2.1,2.2 zijn aanbevolen Microsoft.AspNetCore.App meta-pakket in plaats daarvan gebruiken.Customers on .NET Core 2.1,2.2 are recommended to use Microsoft.AspNetCore.App meta-package instead.
AppAlreadyInstrumented:true Deze waarde kan ook worden veroorzaakt door de aanwezigheid van de bovenstaande DLL-bestanden in de map app vanaf een eerdere implementatie.This value can also be caused by the presence of the above dlls in the app folder from a previous deployment. Schoon de app-map om ervoor te zorgen dat deze DLL-bestanden worden verwijderd.Clean the app folder to ensure that these dlls are removed.
AppContainsAspNetTelemetryCorrelationAssembly: true Deze waarde geeft aan dat extensie verwijzingen naar gedetecteerd Microsoft.AspNet.TelemetryCorrelation in de toepassing, en wordt uitstel.This value indicates that extension detected references to Microsoft.AspNet.TelemetryCorrelation in the application, and will back-off. Verwijder de verwijzing.Remove the reference.
AppContainsDiagnosticSourceAssembly**:true Deze waarde geeft aan dat extensie verwijzingen naar gedetecteerd System.Diagnostics.DiagnosticSource in de toepassing, en wordt uitstel.This value indicates that extension detected references to System.Diagnostics.DiagnosticSource in the application, and will back-off. Verwijder de verwijzing.Remove the reference.
IKeyExists:false Deze waarde geeft aan dat de instrumentatiesleutel is niet aanwezig in de instelling APPINSIGHTS_INSTRUMENTATIONKEY.This value indicates that the instrumentation key is not present in the AppSetting, APPINSIGHTS_INSTRUMENTATIONKEY. Mogelijke oorzaken: De waarden mogelijk per ongeluk verwijderd, bent u vergeten om in te stellen van de waarden in het automation-script, enzovoort.Possible causes: The values may have been accidentally removed, forgot to set the values in automation script, etc. Zorg ervoor dat de instelling is aanwezig in de instellingen van de App Service-toepassing.Make sure the setting is present in the App Service application settings.

APPINSIGHTS_JAVASCRIPT_ENABLED en urlCompression wordt niet ondersteundAPPINSIGHTS_JAVASCRIPT_ENABLED and urlCompression is not supported

Als u APPINSIGHTS_JAVASCRIPT_ENABLED = true in gevallen waar de inhoud is gecodeerd, krijgt u mogelijk fouten, zoals:If you use APPINSIGHTS_JAVASCRIPT_ENABLED=true in cases where content is encoded, you might get errors like:

  • 500 URL rewrite-fout500 URL rewrite error
  • 500.53 fout bij de module URL herschrijven met bericht uitgaand herschrijven regels kan niet worden toegepast wanneer de inhoud van het HTTP-antwoord gecodeerde ('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').

Dit is vanwege de toepassingsinstelling APPINSIGHTS_JAVASCRIPT_ENABLED wordt ingesteld op true en inhoud-encoding aanwezigheid op hetzelfde moment.This is due to the APPINSIGHTS_JAVASCRIPT_ENABLED application setting being set to true and content-encoding being present at the same time. In dit scenario wordt nog niet ondersteund.This scenario is not supported yet. De tijdelijke oplossing is APPINSIGHTS_JAVASCRIPT_ENABLED verwijderen uit de toepassingsinstellingen.The workaround is to remove APPINSIGHTS_JAVASCRIPT_ENABLED from your application settings. Helaas betekent dit dat als de browser-client-side JavaScript instrumentatie is nog steeds vereist, handmatige SDK-verwijzingen nodig zijn voor uw webpagina's.Unfortunately this means that if client/browser-side JavaScript instrumentation is still required, manual SDK references are needed for your webpages. Volg de instructies voor handmatige instrumentatie met de JavaScript-SDK.Please follow the instructions for manual instrumentation with the JavaScript SDK.

Voor de meest recente informatie over de Application Insights/agentextensie, bekijkt u de opmerkingen bij de release.For the latest information on the Application Insights agent/extension, check out the release notes.

Volgende stappenNext steps