Skapa en Application Insights-resurs

Varning

Den här artikeln gäller klassiska Application Insights-resurser som inte längre rekommenderas.

Informationen i den här artikeln är inaktuell och uppdateras inte.

Övergå till arbetsytebaserade Application Insights för att dra nytta av nya funktioner.

Application Insights visar data om ditt program i en Azure-resurs. Att skapa en ny resurs är en del av konfigurationen av Application Insights för att övervaka ett nytt program. När du har skapat den nya resursen kan du hämta dess instrumentationsnyckel och använda den för att konfigurera Application Insights SDK. Instrumentationsnyckeln länkar telemetrin till resursen.

Viktigt

Den 29 februari 2024upphör stödet för klassiska Application Insights. Övergå till arbetsytebaserade Application Insights för att dra nytta av nya funktioner. Nyare regioner som introducerades efter februari 2021 stöder inte skapandet av klassiska Application Insights-resurser.

Anteckning

Stödet för inmatning av instrumentationsnycklar upphör den 31 mars 2025. Inmatningen av instrumenteringsnyckeln fortsätter att fungera, men vi kommer inte längre att tillhandahålla uppdateringar eller stöd för funktionen. Övergå till anslutningssträngar för att dra nytta av nya funktioner.

Logga in på Azure

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Skapa en Application Insights-resurs

Logga in på Azure Portal och skapa en Application Insights-resurs.

Inställningar	Värde	Beskrivning
Namn	Unique value	Namn som identifierar den app som du övervakar.
Resursgrupp	myResourceGroup	Namn på den nya eller befintliga resursgruppen som ska vara värd för Application Insights-data.
Region	East US	Välj en plats nära dig eller nära där appen finns.
Resursläge	Classic eller Workspace-based	Med arbetsytebaserade resurser kan du skicka din Application Insights-telemetri till en gemensam Log Analytics-arbetsyta. Mer information finns i Arbetsytebaserade Application Insights-resurser.

Anteckning

Du kan använda samma resursnamn i olika resursgrupper, men det kan vara bra att använda ett globalt unikt namn. Om du planerar att utföra frågor mellan resurser förenklar användning av ett globalt unikt namn den syntax som krävs.

Ange lämpliga värden i de obligatoriska fälten. Välj Granska + skapa.

När appen har skapats visar ett nytt fönster prestanda- och användningsdata om ditt övervakade program.

Kopiera instrumenteringsnyckeln

Instrumentationsnyckeln identifierar den resurs som du vill associera med dina telemetridata. Du måste kopiera instrumentationsnyckeln och lägga till den i programmets kod.

Installera SDK:et i din app

Installera Application Insights SDK i din app. Det här steget beror mycket på typen av program.

Använd instrumentationsnyckeln för att konfigurera den SDK som du installerar i ditt program.

SDK:t innehåller standardmoduler som skickar telemetri, så att du inte behöver skriva mer kod. Om du vill spåra användaråtgärder eller diagnostisera problem i detalj använder du API:et för att skicka din egen telemetri.

Skapa en resurs automatiskt

Använd PowerShell eller Azure CLI för att skapa en resurs automatiskt.

PowerShell

Skapa en ny Application Insights-resurs.

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

Exempel

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

Resultat

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}

Den fullständiga PowerShell-dokumentationen för den här cmdleten och information om hur du hämtar instrumentationsnyckeln finns i Azure PowerShell dokumentationen.

Azure CLI (förhandsversion)

För att få åtkomst till förhandsversionen av Application Insights Azure CLI-kommandon måste du först köra:

 az extension add -n application-insights

Om du inte kör az extension add kommandot visas ett felmeddelande som anger: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Kör följande kommando för att skapa application insights-resursen:

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

Exempel

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

Resultat

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

Den fullständiga Azure CLI-dokumentationen för det här kommandot och information om hur du hämtar instrumentationsnyckeln finns i Azure CLI-dokumentationen.

