Erstellen einer Application Insights-Ressource

Achtung

Dieser Artikel gilt für Application Insights Classic-Ressourcen, die nicht mehr empfohlen werden.

Die Informationen in diesem Artikel sind veraltet und werden nicht mehr aktualisiert.

Stellen Sie auf die arbeitsbereichsbasierte Application Insights-Instanz um, damit Sie neue Funktionen nutzen können.

Application Insights zeigt Daten über Ihre Anwendung in einer Azure-Ressource an. Das Erstellen einer neuen Ressource ist Teil des Einrichtens von Application Insights zur Überwachung einer neuen Anwendung. Nach dem Erstellen der neuen Ressource können Sie ihren Instrumentierungsschlüssel abrufen und ihn zum Konfigurieren des Application Insights-SDK verwenden. Der Instrumentierungsschlüssel verknüpft Ihre Telemetriedaten mit der Ressource.

Wichtig

Am 29. Februar 2024endet der Support für die klassische Application Insights. Stellen Sie auf die arbeitsbereichsbasierte Application Insights-Instanz um, damit Sie neue Funktionen nutzen können. Neuere Regionen, die nach Februar 2021 eingeführt wurden, unterstützen das Erstellen klassischer Application Insights-Ressourcen nicht.

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. Wechseln Sie zu Verbindungszeichenfolgen, damit Sie neue Funktionen nutzen können.

Anmelden bei Azure

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Erstellen einer Application Insights-Ressource

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

Einstellungen	Wert	BESCHREIBUNG
Name	Unique value	Der Name, der die zu überwachende App identifiziert
Ressourcengruppe	myResourceGroup	Der Name der neuen oder bestehenden Ressourcengruppe, die Application Insights-Daten hosten soll.
Region	East US	Wählen Sie einen Ort in Ihrer Nähe aus, oder in der Nähe des Ortes, an dem Ihre App gehostet wird.
Ressourcenmodus	Classic oder Workspace-based	Arbeitsbereichsbasierte Ressourcen ermöglichen Ihnen das Senden Ihrer Application Insights-Telemetrie an einen gemeinsamen Log Analytics-Arbeitsbereich. Weitere Informationen finden Sie unter Arbeitsbereichsbezogene Application Insights-Ressourcen.

Hinweis

Sie können denselben Ressourcennamen für verschiedene Ressourcengruppen verwenden, es kann aber von Vorteil sein, einen global eindeutigen Namen zu verwenden. Wenn Sie planen, ressourcenübergreifende Abfragen durchzuführen, vereinfacht die Verwendung eines global eindeutigen Namens die erforderliche Syntax.

Geben Sie die entsprechenden Werte in die Pflichtfelder ein. Klicken Sie auf Überprüfen + erstellen.

Nachdem Ihre App erstellt wurde, werden in einem neuen Bereich Leistungs- und Verbrauchsdaten zu Ihrer überwachten Anwendung angezeigt.

Kopieren des Instrumentationsschlüssels

Der Instrumentierungsschlüssel identifiziert die Ressource, die Sie mit Ihren Telemetriedaten verknüpfen möchten. Sie müssen den Instrumentierungsschlüssel kopieren und in Ihrem Anwendungscode hinzufügen.

Installieren des SDK in Ihrer App

Installieren Sie das Application Insights-SDK in Ihrer App. Dieser Schritt hängt stark von der Art der Anwendung ab.

Konfigurieren Sie das SDK, das Sie in Ihrer Anwendung installieren mithilfe des Instrumentierungsschlüssels.

Das SDK enthält die Standardmodule, die Telemetriedaten senden, so dass Sie keinen weiteren Code schreiben müssen. Um Benutzeraktionen nachzuverfolgen oder Probleme im Detail zu diagnostizieren, verwenden Sie die API zum Senden eigener Telemetriedaten.

Automatisches Erstellen einer Ressource

Verwenden Sie PowerShell oder die Azure-Befehlszeilenschnittstelle, um eine Ressource automatisch zu erstellen.

PowerShell

