Delen via

Toepassingsbewaking inschakelen in Azure-app Service voor .NET-, Node.js-, Python- en Java-toepassingen

  • Artikel

Automatische instrumentatie, ook wel runtimebewaking genoemd, is de eenvoudigste manier om Application Insights in te schakelen voor Azure-app Service zonder dat hiervoor codewijzigingen of geavanceerde configuraties nodig zijn. Evalueer op basis van uw specifieke scenario of u geavanceerdere bewaking nodig hebt via handmatige instrumentatie.

Notitie

Op 31 maart 2025 eindigt de ondersteuning voor opname van instrumentatiesleutels. Opname van instrumentatiesleutels blijft werken, maar we bieden geen updates of ondersteuning meer voor de functie. Overgang naar verbindingsreeksen om te profiteren van nieuwe mogelijkheden.

Application Insights inschakelen

Belangrijk

Als zowel automatische instrumentatiebewaking als handmatige SDK-instrumentatie worden gedetecteerd, worden alleen de handmatige instrumentatie-instellingen gehonoreerd. Deze rangschikking voorkomt dat dubbele gegevens worden verzonden. Zie Probleemoplossing voor meer informatie.

Notitie

Automatische instrumentatie in Azure Portal

  1. Selecteer Application Insights in het linkernavigatiemenu van uw app-service en selecteer vervolgens Inschakelen.

    Schermopname van het tabblad Application Insights met Inschakelen geselecteerd.

  2. Maak een nieuwe resource of selecteer een bestaande Application Insights-resource voor deze toepassing.

    Notitie

    Wanneer u OK selecteert om een nieuwe resource te maken, wordt u gevraagd bewakingsinstellingen toe te passen. Als u Continue selecteert, wordt uw nieuwe Application Insights-resource gekoppeld aan uw app-service. Uw app-service wordt vervolgens opnieuw opgestart.

    Schermopname van de vervolgkeuzelijst

  3. Nadat u hebt opgegeven welke resource u wilt gebruiken, kunt u kiezen hoe Application Insights gegevens per platform voor uw toepassing moet verzamelen. ASP.NET Opties voor kernverzameling worden aanbevolen of uitgeschakeld.

    Schermopname van het instrumenteren van uw toepassingssectie.

De bewakingsextensie/agent handmatig upgraden

Upgrade uitvoeren van versie 2.8.9 en hoger

Upgraden van versie 2.8.9 gebeurt automatisch, zonder extra acties. De nieuwe bewakingsbits worden in de achtergrond afgeleverd aan de doel-app-service en worden opgehaald wanneer de toepassing opnieuw wordt gestart.

Als u wilt controleren welke versie van de extensie u gebruikt, gaat u naar https://yoursitename.scm.azurewebsites.net/ApplicationInsights.

Schermopname van het URL-pad om de versie van de extensie te controleren die u uitvoert.

Upgrade uitvoeren van versies 1.0.0 - 2.6.5

Vanaf versie 2.8.9 wordt de vooraf geïnstalleerde site-extensie gebruikt. Als u een eerdere versie gebruikt, kunt u op twee manieren bijwerken:

  • Upgrade uitvoeren via Azure Portal: Zelfs als u de Application Insights-extensie voor App Service hebt geïnstalleerd, wordt in de gebruikersinterface alleen de knop Inschakelen weergegeven. Achter de schermen wordt de oude privésite-extensie verwijderd.

  • Voer een upgrade uit via PowerShell:

    1. Stel de toepassingsinstellingen in om de vooraf geïnstalleerde site-extensie ApplicationInsightsAgentin te schakelen. Zie Inschakelen via PowerShell voor meer informatie.
    2. Verwijder handmatig de persoonlijke site-extensie met de naam Application Insights-extensie voor Azure-app Service.

Als de upgrade wordt uitgevoerd vanaf een versie vóór 2.5.1, controleert u of de ApplicationInsights DLL's uit de bin-map van de applicatie zijn verwijderd. Zie Probleemoplossing voor meer informatie .

De bewakingsextensie/agent configureren

We bieden momenteel geen opties voor het configureren van de bewakingsextensie voor ASP.NET Core.

Bewaking aan clientzijde inschakelen

Bewaking aan de clientzijde is standaard ingeschakeld voor ASP.NET Core-apps met aanbevolen verzameling, ongeacht of de app-instelling APPINSIGHTS_JAVASCRIPT_ENABLED aanwezig is.

