Create an Application Insights resource (Een Application Insights-resource maken)

Let op

Dit artikel is van toepassing op klassieke Application Insights-resources, die niet meer worden aanbevolen.

De informatie in dit artikel is verouderd en wordt niet bijgewerkt.

Overstappen op Application Insights op basis van een werkruimte om te profiteren van nieuwe mogelijkheden.

Application Insights geeft gegevens weer over uw toepassing in een Azure-resource. Het maken van een nieuwe resource maakt deel uit van het instellen van Application Insights om een nieuwe toepassing te bewaken. Nadat u de nieuwe resource hebt gemaakt, kunt u de instrumentatiesleutel ophalen en deze gebruiken om de Application Insights SDK te configureren. De instrumentatiesleutel koppelt uw telemetrie aan de resource.

Belangrijk

Op 29 februari 2024 wordt de ondersteuning voor klassieke Application Insights beëindigd. Overstappen op Application Insights op basis van een werkruimte om te profiteren van nieuwe mogelijkheden. Nieuwere regio's die na februari 2021 zijn geïntroduceerd, bieden geen ondersteuning voor het maken van klassieke Application Insights-resources.

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 verbindingsreeks s om te profiteren van nieuwe mogelijkheden.

Aanmelden bij Azure

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Create an Application Insights resource (Een Application Insights-resource maken)

Meld u aan bij Azure Portal en maak een Application Insights-resource.

Instellingen	Weergegeven als	Beschrijving
Naam	Unique value	Naam die de app identificeert die u bewaakt.
Resourcegroep	myResourceGroup	Naam voor de nieuwe of bestaande resourcegroep voor het hosten van Application Insights-gegevens.
Regio	East US	Selecteer een locatie bij u in de buurt of in de buurt waar uw app wordt gehost.
Resourcemodus	Classic of Workspace-based	Met op werkruimte gebaseerde resources kunt u uw Application Insights-telemetrie verzenden naar een algemene Log Analytics-werkruimte. Zie Application Insights-resources op basis van werkruimten voor meer informatie.

Notitie

U kunt dezelfde resourcenaam gebruiken in verschillende resourcegroepen, maar het kan nuttig zijn om een wereldwijd unieke naam te gebruiken. Als u van plan bent om query's voor meerdere resources uit te voeren, vereenvoudigt u de vereiste syntaxis met behulp van een wereldwijd unieke naam.

Voer de juiste waarden in de vereiste velden in. Selecteer Controleren + maken.

Nadat uw app is gemaakt, worden in een nieuw deelvenster prestatie- en gebruiksgegevens over uw bewaakte toepassing weergegeven.

De instrumentatiesleutel kopiëren

De instrumentatiesleutel identificeert de resource die u aan uw telemetriegegevens wilt koppelen. U moet de instrumentatiesleutel kopiëren en toevoegen aan de code van uw toepassing.

De SDK installeren in uw app

Installeer de Application Insights SDK in uw app. Deze stap is sterk afhankelijk van het type toepassing.

Gebruik de instrumentatiesleutel om de SDK te configureren die u in uw toepassing installeert.

De SDK bevat standaardmodules die telemetrie verzenden, zodat u geen code meer hoeft te schrijven. Als u gebruikersacties wilt bijhouden of problemen in meer detail wilt diagnosticeren, gebruikt u de API om uw eigen telemetrie te verzenden.

Automatisch een resource maken

Gebruik PowerShell of de Azure CLI om automatisch een resource te maken.

Powershell

Maak een nieuwe Application Insights-resource.

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

Opmerking

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

Resultaten

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}

Zie de Documentatie voor Azure PowerShell voor de volledige PowerShell-documentatie voor deze cmdlet en voor meer informatie over het ophalen van de instrumentatiesleutel.

Azure CLI (preview)

Als u toegang wilt krijgen tot de Azure CLI-opdrachten van Preview, moet u eerst het volgende uitvoeren:

 az extension add -n application-insights

Als u de az extension add opdracht niet uitvoert, ziet u een foutbericht met de volgende status: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Voer de volgende opdracht uit om uw Application Insights-resource te maken:

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

Opmerking

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

Resultaten

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

Voor de volledige Documentatie van Azure CLI voor deze opdracht en voor meer informatie over het ophalen van de instrumentatiesleutel, raadpleegt u de Azure CLI-documentatie.

