Vytvoření prostředku Application Insights

Upozornění

Tento článek se týká klasických prostředků Application Insights, které se už nedoporučují.

Informace v tomto článku jsou zastaralé a nebudou aktualizovány.

Přechod na Application Insights založený na pracovních prostorech, abyste mohli využívat nové funkce.

Application Insights zobrazuje data o vaší aplikaci v prostředku Azure. Vytvoření nového prostředku je součástí nastavení Application Insights pro monitorování nové aplikace. Po vytvoření nového prostředku můžete získat jeho instrumentační klíč a použít ho ke konfiguraci sady Application Insights SDK. Instrumentační klíč propojuje telemetrii s prostředkem.

Důležité

29. února 2024 skončí podpora klasického Application Insights. Přechod na Application Insights založený na pracovních prostorech, abyste mohli využívat nové funkce. Novější oblasti zavedené po únoru 2021 nepodporují vytváření klasických prostředků Application Insights.

Poznámka:

Podpora příjmu dat založeného na instrumentačním klíči skončí 31. března 2025. Příjem klíčů instrumentace bude dál fungovat, ale už nebudeme poskytovat aktualizace ani podporu pro tuto funkci. Přechod na připojovací řetězec, abyste mohli využívat nové funkce.

Přihlášení k Azure

Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.

Vytvoření prostředku Application Insights

Přihlaste se k webu Azure Portal a vytvořte prostředek Application Insights.

Nastavení	Hodnota	Popis
Jméno	Unique value	Název, který identifikuje aplikaci, kterou monitorujete.
Skupina prostředků	myResourceGroup	Název nové nebo existující skupiny prostředků pro hostování dat Application Insights
Oblast	East US	Vyberte umístění blízko vás nebo blízko místa, kde je vaše aplikace hostovaná.
Režim prostředků	Classic nebo Workspace-based	Prostředky založené na pracovních prostorech umožňují odesílat telemetrii Application Insights do společného pracovního prostoru služby Log Analytics. Další informace najdete v tématu Prostředky Application Insights založené na pracovních prostorech.

Poznámka:

Stejný název prostředku můžete použít v různých skupinách prostředků, ale může být výhodné použít globálně jedinečný název. Pokud plánujete provádět dotazy napříč prostředky, použití globálně jedinečného názvu zjednodušuje požadovanou syntaxi.

Do požadovaných polí zadejte příslušné hodnoty. Vyberte Zkontrolovat a vytvořit.

Po vytvoření aplikace se v novém podokně zobrazí údaje o výkonu a využití monitorované aplikace.

Zkopírování klíče instrumentace

Instrumentační klíč identifikuje prostředek, který chcete přidružit k datům telemetrie. Musíte zkopírovat instrumentační klíč a přidat ho do kódu vaší aplikace.

Instalace sady SDK v aplikaci

Nainstalujte do své aplikace sadu Application Insights SDK. Tento krok závisí hodně na typu vaší aplikace.

Pomocí instrumentačního klíče nakonfigurujte sadu SDK, kterou v aplikaci nainstalujete.

Sada SDK obsahuje standardní moduly, které odesílají telemetrii, takže nemusíte psát žádný další kód. Pokud chcete sledovat akce uživatelů nebo diagnostikovat problémy podrobněji, použijte rozhraní API k odeslání vlastní telemetrie.

Automatické vytvoření prostředku

K automatickému vytvoření prostředku použijte PowerShell nebo Azure CLI.

PowerShell

Vytvořte nový prostředek Application Insights.

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

Příklad

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

Výsledky

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}

Úplnou dokumentaci k PowerShellu pro tuto rutinu a informace o načtení instrumentačního klíče najdete v dokumentaci k Azure PowerShellu.

Azure CLI (Preview)

Pokud chcete získat přístup k příkazům Azure CLI služby Application Insights ve verzi Preview, musíte nejprve spustit:

 az extension add -n application-insights

Pokud příkaz nespustíte az extension add , zobrazí se chybová zpráva s informacemi: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Spuštěním následujícího příkazu vytvořte prostředek Application Insights:

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

Příklad

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

Výsledky

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

Úplnou dokumentaci k Azure CLI pro tento příkaz a informace o načtení instrumentačního klíče najdete v dokumentaci k Azure CLI.

