Arbeitsbereichsbasierte Application Insights-Ressourcen

Arbeitsbereichsbasierte Azure MonitorApplication Insights-Ressourcen integrieren Application Insights und Log Analytics.

Mit arbeitsbereichsbasierten Ressourcen sendet Application Insights Telemetriedaten an einen gemeinsamen Log Analytics-Arbeitsbereich, der Vollzugriff auf alle Features von Log Analytics bietet und gleichzeitig Anwendungs-, Infrastruktur- und Plattformprotokolle in einem einzigen konsolidierten Speicherort speichert. Diese Integration ermöglicht auch eine gemeinsame rollenbasierte Zugriffssteuerung in Azure für Ihre gesamten Ressourcen, und die Notwendigkeit anwendungs- bzw. arbeitsbereichsübergreifender Abfragen entfällt.

Hinweis

Die Abrechnung der Datenerfassung und -aufbewahrung für arbeitsbereichsbasierte Application Insights-Ressourcen erfolgt über den Log Analytics-Arbeitsbereich, in dem sich die Daten befinden. Weitere Informationen zur Abrechnung für arbeitsbereichsbasierte Application Insights-Ressourcen finden Sie unter Azure Monitor-Protokolle: Preisdetails.

Neue Funktionen

Mithilfe von arbeitsbereichsbasiertem Application Insights können Sie die neuesten Funktionen von Azure Monitor und Log Analytics nutzen. Zum Beispiel:

Erstellen einer arbeitsbereichsbasierten Ressource

Melden Sie sich beim Azure-Portal an, und erstellen Sie eine Application Insights-Ressource.

Screenshot einer arbeitsbereichsbasierten Application Insights-Ressource.

Wenn Sie noch nicht über einen Log Analytics-Arbeitsbereich verfügen, sehen Sie sich die Dokumentation zum Erstellen von Log Analytics-Arbeitsbereichen an.

*Arbeitsbereichsbasierte Ressourcen sind zurzeit in allen kommerziellen Regionen und für Azure Government verfügbar. Wenn sich Application Insights und Log Analytics in zwei verschiedenen Regionen befinden, kann sich dies auf die Wartezeit auswirken und die Zuverlässigkeit der Überwachungslösung insgesamt verringern. *

Nachdem Sie Ihre Ressource erstellt haben, werden entsprechende Arbeitsbereichsinformationen im Bereich Übersicht angezeigt.

Screenshot eines Arbeitsbereichsnamens.

Wählen Sie den blauen Linktext aus, um zum zugeordneten Log Analytics-Arbeitsbereich zu gelangen, wo Sie die neue einheitliche Umgebung für Arbeitsbereichsabfragen nutzen können.

Hinweis

Wir bieten weiterhin vollständige Abwärtskompatibilität für Ihre klassischen Application Insights-Ressourcenabfragen, Arbeitsmappen und protokollbasierten Warnungen. Um die neue arbeitsbereichsbasierte Tabellenstruktur und das neue Tabellenschema anzuzeigen und abzufragen, müssen Sie zuerst zu Ihrem Log Analytics-Arbeitsbereich wechseln. Wählen Sie Protokolle (Analytics) in den Application Insights-Bereichen aus, um Zugriff auf die klassische Application Insights-Abfrageerfahrung zu erhalten.

Verbindungszeichenfolge kopieren

Die Verbindungszeichenfolge identifiziert die Ressource, der Sie Ihre Telemetriedaten zuordnen möchten. Sie können damit auch die Endpunkte ändern, die Ihre Ressource als Ziel für die Telemetrie verwendet. Sie müssen die Verbindungszeichenfolge kopieren und dem Code Ihrer Anwendung oder einer Umgebungsvariable hinzufügen.

Konfigurieren der Überwachung

Nachdem Sie eine arbeitsbereichsbasierte Application Insights-Ressource erstellt haben, konfigurieren Sie die Überwachung.

Codebasierte Anwendungsüberwachung

Für die codebasierte Anwendungsüberwachung installieren Sie das geeignete Application Insights SDK und verweisen die Verbindungszeichenfolge auf Ihre neu erstellte Ressource.

Informationen zum Einrichten eines Application Insights SDK für codebasierte Überwachung finden Sie in der folgenden für die Sprache oder das Framework spezifischen Dokumentation:

Codelose Überwachung und Erstellung von Visual Studio-Ressourcen

Für die codelose Überwachung von Diensten wie Azure Functions und Azure App Services erstellen Sie zuerst Ihre arbeitsbereichsbasierte Application Insights-Ressource. Anschließend verweisen Sie bei der Konfiguration der Überwachung auf diese Ressource.

Diese Dienste bieten die Möglichkeit, eine neue Application Insights-Ressource innerhalb ihres eigenen Ressourcenerstellungsprozesses zu erstellen. Aber über diese Benutzeroberflächenoptionen erstellte Ressourcen sind derzeit auf die klassische Application Insights-Erfahrung beschränkt.

Dieselbe Einschränkung gilt für die Erstellungserfahrung für Application Insights-Ressourcen in Visual Studio für ASP.NET und ASP.NET Core. Sie müssen eine vorhandene arbeitsbereichsbasierte Ressource auf der Visual Studio-Benutzeroberfläche auswählen, wo Sie die Überwachung aktivieren. Die Auswahl von Neue Ressource erstellen in Visual Studio schränkt Sie auf das Erstellen einer klassischen Application Insights-Ressource ein.