Als u bewaking aan de clientzijde wilt uitschakelen:

  1. Selecteer Instellingen>Configuratie.

  2. Maak onder Toepassingsinstellingen een nieuwe toepassingsinstelling met de volgende informatie:

    • Naam: APPINSIGHTS_JAVASCRIPT_ENABLED
    • Waarde: false

  3. Sla de instellingen op. Start de app opnieuw.

Bewaking automatiseren

Als u telemetrieverzameling met Application Insights wilt inschakelen, moeten alleen de volgende toepassingsinstellingen worden ingesteld:

Schermopname van App Service-toepassingsinstellingen met Application Insights-instellingen.

Definities van toepassingsinstellingen

Naam van de app-instelling Definitie Waarde
ApplicationInsightsAgent_EXTENSION_VERSION Belangrijkste extensie, waarmee runtime-bewaking wordt gecontroleerd. ~2 voor Windows of ~3 voor Linux
XDT_MicrosoftApplicationInsights_Mode In de standaardmodus zijn alleen essentiële functies ingeschakeld om optimale prestaties te garanderen. disabled of recommended.
XDT_MicrosoftApplicationInsights_PreemptSdk Alleen voor ASP.NET Core-apps. Hiermee schakelt u Interop (interoperation) in met de Application Insights SDK. Laadt de extensie naast de SDK en gebruikt deze om telemetrie te verzenden. (Hiermee schakelt u de Application Insights SDK uit.) 1

App Service-toepassingsinstellingen met Azure Resource Manager

Toepassingsinstellingen voor Azure-app Service kunnen worden beheerd en geconfigureerd met Azure Resource Manager-sjablonen. U kunt deze methode gebruiken wanneer u nieuwe App Service-resources implementeert met Resource Manager-automatisering of de instellingen van bestaande resources wijzigt.

De basisstructuur van de JSON voor toepassingsinstellingen voor een App Service-resource:

      "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"
          }
        }
      ]

Als u een Resource Manager-sjabloon wilt maken met de standaardinstellingen voor Application Insights, begint u het proces alsof u een nieuwe web-app wilt maken waarvoor Application Insights is ingeschakeld.

  1. Maak een nieuwe App Service-resource met de gewenste web-app-informatie. Schakel Application Insights in op het tabblad Bewaking .

  2. Selecteer Controleren + maken. Selecteer vervolgens Een sjabloon voor automatisering downloaden.

    Schermopname van het menu Voor het maken van een App Service-web-app.

    Met deze optie wordt de meest recente Resource Manager-sjabloon gegenereerd met alle vereiste instellingen geconfigureerd.

    Schermopname van een App Service-web-app-sjabloon.

Vervang in het volgende voorbeeld alle exemplaren van AppMonitoredSite met uw sitenaam.

Notitie

Als u Windows gebruikt, stelt u ApplicationInsightsAgent_EXTENSION_VERSION in op ~2. Als u Linux gebruikt, stelt u ApplicationInsightsAgent_EXTENSION_VERSION in op ~3.

{
    "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"
}

Inschakelen via PowerShell

Als u de toepassingscontrole via PowerShell wilt inschakelen, moeten alleen de onderliggende toepassingsinstellingen worden gewijzigd. In het volgende voorbeeld wordt toepassingsbewaking ingeschakeld voor een website die in de resourcegroep AppMonitoredSitewordt aangeroepenAppMonitoredRG. Hiermee worden gegevens geconfigureerd die naar de 012345678-abcd-ef01-2345-6789abcd instrumentatiesleutel moeten worden verzonden.

Notitie

Het wordt aanbevolen de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell installeren om aan de slag te gaan. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.

Notitie

Als u Windows gebruikt, stelt u ApplicationInsightsAgent_EXTENSION_VERSION in op ~2. Als u Linux gebruikt, stelt u ApplicationInsightsAgent_EXTENSION_VERSION in op ~3.

$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

Veelgestelde vragen

In deze sectie vindt u antwoorden op veelgestelde vragen.

Wat wijzigt Application Insights in mijn project?

