Freigeben über

Aktivieren der Anwendungsüberwachung in Azure App Service für .NET-, Node.js-, Python- und Java-Anwendungen

Die automatische Instrumentierung, auch als Laufzeitüberwachung bezeichnet, ist die einfachste Möglichkeit, Application Insights für Azure App Service zu aktivieren, ohne Dass Codeänderungen oder erweiterte Konfigurationen erforderlich sind. Anhand Ihres spezifischen Szenarios bewerten Sie, ob Sie eine erweiterte Überwachung über manuelle Instrumentierung erfordern.

Hinweis

Am 31. März 2025 wird der Support für die auf Instrumentierungsschlüsseln basierende Erfassung eingestellt. Die Erfassung von Instrumentierungsschlüsseln funktioniert zwar weiterhin, wir stellen jedoch keine Updates und keinen Support mehr für das Feature bereit. Übergang zu Verbindungszeichenfolgen , um neue Funktionen nutzen zu können.

Aktivieren von Application Insights

Wichtig

Wenn sowohl die Überwachung mit automatischer Instrumentierung als auch die manuelle SDK-basierte Instrumentierung erkannt wird, werden nur die Einstellungen der manuellen Instrumentierung berücksichtigt. Durch diese Anordnung wird verhindert, dass doppelte Daten gesendet werden. Weitere Informationen finden Sie unter "Problembehandlung".

Hinweis

Automatische Instrumentierung im Azure-Portal

  1. Wählen Sie "Application Insights" im linken Navigationsmenü Ihres App-Diensts und dann "Aktivieren" aus.

    Screenshot der Registerkarte

  2. Erstellen Sie eine neue Ressource, oder wählen Sie eine vorhandene Application Insights-Ressource für diese Anwendung aus.

    Hinweis

    Wenn Sie "OK" auswählen, um eine neue Ressource zu erstellen, werden Sie aufgefordert, Überwachungseinstellungen anzuwenden. Wenn Sie "Weiter" auswählen, wird Ihre neue Application Insights-Ressource mit Ihrem App-Dienst verknüpft. Ihre App Service-Instanz wird dann neu gestartet.

    Screenshot: Dropdownliste „Ressource ändern“

  3. Nach Angabe der zu verwendenden Ressource können Sie plattformspezifisch auswählen, wie Application Insights Daten für Ihre Anwendung erfassen soll. ASP.NET Core-Sammlungsoptionen werden empfohlen oder deaktiviert.

    Screenshot, der die Instrumentierung Ihres Anwendungsabschnitts zeigt.

Manuelles Upgrade der Überwachungserweiterung/ des Agenten

Upgrade von Versionen 2.8.9 und höher

Das Upgrade von Version 2.8.9 erfolgt automatisch ohne zusätzliche Aktionen. Die neuen Überwachungsbits werden im Hintergrund an den Dienst der Zielanwendung übermittelt und beim Neustart der Anwendung abgeholt.

Informationen zur aktuell verwendeten Version der Erweiterung finden Sie unter https://yoursitename.scm.azurewebsites.net/ApplicationInsights.

Screenshot des URL-Pfads zum Überprüfen der Version der Erweiterung, die Sie ausführen.

Upgrade von Version 1.0.0 – 2.6.5

Ab Version 2.8.9 wird die vorinstallierte Websiteerweiterung verwendet. Bei einer früheren Version können Sie eine Aktualisierung auf zwei Arten vornehmen:

  • Upgrade durch Aktivieren über das Azure-Portal: Auch wenn Sie die Application Insights-Erweiterung für App Service installiert haben, wird auf der Benutzeroberfläche nur die Schaltfläche " Aktivieren " angezeigt. Im Hintergrund wird die alte private Websiteerweiterung entfernt.

  • Upgrade über PowerShell:

    1. Legen Sie die Anwendungseinstellungen so fest, dass die vorinstallierte Websiteerweiterung ApplicationInsightsAgent aktiviert wird. Weitere Informationen finden Sie unter "Aktivieren über PowerShell".
    2. Entfernen Sie manuell die private Websiteerweiterung namens Application Insights-Erweiterung für Azure App Service.

Wenn das Upgrade von einer Version vor 2.5.1 erfolgt, vergewissern Sie sich, dass die ApplicationInsights-DLL-Dateien aus dem Ordner „bin“ der Anwendung entfernt werden. Weitere Informationen finden Sie unter "Problembehandlung".