Automatisches Erstellen einer Ressource

Azure CLI

Für den Zugriff auf die Azure CLI-Befehle (Vorschauversion) von Application Insights müssen Sie zuerst Folgendes ausführen:

 az extension add -n application-insights

Wenn Sie den Befehl az extension add nicht ausführen, wird eine Fehlermeldung mit dem folgenden Text angezeigt: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Jetzt können Sie folgenden Code ausführen, um Ihre Application Insights-Ressource zu erstellen:

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--ingestion-access {Disabled, Enabled}]
                                         [--kind]
                                         [--only-show-errors]
                                         [--query-access {Disabled, Enabled}]
                                         [--tags]
                                         [--workspace]

Beispiel

az monitor app-insights component create --app demoApp --location eastus --kind web -g my_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"

Vollständige Informationen zu diesem Befehl finden Sie in der Azure CLI-Dokumentation.

Azure PowerShell

Erstellen Sie eine neue arbeitsbereichsbasierte Application Insights-Ressource.

New-AzApplicationInsights -Name <String> -ResourceGroupName <String> -Location <String> -WorkspaceResourceId <String>
   [-SubscriptionId <String>]
   [-ApplicationType <ApplicationType>]
   [-DisableIPMasking]
   [-DisableLocalAuth]
   [-Etag <String>]
   [-FlowType <FlowType>]
   [-ForceCustomerStorageForProfiler]
   [-HockeyAppId <String>]
   [-ImmediatePurgeDataOn30Day]
   [-IngestionMode <IngestionMode>]
   [-Kind <String>]
   [-PublicNetworkAccessForIngestion <PublicNetworkAccessType>]
   [-PublicNetworkAccessForQuery <PublicNetworkAccessType>]
   [-RequestSource <RequestSource>]
   [-RetentionInDays <Int32>]
   [-SamplingPercentage <Double>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Beispiel

New-AzApplicationInsights -Kind java -ResourceGroupName testgroup -Name test1027 -location eastus -WorkspaceResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"

Die vollständige PowerShell-Dokumentation für dieses Cmdlet und Informationen zum Abrufen der Verbindungszeichenfolge finden Sie in der Azure PowerShell-Dokumentation.

Azure-Ressourcen-Manager-Vorlagen

Um eine arbeitsbereichsbasierte Ressource zu erstellen, verwenden Sie die folgenden Azure Resource Manager-Vorlagen, und stellen Sie sie mit PowerShell bereit.

Vorlagendatei

{
    "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "name": {
            "type": "string"
        },
        "type": {
            "type": "string"
        },
        "regionId": {
            "type": "string"
        },
        "tagsArray": {
            "type": "object"
        },
        "requestSource": {
            "type": "string"
        },
        "workspaceResourceId": {
            "type": "string"
        }
    },
    "resources": [
        {
            "name": "[parameters('name')]",
            "type": "microsoft.insights/components",
            "location": "[parameters('regionId')]",
            "tags": "[parameters('tagsArray')]",
            "apiVersion": "2020-02-02-preview",
            "properties": {
                "ApplicationId": "[parameters('name')]",
                "Application_Type": "[parameters('type')]",
                "Flow_Type": "Bluefield",
                "Request_Source": "[parameters('requestSource')]",
                "WorkspaceResourceId": "[parameters('workspaceResourceId')]"
            }
        }
    ]
}

Hinweis

Weitere Informationen zu Ressourceneigenschaften finden Sie unter Eigenschaftswerte. Flow_Type und Request_Source werden nicht verwendet, sind aber in diesem Beispiel der Vollständigkeit halber enthalten.

Parameterdatei

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "type": {
            "value": "web"
        },
        "name": {
            "value": "customresourcename"
        },
        "regionId": {
            "value": "eastus"
        },
        "tagsArray": {
            "value": {}
        },
        "requestSource": {
            "value": "Custom"
        },
        "workspaceResourceId": {
            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
        }
    }
}

Ändern des zugeordneten Arbeitsbereichs

Nachdem Sie eine arbeitsbereichsbasierte Application Insights-Ressource erstellt haben, können Sie den zugeordneten Log Analytics-Arbeitsbereich ändern.

Wählen Sie im Bereich der Application Insights-Ressource Eigenschaften>Arbeitsbereich ändern>Log Analytics-Arbeitsbereiche aus.

Exportieren von Telemetriedaten

Die Legacyfunktion für den fortlaufenden Export wird für arbeitsbereichsbasierte Ressourcen nicht unterstützt. Wählen Sie stattdessen in Ihre Application Insights-Ressource Diagnoseeinstellungen>Diagnoseeinstellung hinzufügen aus. Sie können alle Tabellen oder eine Teilmenge der Tabellen auswählen, die Sie in einem Speicherkonto archivieren möchten. Sie können sie auch an einen Azure Event Hub streamen.

Hinweis

Der Export von Diagnoseeinstellungen kann die Kosten erhöhen. Weitere Informationen finden Sie unter Exportieren von Telemetrie aus Application Insights. Preisinformationen für dieses Feature finden Sie auf der Seite Azure Monitor – Preise. Zu Beginn des Abrechnungszeitraums erhalten Sie eine entsprechende Benachrichtigung. Wenn Sie den Telemetrieexport über den Benachrichtigungszeitraum hinaus weiter verwenden, wird Ihnen dies mit dem entsprechenden Tarif in Rechnung gestellt.

Nächste Schritte