Erstellen Sie eine neue Application Insights-Ressource.

New-AzApplicationInsights [-ResourceGroupName] <String> [-Name] <String> [-Location] <String> [-Kind <String>]
 [-Tag <Hashtable>] [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]

Beispiel

New-AzApplicationInsights -Kind java -ResourceGroupName testgroup -Name test1027 -location eastus

Ergebnisse

Id                 : /subscriptions/{subid}/resourceGroups/testgroup/providers/microsoft.insights/components/test1027
ResourceGroupName  : testgroup
Name               : test1027
Kind               : web
Location           : eastus
Type               : microsoft.insights/components
AppId              : 8323fb13-32aa-46af-b467-8355cf4f8f98
ApplicationType    : web
Tags               : {}
CreationDate       : 10/27/2017 4:56:40 PM
FlowType           :
HockeyAppId        :
HockeyAppToken     :
InstrumentationKey : 00000000-aaaa-bbbb-cccc-dddddddddddd
ProvisioningState  : Succeeded
RequestSource      : AzurePowerShell
SamplingPercentage :
TenantId           : {subid}

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

Azure CLI (Vorschauversion)

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 Hinweis angezeigt: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'..

Führen sie den folgenden Befehl aus, um Ihre Application Insights-Ressource zu erstellen:

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--kind]
                                         [--tags]

Beispiel

az monitor app-insights component create --app demoApp --location westus2 --kind web --resource-group demoRg --application-type web

Ergebnisse

az monitor app-insights component create --app demoApp --location eastus --kind web --resource-group demoApp --application-type web
{
  "appId": "87ba512c-e8c9-48d7-b6eb-118d4aee2697",
  "applicationId": "demoApp",
  "applicationType": "web",
  "creationDate": "2019-08-16T18:15:59.740014+00:00",
  "etag": "\"0300edb9-0000-0100-0000-5d56f2e00000\"",
  "flowType": "Bluefield",
  "hockeyAppId": null,
  "hockeyAppToken": null,
  "id": "/subscriptions/{subid}/resourceGroups/demoApp/providers/microsoft.insights/components/demoApp",
  "instrumentationKey": "00000000-aaaa-bbbb-cccc-dddddddddddd",
  "kind": "web",
  "location": "eastus",
  "name": "demoApp",
  "provisioningState": "Succeeded",
  "requestSource": "rest",
  "resourceGroup": "demoApp",
  "samplingPercentage": null,
  "tags": {},
  "tenantId": {tenantID},
  "type": "microsoft.insights/components"
}

Die vollständige Azure CLI-Dokumentation für diesen Befehl und Informationen zum Abrufen des Instrumentierungsschlüssels finden Sie in der Azure CLI-Dokumentation.

Überschreiben von Standardendpunkten

Warnung

Ändern Sie keine Endpunkte. Übergang zu Verbindungszeichenfolgen, um die Konfiguration zu vereinfachen und die Notwendigkeit einer Endpunktänderung zu beseitigen.

Zum Senden von Daten aus Application Insights in bestimmten Regionen müssen Sie die standardmäßigen Endpunktadressen überschreiben. Jedes SDK erfordert geringfügig andere Änderungen, die in diesem Artikel beschrieben werden.

Diese Änderungen erfordern, dass Sie den Beispielcode anpassen und die Platzhalterwerte für QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Address und Profile_Query_Endpoint_address durch die tatsächlichen Endpunktadressen Ihrer spezifischen Region ersetzen. Am Ende dieses Artikels finden Sie Links zu den Endpunktadressen für Regionen, in denen diese Konfiguration erforderlich ist.

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. Wechseln Sie zu Verbindungszeichenfolgen, damit Sie neue Funktionen nutzen können.

---

Änderungen am SDK-Code

.NET

Hinweis

Die Datei applicationinsights.config wird jedes Mal automatisch überschrieben, wenn ein SDK-Upgrade durchgeführt wird. Nachdem Sie ein SDK-Upgrade durchgeführt haben, müssen Sie die regionsspezifischen Endpunktwerte erneut eingeben.