Konfigurieren der Überwachungserweiterung/ des Agenten

Wir bieten derzeit keine Optionen zum Konfigurieren der Überwachungserweiterung für ASP.NET Core.

Aktivieren der clientseitigen Überwachung

Clientseitige Überwachung ist standardmäßig für ASP.NET Core-Apps mit empfohlener Sammlung aktiviert, unabhängig davon, ob die App-Einstellung APPINSIGHTS_JAVASCRIPT_ENABLED vorhanden ist.

Zum Deaktivieren der clientseitigen Überwachung gehen Sie folgendermaßen vor:

  1. Wählen Sie "> aus.

  2. Erstellen Sie unter "Anwendungseinstellungen" eine Neue Anwendungseinstellung mit den folgenden Informationen:

    • Name: APPINSIGHTS_JAVASCRIPT_ENABLED
    • Wert: false

  3. Speichern Sie die Einstellungen. Starten Sie die App neu.

Automatisieren der Überwachung

Um die Sammlung von Telemetriedaten mit Application Insights zu aktivieren, müssen nur die folgenden Anwendungseinstellungen festgelegt werden:

Screenshot der App Service-Anwendungseinstellungen mit Application Insights-Einstellungen.

Definitionen von Anwendungseinstellungen

Name der App-Einstellung Definition Wert
ApplicationInsightsAgent_EXTENSION_VERSION Die Haupterweiterung, die die Laufzeitüberwachung steuert. ~2 für Windows oder ~3 für Linux
XDT_MicrosoftApplicationInsights_Mode Im Standardmodus werden nur wichtige Funktionen aktiviert, um eine optimale Leistung zu gewährleisten. disabled oder recommended.
XDT_MicrosoftApplicationInsights_PreemptSdk Diese Einstellung ist nur für ASP.NET Core-Apps geeignet. Sie aktiviert die Interoperabilität mit dem Application Insights SDK. Sie lädt die Erweiterung parallel zum SDK und verwendet sie zum Senden von Telemetriedaten. (Deaktiviert das Application Insights SDK.) 1

App Service-Anwendungseinstellungen mit Azure Resource Manager

Anwendungseinstellungen für Azure App Service können mit Azure Resource Manager-Vorlagen verwaltet und konfiguriert werden. Sie können diese Methode wählen, wenn Sie neue App Service-Ressourcen mit Resource Manager-Automatisierung bereitstellen oder die Einstellungen vorhandener Ressourcen ändern.

Die grundlegende Struktur der JSON-Anwendungseinstellungen für eine App Service-Ressource sieht folgendermaßen aus:

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

Um eine Resource Manager-Vorlage mit den Standardeinstellungen für Application Insights zu erstellen, beginnen Sie den Prozess so, als ob Sie eine neue Web-App mit aktivierten Application Insights erstellen würden.

  1. Erstellen Sie im Azure-Portal eine neue Web App-Ressource mit ihren gewünschten Informationen. Aktivieren Sie Application Insights auf der Registerkarte "Monitor + sicher ".

  2. Wechseln Sie zu "Überprüfen+ erstellen", und wählen Sie dann "Vorlage für Automatisierung herunterladen" aus. Mit dieser Option wird die aktuellste Resource Manager-Vorlage mit allen erforderlichen Einstellungen generiert.

    Screenshot des App Service Web App-Erstellungsmenüs.

Hinweis

Die folgende Beispielvorlage ist für eine .NET 8 (LTS)-Anwendung unter Windows vorgesehen. Er verwendet die Platzhalter my-monitored-web-app für den Namen der Anwendung und aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e für die Abonnement-ID.

Es wird nicht empfohlen, es direkt zu kopieren und zu verwenden. Generieren Sie stattdessen ihre eigene Vorlage basierend auf den obigen Anweisungen.