De details zijn afhankelijk van het type project. De volgende lijst is een voorbeeld voor een webtoepassing.

  • Bestanden toevoegen aan uw project:

    • ApplicationInsights.config
    • ai.js

  • Hiermee worden NuGet-pakketten geïnstalleerd:

    • Application Insights-API: de kern-API
    • Application Insights-API voor webtoepassingen: wordt gebruikt voor het verzenden van telemetrie vanaf de server
    • Application Insights-API voor JavaScript-toepassingen: wordt gebruikt voor het verzenden van telemetrie van de client

  • Bevat assemblies in pakketten:

    • Microsoft.ApplicationInsights
    • Microsoft.ApplicationInsights.Platform

  • Items invoegen in:

    • Web.config
    • packages.config

  • Voegt codefragmenten in de client- en servercode in om ze te initialiseren met de Application Insights-resource-id. In een MVC-app wordt bijvoorbeeld code ingevoegd in de hoofdpaginaWeergaven /Gedeeld/_Layout.cshtml. Alleen voor nieuwe projecten voegt u Application Insights handmatig toe aan een bestaand project.

Wat is het verschil tussen metrische standaardgegevens van Application Insights versus Azure-app Service-metrische gegevens?

Application Insights verzamelt telemetrie voor de aanvragen die de toepassing hebben bereikt. Als de fout optreedt in WebApps/WebServer en de aanvraag de gebruikerstoepassing niet heeft bereikt, heeft Application Insights er geen telemetrie over.

De duur voor serverresponsetime berekend door Application Insights komt niet noodzakelijkerwijs overeen met de door Web Apps waargenomen reactietijd van de server. Dit gedrag komt doordat Application Insights alleen de duur telt wanneer de aanvraag daadwerkelijk de gebruikerstoepassing bereikt. Als de aanvraag is vastgelopen of in de wachtrij is geplaatst in WebServer, wordt de wachttijd opgenomen in de metrische gegevens van Web Apps, maar niet in de metrische gegevens van Application Insights.

Probleemoplossing

Connectiviteit testen tussen uw toepassingshost en de opnameservice

Application Insights SDK's en agents verzenden telemetrie om opgenomen te worden als REST-aanroepen naar onze opname-eindpunten. U kunt de connectiviteit vanaf uw webserver of hostmachine van uw toepassing naar de ingestiedienst-eindpunten testen door gebruik te maken van onbewerkte REST-clients met PowerShell of curl-opdrachten. Zie Problemen met ontbrekende toepassingstelemetrie oplossen in Azure Monitor Application Insights.

Notitie

Wanneer u een web-app maakt met de ASP.NET Core runtimes in App Service, wordt één statische HTML-pagina geïmplementeerd als een starterswebsite. Het wordt afgeraden een probleem met de standaardsjabloon op te lossen. Implementeer een toepassing voordat u een probleem oplost.

Ontbrekende telemetrie

Windows

  1. Controleer of de ApplicationInsightsAgent_EXTENSION_VERSION app-instelling is ingesteld op een waarde van ~2.

  2. Blader naar https://yoursitename.scm.azurewebsites.net/ApplicationInsights.

    Schermopname van de koppeling boven de pagina met resultaten.

    • Controleer of de status van de Application Insights-extensie isPre-Installed Site Extension, version 2.8.x.xxxx, is running.

      Als het niet wordt uitgevoerd, volgt u de instructies in de sectie Application Insights monitoring inschakelen.

    • Controleer of de statusbron bestaat en eruitziet als Status source D:\home\LogFiles\ApplicationInsights\status\status_RD0003FF0317B6_4248_1.json.

      Als er geen vergelijkbare waarde aanwezig is, betekent dit dat de toepassing momenteel niet wordt uitgevoerd of niet wordt ondersteund. Als u ervoor wilt zorgen dat de toepassing wordt uitgevoerd, gaat u handmatig naar de toepassings-URL/toepassingseindpunten, zodat de runtime-informatie beschikbaar kan worden.

    • Controleer dat IKeyExists isTrue. Als het False is, voeg dan APPINSIGHTS_INSTRUMENTATIONKEY en APPLICATIONINSIGHTS_CONNECTION_STRING, met uw ikey-GUID, toe aan uw toepassingsinstellingen.

    • Als uw toepassing verwijst naar Application Insights-pakketten, wordt het inschakelen van de App Service-integratie mogelijk niet van kracht en worden de gegevens mogelijk niet weergegeven in Application Insights. Een voorbeeld hiervan is als u eerder hebt geïnstrueerd of geprobeerd uw app te instrumenteren met de ASP.NET Core SDK. Als u het probleem wilt oplossen, schakelt u Interop met de Application Insights SDK in in de Azure Portal.

      Belangrijk

      Deze functionaliteit is beschikbaar als preview-versie.

      Schermopname waarop de ingeschakelde interoperabiliteitsinstelling wordt getoond.

      De gegevens worden verzonden met behulp van een codeloze benadering, zelfs als de Application Insights SDK oorspronkelijk is gebruikt of geprobeerd te worden gebruikt.

      Belangrijk

      Als de toepassing de Application Insights SDK heeft gebruikt om telemetriegegevens te verzenden, wordt de telemetrie uitgeschakeld. Met andere woorden, aangepaste telemetrie (bijvoorbeeld methoden Track*() ) en aangepaste instellingen (zoals steekproeven) worden uitgeschakeld.