<ApplicationInsights>
  ...
  <TelemetryModules>
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector">
      <QuickPulseServiceEndpoint>Custom_QuickPulse_Endpoint_Address</QuickPulseServiceEndpoint>
    </Add>
  </TelemetryModules>
   ...
  <TelemetrySinks>
    <Add Name = "default">
      <TelemetryChannel>
         <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
      </TelemetryChannel>
    </Add>
  </TelemetrySinks>
  ...
  <ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights">
    <ProfileQueryEndpoint>Profile_Query_Endpoint_address</ProfileQueryEndpoint>
  </ApplicationIdProvider>
  ...
</ApplicationInsights>

.NET Core

Ändern Sie die Datei appsettings.json in Ihrem Projekt, um den Hauptendpunkt anzupassen:

"ApplicationInsights": {
    "InstrumentationKey": "instrumentationkey",
    "TelemetryChannel": {
      "EndpointAddress": "TelemetryChannel_Endpoint_Address"
    }
  }

Die Werte für „Livemetriken“ und der Endpunkt für die „Profilabfrage“ können nur mittels Code festgelegt werden. Um die Standardwerte für alle Endpunktwerte mittels Code zu überschreiben, nehmen Sie in der Datei Startup.cs die folgenden Änderungen an der ConfigureServices-Methode vor:

using Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse; //Place at top of Startup.cs file

   services.ConfigureTelemetryModule<QuickPulseTelemetryModule>((module, o) => module.QuickPulseServiceEndpoint="QuickPulse_Endpoint_Address");

   services.AddSingleton<IApplicationIdProvider, ApplicationInsightsApplicationIdProvider>(_ => new ApplicationInsightsApplicationIdProvider() { ProfileQueryEndpoint = "Profile_Query_Endpoint_address" });

   services.AddSingleton<ITelemetryChannel>(_ => new ServerTelemetryChannel() { EndpointAddress = "TelemetryChannel_Endpoint_Address" });

    //Place in the ConfigureServices method. Place this before services.AddApplicationInsightsTelemetry("instrumentation key"); if it's present

Azure-Funktionen

Für Azure Functions empfehlen wir, dass Sie Verbindungszeichenfolgen verwenden, die in den Anwendungseinstellungen der Funktion festgelegt sind. Um im Funktionsbereich auf die Anwendungseinstellungen für Ihre Funktion zuzugreifen, wählen Sie Einstellungen>Konfiguration>Anwendungseinstellungen aus.

Name: APPLICATIONINSIGHTS_CONNECTION_STRING
Wert: Connection String Value

Java

Modifizieren Sie die Datei applicationinsights.xml, um die Standardendpunktadresse zu ändern:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
  <InstrumentationKey>ffffeeee-dddd-cccc-bbbb-aaaa99998888</InstrumentationKey>
  <TelemetryModules>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebRequestTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebSessionTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebUserTrackingTelemetryModule"/>
  </TelemetryModules>
  <TelemetryInitializers>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationIdTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationNameTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebSessionTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserAgentTelemetryInitializer"/>
  </TelemetryInitializers>
  <!--Add the following Channel value to modify the Endpoint address-->
  <Channel type="com.microsoft.applicationinsights.channel.concrete.inprocess.InProcessTelemetryChannel">
  <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
  </Channel>
</ApplicationInsights>

Spring Boot

Ändern Sie die Datei application.properties, und fügen Sie Folgendes hinzu:

azure.application-insights.channel.in-process.endpoint-address= TelemetryChannel_Endpoint_Address

Node.js

var appInsights = require("applicationinsights");
appInsights.setup('INSTRUMENTATION_KEY');
appInsights.defaultClient.config.endpointUrl = "TelemetryChannel_Endpoint_Address"; // ingestion
appInsights.defaultClient.config.profileQueryEndpoint = "Profile_Query_Endpoint_address"; // appid/profile lookup
appInsights.defaultClient.config.quickPulseHost = "QuickPulse_Endpoint_Address"; //live metrics
appInsights.Configuration.start();