Erweitern zum Anzeigen einer Beispielvorlage 
{
    "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "subscriptionId": {
            "type": "string"
        },
        "resourceGroupName": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "location": {
            "type": "string"
        },
        "hostingPlanName": {
            "type": "string"
        },
        "serverFarmResourceGroup": {
            "type": "string"
        },
        "alwaysOn": {
            "type": "bool"
        },
        "ftpsState": {
            "type": "string"
        },
        "autoGeneratedDomainNameLabelScope": {
            "type": "string"
        },
        "sku": {
            "type": "string"
        },
        "skuCode": {
            "type": "string"
        },
        "workerSize": {
            "type": "string"
        },
        "workerSizeId": {
            "type": "string"
        },
        "numberOfWorkers": {
            "type": "string"
        },
        "currentStack": {
            "type": "string"
        },
        "phpVersion": {
            "type": "string"
        },
        "netFrameworkVersion": {
            "type": "string"
        }
    },
    "variables": {},
    "resources": [
        {
            "apiVersion": "2022-03-01",
            "name": "[parameters('name')]",
            "type": "Microsoft.Web/sites",
            "location": "[parameters('location')]",
            "tags": null,
            "dependsOn": [
                "microsoft.insights/components/my-monitored-web-app",
                "[concat('Microsoft.Web/serverfarms/', parameters('hostingPlanName'))]"
            ],
            "properties": {
                "name": "[parameters('name')]",
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference('microsoft.insights/components/my-monitored-web-app', '2015-05-01').ConnectionString]"
                        },
                        {
                            "name": "ApplicationInsightsAgent_EXTENSION_VERSION",
                            "value": "~2"
                        },
                        {
                            "name": "XDT_MicrosoftApplicationInsights_Mode",
                            "value": "default"
                        }
                    ],
                    "metadata": [
                        {
                            "name": "CURRENT_STACK",
                            "value": "[parameters('currentStack')]"
                        }
                    ],
                    "phpVersion": "[parameters('phpVersion')]",
                    "netFrameworkVersion": "[parameters('netFrameworkVersion')]",
                    "alwaysOn": "[parameters('alwaysOn')]",
                    "ftpsState": "[parameters('ftpsState')]"
                },
                "serverFarmId": "[concat('/subscriptions/', parameters('subscriptionId'),'/resourcegroups/', parameters('serverFarmResourceGroup'), '/providers/Microsoft.Web/serverfarms/', parameters('hostingPlanName'))]",
                "clientAffinityEnabled": true,
                "virtualNetworkSubnetId": null,
                "httpsOnly": true,
                "publicNetworkAccess": "Enabled",
                "autoGeneratedDomainNameLabelScope": "[parameters('autoGeneratedDomainNameLabelScope')]"
            },
            "resources": [
                {
                    "type": "Microsoft.Web/sites/basicPublishingCredentialsPolicies",
                    "apiVersion": "2022-09-01",
                    "name": "[concat(parameters('name'), '/scm')]",
                    "properties": {
                        "allow": true
                    },
                    "dependsOn": [
                        "[resourceId('Microsoft.Web/Sites', parameters('name'))]"
                    ]
                },
                {
                    "type": "Microsoft.Web/sites/basicPublishingCredentialsPolicies",
                    "apiVersion": "2022-09-01",
                    "name": "[concat(parameters('name'), '/ftp')]",
                    "properties": {
                        "allow": true
                    },
                    "dependsOn": [
                        "[resourceId('Microsoft.Web/Sites', parameters('name'))]"
                    ]
                }
            ]
        },
        {
            "apiVersion": "2018-11-01",
            "name": "[parameters('hostingPlanName')]",
            "type": "Microsoft.Web/serverfarms",
            "location": "[parameters('location')]",
            "kind": "",
            "tags": null,
            "dependsOn": [],
            "properties": {
                "name": "[parameters('hostingPlanName')]",
                "workerSize": "[parameters('workerSize')]",
                "workerSizeId": "[parameters('workerSizeId')]",
                "numberOfWorkers": "[parameters('numberOfWorkers')]",
                "zoneRedundant": false
            },
            "sku": {
                "Tier": "[parameters('sku')]",
                "Name": "[parameters('skuCode')]"
            }
        },
        {
            "apiVersion": "2020-02-02-preview",
            "name": "my-monitored-web-app",
            "type": "microsoft.insights/components",
            "location": "centralus",
            "tags": null,
            "dependsOn": [
                "newWorkspaceTemplate"
            ],
            "properties": {
                "ApplicationId": "[parameters('name')]",
                "Request_Source": "IbizaWebAppExtensionCreate",
                "Flow_Type": "Redfield",
                "Application_Type": "web",
                "WorkspaceResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/DefaultResourceGroup-CUS/providers/Microsoft.OperationalInsights/workspaces/DefaultWorkspace-aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e-CUS"
            }
        },
        {
            "type": "Microsoft.Resources/deployments",
            "apiVersion": "2021-04-01",
            "name": "newWorkspaceTemplate",
            "resourceGroup": "DefaultResourceGroup-CUS",
            "subscriptionId": "[parameters('subscriptionId')]",
            "properties": {
                "mode": "Incremental",
                "template": {
                    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
                    "contentVersion": "1.0.0.0",
                    "parameters": {},
                    "variables": {},
                    "resources": [
                        {
                            "apiVersion": "2020-08-01",
                            "name": "DefaultWorkspace-aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e-CUS",
                            "type": "Microsoft.OperationalInsights/workspaces",
                            "location": "centralus",
                            "properties": {}
                        }
                    ]
                }
            }
        }
    ]
}