Přepsání výchozích koncových bodů

Upozorňující

Neupravujte koncové body. Přechod na připojovací řetězec pro zjednodušení konfigurace a odstranění potřeby úprav koncového bodu

Pokud chcete odesílat data z Application Insights do určitých oblastí, musíte přepsat výchozí adresy koncových bodů. Každá sada SDK vyžaduje mírně odlišné úpravy, z nichž všechny jsou popsané v tomto článku.

Tyto změny vyžadují, abyste upravili vzorový kód a nahradili zástupné hodnoty pro QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Addressa Profile_Query_Endpoint_address skutečnými adresami koncových bodů pro vaši konkrétní oblast. Na konci tohoto článku najdete odkazy na adresy koncových bodů pro oblasti, kde je tato konfigurace nutná.

Poznámka:

Podpora příjmu dat založeného na instrumentačním klíči skončí 31. března 2025. Příjem klíčů instrumentace bude dál fungovat, ale už nebudeme poskytovat aktualizace ani podporu pro tuto funkci. Přechod na připojovací řetězec, abyste mohli využívat nové funkce.

---

Změny kódu sady SDK

.NET

Poznámka:

Soubor applicationinsights.config se automaticky přepíše při provádění upgradu sady SDK. Po provedení upgradu sady SDK nezapomeňte znovu zadat hodnoty koncového bodu specifické pro danou oblast.

<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

Upravte soubor appsettings.json v projektu a upravte hlavní koncový bod:

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

Hodnoty pro živé metriky a koncový bod dotazu profilu je možné nastavit pouze prostřednictvím kódu. Pokud chcete přepsat výchozí hodnoty pro všechny hodnoty koncových bodů prostřednictvím kódu, proveďte následující změny v ConfigureServices metodě Startup.cs souboru:

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

Pro Azure Functions doporučujeme použít připojovací řetězec nastavené v nastavení aplikace funkce. Pokud chcete získat přístup k nastavení aplikace pro vaši funkci v podokně funkcí, vyberte Nastavení aplikace konfigurace>nastavení.>

Název: APPLICATIONINSIGHTS_CONNECTION_STRING
Hodnota: Connection String Value

Java

Upravte soubor applicationinsights.xml tak, aby změnil výchozí adresu koncového bodu:

<?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 Upravte soubor a přidejte:

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

Koncové body je možné nakonfigurovat také prostřednictvím proměnných prostředí:

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

JavaScript

Aktuální fragment kódu uvedený tady je verze 5. Verze je kódována v fragmentu kódu jako sv:"#". Aktuální verze je dostupná také na GitHubu.

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

Poznámka:

Kvůli čitelnosti a omezení možných chyb JavaScriptu jsou všechny možné možnosti konfigurace uvedené na novém řádku v předchozím kódu fragmentu kódu. Pokud nechcete změnit hodnotu okomentovaného řádku, můžete ji odebrat.

Python

Pokyny k úpravě koncového bodu příjmu pro sadu opencensus-python SDK najdete v úložišti opencensus-python.

Oblasti, které vyžadují změnu koncového bodu

Jedinými oblastmi, které vyžadují úpravy koncových bodů, jsou v současné době Azure Government a Azure China.

Oblast	Název koncového bodu	Hodnota
Azure (Čína)	Kanál telemetrie	https://dc.applicationinsights.azure.cn/v2/track
Azure (Čína)	QuickPulse (živé metriky)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure (Čína)	Dotaz profilu	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Kanál telemetrie	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (živé metriky)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Dotaz profilu	https://dc.applicationinsights.us/api/profiles/{0}/appId

Pokud aktuálně používáte rozhraní REST API služby Application Insights, ke kterému se obvykle přistupuje, api.applicationinsights.iomusíte použít koncový bod, který je místní pro vaši oblast.

Oblast	Název koncového bodu	Hodnota
Azure (Čína)	REST API	api.applicationinsights.azure.cn
Azure Government	REST API	api.applicationinsights.us

Další kroky

• Použijte diagnostické vyhledávání.
• Prozkoumejte metriky.
• Psaní dotazů Log Analytics
• Další informace o vlastních úpravách pro Azure Government najdete v podrobných doprovodných materiálech pro monitorování a správu Azure.
• Další informace o Azure China najdete v playbooku Azure China.