Linux

  1. Controleer of de ApplicationInsightsAgent_EXTENSION_VERSION app-instelling is ingesteld op een waarde van ~3.

  2. Blader naar https://your site name.scm.azurewebsites.net/ApplicationInsights.

  3. Bevestig binnen deze site:

    • De statusbron bestaat en ziet er als Status source /var/log/applicationinsights/status_abcde1234567_89_0.json uit.
    • De waarde Auto-Instrumentation enabled successfully wordt weergegeven. Als een vergelijkbare waarde niet aanwezig is, betekent dit dat de toepassing niet wordt uitgevoerd of niet wordt ondersteund. Als u ervoor wilt zorgen dat de toepassing wordt uitgevoerd, gaat u handmatig naar de toepassings-URL/toepassingseindpunten, zodat de runtime-informatie beschikbaar kan worden.
    • IKeyExists is True. Als het False is, voeg APPINSIGHTS_INSTRUMENTATIONKEY en APPLICATIONINSIGHTS_CONNECTION_STRING met uw ikey-GUID toe aan uw toepassingsinstellingen.

    Schermopname van de webpagina met de status autoinstrumentatie.

Standaardwebsite die is geïmplementeerd met web-apps biedt geen ondersteuning voor automatische bewaking aan de clientzijde

Wanneer u een web-app maakt met de ASP.NET Core-runtimes in App Service, wordt er één statische HTML-pagina geïmplementeerd als een starterswebsite. De statische webpagina laadt ook een ASP.NET-beheerd webonderdeel in IIS. Met dit gedrag kunt u bewaking aan de serverzijde testen zonder code, maar biedt geen ondersteuning voor automatische bewaking aan de clientzijde.

Als u codeloze server- en clientbewaking wilt testen voor ASP.NET Core in een App Service-web-app, raden we u aan de officiële handleidingen te volgen voor het maken van een ASP.NET Core-web-app. Gebruik daarna de instructies in het huidige artikel om bewaking in te schakelen.

PHP en WordPress worden niet ondersteund

PHP- en WordPress-sites worden niet ondersteund. Er is momenteel geen officieel ondersteunde SDK/agent voor bewaking aan de serverzijde van deze workloads. Als u transacties aan de clientzijde op een PHP- of WordPress-site wilt bijhouden, voegt u javaScript aan de clientzijde toe aan uw webpagina's met behulp van de JavaScript SDK.

De volgende tabel bevat een uitleg van wat deze waarden betekenen, wat hun onderliggende oorzaken en aanbevolen oplossingen zijn.

Probleemwaarde Uitleg Reparatie
AppAlreadyInstrumented:true Deze waarde geeft aan dat de extensie een bepaald aspect van de SDK heeft gedetecteerd dat al aanwezig is in de toepassing en wordt teruggezet. Een verwijzing naar Microsoft.ApplicationInsights.AspNetCore of Microsoft.ApplicationInsights kan deze waarde veroorzaken. Verwijder de verwijzingen. Sommige van deze verwijzingen worden standaard toegevoegd vanuit bepaalde Visual Studio-sjablonen. Oudere versies van Visual Studio verwijzen naar Microsoft.ApplicationInsights.
AppAlreadyInstrumented:true De aanwezigheid van Microsoft.ApplicationsInsights DLL in de app-map van een vorige implementatie kan deze waarde ook veroorzaken. Schoon de app-map op om ervoor te zorgen dat deze DLL's worden verwijderd. Controleer zowel de bin-map van uw lokale app als de wwwroot-map in de App Service. (Als u de wwwroot-map van uw App Service-web-app wilt controleren, selecteert u Geavanceerde hulpprogramma's (Kudu) >>home\site\wwwroot).
IKeyExists:false Deze waarde geeft aan dat de instrumentatiesleutel niet aanwezig is in de app-instelling APPINSIGHTS_INSTRUMENTATIONKEY. Mogelijke oorzaken zijn het per ongeluk verwijderen van de waarden of het vergeten om de waarden in het automatiseringsscript in te stellen. Zorg ervoor dat de instelling aanwezig is in de App Service-toepassingsinstellingen.