Aktivieren über PowerShell

Zum Aktivieren der Anwendungsüberwachung über PowerShell müssen nur die zugrunde liegenden Anwendungseinstellungen geändert werden. Das folgende Beispiel ermöglicht die Anwendungsüberwachung für eine Website namens my-monitored-web-app in der Ressourcengruppe my-resource-group. Es konfiguriert Daten, die an die InstrumentationKey=012345678-abcd-ef01-2345-6789abcd Verbindungszeichenfolge gesendet werden.

Hinweis

Es wird empfohlen, das Azure Az PowerShell-Modul für die Interaktion mit Azure zu verwenden. Informationen zu den ersten Schritten finden Sie unter Installieren von Azure PowerShell. Informationen zum Migrieren zum Az PowerShell-Modul finden Sie unter Migrieren von Azure PowerShell von AzureRM zu Az.

Hinweis

Für Windows setzen Sie ApplicationInsightsAgent_EXTENSION_VERSION auf ~2.

Legen Sie für Linux ApplicationInsightsAgent_EXTENSION_VERSION auf ~3 fest.

$app = Get-AzWebApp -ResourceGroupName "my-resource-group" -Name "my-monitored-web-app" -ErrorAction Stop
$newAppSettings = @{} # Case-insensitive hash map
$app.SiteConfig.AppSettings | %{$newAppSettings[$_.Name] = $_.Value} # Preserve non-Application-Insights application settings.
$newAppSettings["APPLICATIONINSIGHTS_CONNECTION_STRING"] = "InstrumentationKey=aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"; # Set the Application Insights connection string
$newAppSettings["ApplicationInsightsAgent_EXTENSION_VERSION"] = "~3"; # Enable the ApplicationInsightsAgent.
$app = Set-AzWebApp -AppSettings $newAppSettings -ResourceGroupName $app.ResourceGroup -Name $app.Name -ErrorAction Stop

Häufig gestellte Fragen

Dieser Abschnitt enthält Antworten auf häufig gestellte Fragen.

Welche Änderungen nimmt Application Insights in meinem Projekt vor?

Die Details hängen von der Art des Projekts ab. Die folgende Liste ist ein Beispiel für eine Webanwendung.

  • Fügt Ihrem Projekt Dateien hinzu:

    • ApplicationInsights.config
    • ai.js

  • Installiert NuGet-Pakete:

    • Application Insights-API: Die Kern-API
    • Application Insights-API für Webanwendungen: Zum Senden von Telemetriedaten vom Server
    • Application Insights-API für JavaScript-Anwendungen: Zum Senden von Telemetriedaten vom Client

  • Enthält Assemblierungen in Paketen:

    • Microsoft.ApplicationInsights
    • Microsoft.ApplicationInsights.Platform

  • Fügt Elemente in:

    • Web.config
    • packages.config

  • Fügen Sie Codeausschnitte in den Client- und Servercode ein, um diese mit der Application Insights-Ressourcen-ID zu initialisieren. In einer MVC-App wird beispielsweise Code in die Hauptseite Views/Shared/_Layout.cshtml eingefügt. Nur für neue Projekte fügen Sie Application Insights einem vorhandenen Projekt manuell hinzu.

Was ist der Unterschied zwischen Standardmetriken von Application Insights und Azure App Service-Metriken?

Application Insights sammelt Telemetriedaten für die Anforderungen, die bis zur Anwendung gelangt sind. Wenn der Fehler in WebApps/WebServer auftritt und die Anforderung die Benutzeranwendung nicht erreicht hat, hat Application Insights keine Telemetriedaten dazu.

