Een Application Insights-resource maken

Waarschuwing

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.

Stap over naar Application Insights op basis van werkruimte om te profiteren van nieuwe mogelijkheden.

Application Insights geeft gegevens over uw toepassing weer 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 bijbehorende instrumentatiesleutel ophalen en deze gebruiken om de Application Insights SDK te configureren. De instrumentatiesleutel koppelt uw telemetrie aan de resource.

Belangrijk

Op 29 februari 2024eindigt de ondersteuning voor klassieke Application Insights. Stap over naar Application Insights op basis van 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 verbindingsreeksen om te profiteren van nieuwe mogelijkheden.

Aanmelden bij Azure

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

Een Application Insights-resource maken

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

Instellingen	Waarde	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 werkruimteresources 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 het gebruik van een wereldwijd unieke naam de vereiste syntaxis.

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 wilt koppelen aan uw telemetriegegevens. 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>]

Voorbeeld

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 over de 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-preview-opdrachten van Application Insights, 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 tekst: 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]

Voorbeeld

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

Zie de Azure CLI-documentatie voor de volledige Azure CLI-documentatie voor deze opdracht en voor meer informatie over het ophalen van de instrumentatiesleutel.

Standaardeindpunten overschrijven

Waarschuwing

Wijzig eindpunten niet. Overgang naar verbindingsreeksen om de configuratie te vereenvoudigen en de noodzaak voor eindpuntwijziging 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 vervangen door de werkelijke eindpuntadressen voor uw specifieke regio. Het einde van dit artikel bevat koppelingen naar de eindpuntadressen voor regio's waar 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 verbindingsreeksen om te profiteren van nieuwe mogelijkheden.

---

Wijzigingen in SDK-code

.NET

Notitie

Het applicationinsights.config-bestand wordt automatisch overschreven wanneer er 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 bestand appsettings.json 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 via code wilt overschrijven, 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 verbindingsreeksen 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>Configuratie>Toepassingsinstellingen.

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 codefragment dat hier wordt vermeld, is versie 5. De versie wordt in het codefragment gecodeerd 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 de leesbaarheid en om mogelijke JavaScript-fouten te beperken, worden alle mogelijke configuratieopties vermeld op een nieuwe regel in de voorgaande codefragmenten. Als u de waarde van een regel met opmerkingen niet wilt wijzigen, kan deze worden verwijderd.

Python

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

Regio's waarvoor eindpuntwijziging is vereist

Op dit moment zijn de enige regio's waarvoor eindpuntwijzigingen zijn vereist Azure Government en Azure China.

Regio	Eindpuntnaam	Waarde
Azure China	Telemetriekanaal	https://dc.applicationinsights.azure.cn/v2/track
Azure China	QuickPulse (live metrische gegevens)	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 metrische gegevens)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Profielquery	https://dc.applicationinsights.us/api/profiles/{0}/appId

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

Regio	Eindpuntnaam	Waarde
Azure China	REST-API	api.applicationinsights.azure.cn
Azure Government	REST-API	api.applicationinsights.us

Volgende stappen

• Diagnostische zoekopdrachten gebruiken.
• Metrische gegevens verkennen.
• 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 Azure China Playbook voor meer informatie over Azure China.