Åsidosätta standardslutpunkter

Varning

Ändra inte slutpunkter. Övergå till anslutningssträngar för att förenkla konfigurationen och eliminera behovet av att ändra slutpunkten.

Om du vill skicka data från Application Insights till vissa regioner måste du åsidosätta standardslutpunktsadresserna. Varje SDK kräver något olika ändringar, som alla beskrivs i den här artikeln.

Dessa ändringar kräver att du justerar exempelkoden och ersätter platshållarvärdena för QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Addressoch Profile_Query_Endpoint_address med de faktiska slutpunktsadresserna för din specifika region. Slutet av den här artikeln innehåller länkar till slutpunktsadresserna för regioner där den här konfigurationen krävs.

Anteckning

Stödet för inmatning av instrumentationsnycklar upphör den 31 mars 2025. Inmatningen av instrumenteringsnyckeln fortsätter att fungera, men vi kommer inte längre att tillhandahålla uppdateringar eller stöd för funktionen. Övergå till anslutningssträngar för att dra nytta av nya funktioner.

---

SDK-kodändringar

.NET

Anteckning

Denapplicationinsights.config filen skrivs över automatiskt när en SDK-uppgradering utförs. När du har slutfört en SDK-uppgradering måste du ange regionspecifika slutpunktsvärden igen.

<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

Ändra filen appsettings.json i projektet för att justera huvudslutpunkten:

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

Värdena för Live Metrics och profilfrågeslutpunkten kan bara anges via kod. Om du vill åsidosätta standardvärdena för alla slutpunktsvärden via kod gör du följande ändringar i ConfigureServices filens Startup.cs metod:

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

För Azure Functions rekommenderar vi att du använder anslutningssträngar som angetts i funktionens programinställningar. Om du vill komma åt programinställningar för din funktion i funktionsfönstret väljer du InställningarKonfigurationSprograminställningar>>.

Namn: APPLICATIONINSIGHTS_CONNECTION_STRING
Värde: Connection String Value

Java

Ändra applicationinsights.xml-filen för att ändra standardslutpunktsadressen:

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

application.properties Ändra filen och lägg till:

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

Slutpunkterna kan också konfigureras via miljövariabler:

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

JavaScript

Det aktuella kodfragmentet som visas här är version 5. Versionen kodas i kodfragmentet som sv:"#". Den aktuella versionen är också tillgänglig på 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>

Anteckning

För läsbarhet och för att minska möjliga JavaScript-fel visas alla möjliga konfigurationsalternativ på en ny rad i föregående kodfragment. Om du inte vill ändra värdet för en kommenterad rad kan den tas bort.

Python

Information om hur du ändrar inmatningsslutpunkten för opencensus-python SDK finns i opencensus-python-lagringsplatsen.

Regioner som kräver ändring av slutpunkt

För närvarande är de enda regioner som kräver slutpunktsändringar Azure Government och Azure Kina.

Region	Slutpunktsnamn	Värde
Azure Kina	Telemetrikanal	https://dc.applicationinsights.azure.cn/v2/track
Azure Kina	QuickPulse (livemått)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure Kina	Profilfråga	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Telemetrikanal	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (livemått)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Profilfråga	https://dc.applicationinsights.us/api/profiles/{0}/appId

Om du för närvarande använder Application Insights REST API, som normalt nås via api.applicationinsights.io, måste du använda en slutpunkt som är lokal i din region.

Region	Slutpunktsnamn	Värde
Azure Kina	REST-API	api.applicationinsights.azure.cn
Azure Government	REST-API	api.applicationinsights.us

Nästa steg

• Använd Diagnostiksökning.
• Utforska mått.
• Skriv Log Analytics-frågor.
• Mer information om anpassade ändringar för Azure Government finns i den detaljerade vägledningen för Övervakning och hantering av Azure.
• Mer information om Azure Kina finns i Azure China Playbook.