Die von Application Insights berechnete Dauer für serverresponsetime stimmt nicht unbedingt mit der von Web-Apps beobachteten Serverantwortzeit überein. Dies liegt daran, dass Application Insights nur die Dauer zählt, bis die Anforderung tatsächlich die Benutzeranwendung erreicht. Wenn die Anforderung in WebServer hängen bleibt oder in die Warteschlange gestellt wird, ist diese Wartezeit in den Web-App-Metriken enthalten, in den Application Insights-Metriken jedoch nicht.

Problembehandlung

Testen der Konnektivität zwischen Ihrem Anwendungshost und dem Erfassungsdienst

Application Insights SDKs und -Agents senden Telemetriedaten, die als REST-Aufrufe unserer Erfassungsendpunkte erfasst werden sollen. Sie können die Konnektivität Ihres Webservers oder Anwendungshostcomputers mit den Endpunkten des Erfassungsdiensts testen, indem Sie unformatierte REST-Clients über PowerShell- oder cURL-Befehle verwenden. Siehe Problembehandlung bei fehlender Anwendungstelemetrie in Azure Monitor Application Insights.

Hinweis

Wenn Sie eine Web-App mit den ASP.NET Core-Runtimes in App Service erstellen, wird eine einzelne statische HTML-Seite als Startwebsite bereitgestellt. Es wird nicht empfohlen, ein Problem mit der Standardvorlage zu beheben. Stellen Sie vor der Problembehandlung eine Anwendung bereit.

Fehlende Telemetrie

Fenster

  1. Überprüfen Sie, ob die App-Einstellung ApplicationInsightsAgent_EXTENSION_VERSION auf den Wert ~2 festgelegt ist.

  2. Navigieren Sie zu https://yoursitename.scm.azurewebsites.net/ApplicationInsights.

    Screenshot, der den Link über der Ergebnisseite zeigt.

    • Vergewissern Sie sich, dass der Erweiterungsstatus von Application Insights lautet Pre-Installed Site Extension, version 2.8.x.xxxx, is running.

      Wenn die Anwendung nicht ausgeführt wird, folgen Sie den Anweisungen im Abschnitt Application Insights-Überwachung aktivieren.

    • Stellen Sie sicher, dass die Statusquelle vorhanden ist und folgendermaßen aussieht: Status source D:\home\LogFiles\ApplicationInsights\status\status_RD0003FF0317B6_4248_1.json.

      Wenn ein ähnlicher Wert nicht vorhanden ist, bedeutet dies, dass die Anwendung derzeit nicht ausgeführt oder nicht unterstützt wird. Um sicherzustellen, dass die Anwendung ausgeführt wird, rufen Sie die Anwendungs-URL/Anwendungsendpunkte manuell auf, wodurch die Laufzeitinformationen verfügbar werden.

    • Vergewissern Sie sich, dass IKeyExists ist True. Wenn der Wert False lautet, fügen Sie den Anwendungseinstellungen APPINSIGHTS_INSTRUMENTATIONKEY und APPLICATIONINSIGHTS_CONNECTION_STRING mit Ihrer ikey-GUID hinzu.

    • Falls Ihre Anwendung auf ein Application Insights-Paket verweist, kann es sein, dass die Aktivierung der App Service-Integration nicht wirksam ist und die Daten nicht in Application Insights verfügbar sind. Ein Beispiel wäre, wenn Sie Ihre App zuvor mit dem ASP.NET Core SDK instrumentiert oder versucht haben zu instrumentieren. Um das Problem zu beheben, aktivieren Sie im Azure-Portal die Interoperabilität mit dem Application Insights SDK.

      Wichtig

      Diese Funktion befindet sich in der Vorschauphase.

      Screenshot der aktivierten Interoperabilitätseinstellung.

      Die Daten werden mithilfe eines codelosen Ansatzes gesendet, auch wenn das Application Insights SDK ursprünglich verwendet wurde (oder versucht wurde, es zu verwenden).

      Wichtig

      Wenn die Anwendung das Application Insights SDK zum Senden von Telemetriedaten verwendet hat, werden die Telemetriedaten deaktiviert. Anders ausgedrückt: Benutzerdefinierte Telemetriedaten (z. B. Track*()-Methoden) und benutzerdefinierte Einstellungen (z. B. Stichprobenentnahme) werden deaktiviert.