Standaardeindpunten overschrijven

Waarschuwing

Wijzig geen eindpunten. Overgang naar verbindingsreeks s om de configuratie te vereenvoudigen en de noodzaak voor het wijzigen van eindpunten te elimineren.

Als u gegevens van Application Insights naar bepaalde regio's wilt verzenden, moet u de standaardeindpuntadressen overschrijven. Elke SDK vereist iets andere wijzigingen, die allemaal in dit artikel worden beschreven.

Voor deze wijzigingen moet u de voorbeeldcode aanpassen en de tijdelijke aanduidingen voor QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Addressen Profile_Query_Endpoint_address door de werkelijke eindpuntadressen voor uw specifieke regio vervangen. Het einde van dit artikel bevat koppelingen naar de eindpuntadressen voor regio's waarvoor deze configuratie is vereist.

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 verbindingsreeks s om te profiteren van nieuwe mogelijkheden.

---

SDK-codewijzigingen

.NET

Notitie

Het bestand applicationinsights.config wordt automatisch overschreven wanneer een SDK-upgrade wordt uitgevoerd. Nadat u een SDK-upgrade hebt uitgevoerd, moet u de regiospecifieke eindpuntwaarden opnieuw invoeren.

<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

Wijzig het appsettings.json-bestand in uw project om het hoofdeindpunt aan te passen:

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

De waarden voor Live Metrics en het eindpunt profielquery kunnen alleen worden ingesteld via code. Als u de standaardwaarden voor alle eindpuntwaarden wilt overschrijven via code, moet u de volgende wijzigingen aanbrengen in de ConfigureServices methode van het Startup.cs bestand:

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 Functions

Voor Azure Functions wordt u aangeraden verbindingsreeks te gebruiken die zijn ingesteld in de toepassingsinstellingen van de functie. Als u vanuit het deelvenster Functies toegang wilt krijgen tot toepassingsinstellingen voor uw functie, selecteert u Instellingen>voor configuratietoepassingsinstellingen.>

Naam: APPLICATIONINSIGHTS_CONNECTION_STRING
Waarde: Connection String Value

Java

Wijzig het applicationinsights.xml-bestand om het standaardeindpuntadres te wijzigen:

<?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

Wijzig het bestand en voeg het application.properties volgende toe:

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();

De eindpunten kunnen ook worden geconfigureerd via omgevingsvariabelen:

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

JavaScript

Het huidige fragment dat hier wordt vermeld, is versie 5. De versie wordt gecodeerd in het fragment als sv:"#". De huidige versie is ook beschikbaar op GitHub.

<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>

Notitie

Voor leesbaarheid en om mogelijke JavaScript-fouten te verminderen, worden alle mogelijke configuratieopties vermeld op een nieuwe regel in de voorgaande codefragment. Als u de waarde van een regel met opmerkingen niet wilt wijzigen, kunt u deze verwijderen.

Python

Raadpleeg de opencensus-python-opslagplaats voor hulp bij het wijzigen van het opname-eindpunt voor de opencensus-python SDK.

Regio's waarvoor eindpuntwijziging is vereist

Momenteel zijn de enige regio's die eindpuntwijzigingen vereisen Azure Government en Azure China.

Regio	Naam Eeindpunt	Weergegeven als
Azure China	Telemetriekanaal	https://dc.applicationinsights.azure.cn/v2/track
Azure China	QuickPulse (Live Metrics)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure China	Profielquery	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Telemetriekanaal	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (Live Metrics)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Profielquery	https://dc.applicationinsights.us/api/profiles/{0}/appId

Als u momenteel de Rest API van Application Insights gebruikt, die normaal gesproken toegankelijk is via api.applicationinsights.io, moet u een eindpunt gebruiken dat lokaal is in uw regio.

Regio	Naam Eeindpunt	Weergegeven als
Azure China	REST-API	api.applicationinsights.azure.cn
Azure Government	REST-API	api.applicationinsights.us

Volgende stappen

• Gebruik diagnostische zoekopdrachten.
• Verken metrische gegevens.
• Log Analytics-query's schrijven.
• Zie de gedetailleerde richtlijnen voor azure-bewaking en -beheer voor meer informatie over de aangepaste wijzigingen voor Azure Government.
• Zie het Playbook Azure China voor meer informatie over Azure China.