Die Endpunkte können auch über Umgebungsvariablen konfiguriert werden:

**Instrumentation Key*: "APPINSIGHTS_INSTRUMENTATIONKEY"
*Profile endpoint*: "Profile_Query_Endpoint_address"
*Live Metrics endpoint*: "QuickPulse_Endpoint_Address"

JavaScript

Der hier aufgeführte aktuelle Codeschnipsel ist Version 5. Die Version ist im Codeschnipsel als sv:"#" codiert. Die aktuelle Version ist auch auf GitHub verfügbar.

<script type="text/javascript">
!function(T,l,y){var S=T.location,k="script",D="instrumentationKey",C="ingestionendpoint",I="disableExceptionTracking",E="ai.device.",b="toLowerCase",w="crossOrigin",N="POST",e="appInsightsSDK",t=y.name||"appInsights";(y.name||T[e])&&(T[e]=t);var n=T[t]||function(d){var g=!1,f=!1,m={initialize:!0,queue:[],sv:"5",version:2,config:d};function v(e,t){var n={},a="Browser";return n[E+"id"]=a[b](),n[E+"type"]=a,n["ai.operation.name"]=S&&S.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(m.sv||m.version),{time:function(){var e=new Date;function t(e){var t=""+e;return 1===t.length&&(t="0"+t),t}return e.getUTCFullYear()+"-"+t(1+e.getUTCMonth())+"-"+t(e.getUTCDate())+"T"+t(e.getUTCHours())+":"+t(e.getUTCMinutes())+":"+t(e.getUTCSeconds())+"."+((e.getUTCMilliseconds()/1e3).toFixed(3)+"").slice(2,5)+"Z"}(),iKey:e,name:"Microsoft.ApplicationInsights."+e.replace(/-/g,"")+"."+t,sampleRate:100,tags:n,data:{baseData:{ver:2}}}}var h=d.url||y.src;if(h){function a(e){var t,n,a,i,r,o,s,c,u,p,l;g=!0,m.queue=[],f||(f=!0,t=h,s=function(){var e={},t=d.connectionString;if(t)for(var n=t.split(";"),a=0;a<n.length;a++){var i=n[a].split("=");2===i.length&&(e[i[0][b]()]=i[1])}if(!e[C]){var r=e.endpointsuffix,o=r?e.location:null;e[C]="https://"+(o?o+".":"")+"dc."+(r||"services.visualstudio.com")}return e}(),c=s[D]||d[D]||"",u=s[C],p=u?u+"/v2/track":d.endpointUrl,(l=[]).push((n="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",a=t,i=p,(o=(r=v(c,"Exception")).data).baseType="ExceptionData",o.baseData.exceptions=[{typeName:"SDKLoadFailed",message:n.replace(/\./g,"-"),hasFullStack:!1,stack:n+"\nSnippet failed to load ["+a+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(S&&S.pathname||"_unknown_")+"\nEndpoint: "+i,parsedStack:[]}],r)),l.push(function(e,t,n,a){var i=v(c,"Message"),r=i.data;r.baseType="MessageData";var o=r.baseData;return o.message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+n+")").replace(/\"/g,"")+'"',o.properties={endpoint:a},i}(0,0,t,p)),function(e,t){if(JSON){var n=T.fetch;if(n&&!y.useXhr)n(t,{method:N,body:JSON.stringify(e),mode:"cors"});else if(XMLHttpRequest){var a=new XMLHttpRequest;a.open(N,t),a.setRequestHeader("Content-type","application/json"),a.send(JSON.stringify(e))}}}(l,p))}function i(e,t){f||setTimeout(function(){!t&&m.core||a()},500)}var e=function(){var n=l.createElement(k);n.src=h;var e=y[w];return!e&&""!==e||"undefined"==n[w]||(n[w]=e),n.onload=i,n.onerror=a,n.onreadystatechange=function(e,t){"loaded"!==n.readyState&&"complete"!==n.readyState||i(0,t)},n}();y.ld<0?l.getElementsByTagName("head")[0].appendChild(e):setTimeout(function(){l.getElementsByTagName(k)[0].parentNode.appendChild(e)},y.ld||0)}try{m.cookie=l.cookie}catch(p){}function t(e){for(;e.length;)!function(t){m[t]=function(){var e=arguments;g||m.queue.push(function(){m[t].apply(m,e)})}}(e.pop())}var n="track",r="TrackPage",o="TrackEvent";t([n+"Event",n+"PageView",n+"Exception",n+"Trace",n+"DependencyData",n+"Metric",n+"PageViewPerformance","start"+r,"stop"+r,"start"+o,"stop"+o,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),m.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4};var s=(d.extensionConfig||{}).ApplicationInsightsAnalytics||{};if(!0!==d[I]&&!0!==s[I]){var c="onerror";t(["_"+c]);var u=T[c];T[c]=function(e,t,n,a,i){var r=u&&u(e,t,n,a,i);return!0!==r&&m["_"+c]({message:e,url:t,lineNumber:n,columnNumber:a,error:i}),r},d.autoExceptionInstrumented=!0}return m}(y.cfg);function a(){y.onInit&&y.onInit(n)}(T[t]=n).queue&&0===n.queue.length?(n.queue.push(a),n.trackPageView({})):a()}(window,document,{
src: "https://js.monitor.azure.com/scripts/b/ai.2.min.js", // The SDK URL Source
// name: "appInsights", // Global SDK Instance name defaults to "appInsights" when not supplied.
// ld: 0, // Defines the load delay (in ms) before attempting to load the sdk. -1 = block page load and add to head (default) = 0ms load after timeout.
// useXhr: 1, // Use XHR instead of fetch to report failures (if available).
crossOrigin: "anonymous", // When supplied, this will add the provided value as the cross origin attribute on the script tag.
// onInit: null, // Once the Application Insights instance has loaded and initialized, this callback function will be called with 1 argument -- the sdk instance. (DO NOT ADD anything to the sdk.queue -- as they won't get called.)
cfg: { // Application Insights Configuration
    instrumentationKey:"INSTRUMENTATION_KEY",
    endpointUrl: "TelemetryChannel_Endpoint_Address"
}});
</script>

Hinweis

Für eine bessere Lesbarkeit und zur Reduzierung möglicher JavaScript-Fehler werden alle möglichen Konfigurationsoptionen im voranstehenden Codeausschnitt in einer eigenen Zeile aufgeführt. Wenn Sie den Wert einer kommentierten Zeile nicht ändern möchten, kann sie entfernt werden.

Python

Anleitungen zum Ändern des Erfassungsendpunkts für das opencensus-python-SDK finden Sie im opencensus-python-Repository.

Regionen, für die Endpunktänderungen erforderlich sind

Derzeit sind Azure Government und Azure China die einzigen Regionen, für die Endpunktänderungen erforderlich sind.

Region	Endpunktname	Wert
Azure China	Telemetriekanal	https://dc.applicationinsights.azure.cn/v2/track
Azure China	QuickPulse (Live Metrics)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure China	Profile Query	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Telemetriekanal	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (Live Metrics)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Profile Query	https://dc.applicationinsights.us/api/profiles/{0}/appId

Wenn Sie derzeit die Application Insights-REST-API nutzen, auf die normalerweise über api.applicationinsights.io zugegriffen wird, müssen Sie einen lokalen Endpunkt in Ihrer Region verwenden.

Region	Endpunktname	Wert
Azure China	REST-API	api.applicationinsights.azure.cn
Azure Government	REST-API	api.applicationinsights.us

Nächste Schritte

• Verwenden Sie die Diagnosesuche.
• Erkunden Sie Metriken.
• Schreiben Sie Log Analytics-Abfragen.
• Um mehr über die benutzerdefinierten Änderungen für Azure Government zu erfahren, lesen Sie die detaillierten Anleitungen für die Azure-Überwachung und -Verwaltung.
• Weitere Informationen zu Azure China finden Sie im Azure China-Playbook.