Linux

  1. Überprüfen Sie, ob die App-Einstellung ApplicationInsightsAgent_EXTENSION_VERSION auf den Wert ~3 festgelegt ist.

  2. Navigieren Sie zu https://your site name.scm.azurewebsites.net/ApplicationInsights.

  3. Bestätigen Sie auf dieser Website Folgendes:

    • Die Statusquelle ist vorhanden und sieht folgendermaßen aus: Status source /var/log/applicationinsights/status_abcde1234567_89_0.json.
    • Der Wert Auto-Instrumentation enabled successfully wird angezeigt. Wenn kein ähnlicher Wert vorhanden ist, bedeutet dies, dass die Anwendung nicht ausgeführt oder nicht unterstützt wird. Um sicherzustellen, dass die Anwendung ausgeführt wird, rufen Sie die Anwendungs-URL/Anwendungsendpunkte manuell auf, wodurch die Laufzeitinformationen verfügbar werden.
    • IKeyExists ist True. Wenn der Wert False lautet, fügen Sie den Anwendungseinstellungen APPINSIGHTS_INSTRUMENTATIONKEY und APPLICATIONINSIGHTS_CONNECTION_STRING mit Ihrer ikey-GUID hinzu.

    Screenshot: Webseite mit dem Status der automatischen Instrumentierung

Die mit Web-Apps bereitgestellte Standardwebsite unterstützt keine automatische clientseitige Überwachung

Wenn Sie eine Web-App mit den ASP.NET Core-Runtimes in App Service erstellen, wird eine einzelne statische HTML-Seite als Startwebsite bereitgestellt. Die statische Webseite lädt auch ein ASP.NET-verwaltetes Webpart in IIS. Dieses Verhalten ermöglicht das Testen der serverseitigen Überwachung ohne Code, unterstützt jedoch nicht die automatische clientseitige Überwachung.

Wenn Sie codelose Server- und clientseitige Überwachung für ASP.NET Core in einer App Service Web App testen möchten, empfehlen wir, die offiziellen Leitfäden zum Erstellen einer ASP.NET Core Web App zu befolgen. Verwenden Sie dann die Anweisungen im aktuellen Artikel, um die Überwachung zu aktivieren.

PHP und WordPress werden nicht unterstützt.

PHP- und WordPress-Sites werden nicht unterstützt. Zurzeit ist kein offiziell unterstützter SDK/Agent für die serverseitige Überwachung dieser Workloads verfügbar. Um clientseitige Transaktionen auf einer PHP- oder WordPress-Website nachzuverfolgen, fügen Sie clientseitiges JavaScript zu Ihren Webseiten mit dem JavaScript SDK hinzu.

Die folgende Tabelle enthält Erläuterungen der Bedeutung dieser Werte, der zugrunde liegenden Ursachen und der empfohlenen Problembehebungen.

Problemwert Erklärung Reparatur
AppAlreadyInstrumented:true Dieser Wert zeigt an, dass die Erweiterung erkannt hat, dass ein Teil des SDK bereits in der Anwendung vorhanden ist, und der Vorgang wird abgebrochen. Ein Verweis auf Microsoft.ApplicationInsights.AspNetCore oder auf Microsoft.ApplicationInsights kann diesen Wert verursachen. Entfernen Sie die Verweise. Einige dieser Verweise werden standardmäßig aus bestimmten Visual Studio-Vorlagen hinzugefügt. Ältere Visual Studio-Versionen verweisen auf Microsoft.ApplicationInsights.
AppAlreadyInstrumented:true Dieser Wert kann auch durch das Vorhandensein der Microsoft.ApplicationsInsights-DLL im App-Ordner aus einer früheren Bereitstellung verursacht werden. Bereinigen Sie den App-Ordner, um sicherzustellen, dass diese DLLs entfernt werden. Überprüfen Sie sowohl das Bin-Verzeichnis Ihrer lokalen App als auch das Wwwroot-Verzeichnis im App-Dienst. (Um das wwwroot-Verzeichnis Ihrer App Service-Web-App zu überprüfen, wählen Sie "Erweiterte Tools" (Kudu) aus. >Debugkonsole>CMD>home\site\wwwroot).
IKeyExists:false Dieser Wert gibt an, dass der Instrumentierungsschlüssel nicht in der App-Einstellung APPINSIGHTS_INSTRUMENTATIONKEY vorhanden ist. Mögliche Ursachen sind das versehentliche Entfernen der Werte, oder es wurde vergessen, die Werte im Automatisierungsskript festzulegen. Stellen Sie sicher, dass die Einstellung in den App Service-Anwendungseinstellungen vorhanden ist.