Vytvořte prostředek 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ím prostoru , abyste mohli využívat nové možnosti.

Application Insights zobrazí 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íč prováže telemetrii s prostředkem.

Důležité

29. února 2024skončí podpora klasické služby Application Insights. Přechod na Application Insights založený na pracovním prostoru , abyste mohli využívat nové možnosti. 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 dat instrumentačního klíče bude dál fungovat, ale už nebudeme pro tuto funkci poskytovat aktualizace ani podporu. Přejděte na připojovací řetězce , abyste mohli využívat nové možnosti.

Přihlášení k Azure

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.

Vytvořte prostředek Application Insights

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

Nastavení	Hodnota	Popis
Název	Unique value	Název identifikující 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í ve vaší blízkosti nebo blízko místa, kde je vaše aplikace hostovaná.
Režim prostředku	Classic nebo Workspace-based	Prostředky založené na pracovním prostoru umožňují odesílat telemetrii Application Insights do běžného pracovního prostoru služby Log Analytics. Další informace najdete v tématu Prostředky Application Insights založené na pracovním prostoru.

Poznámka

Můžete použít stejný název prostředku napříč různými skupinami prostředků, ale může být výhodné použít globálně jedinečný název. Pokud plánujete provádět dotazy mezi 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í instrumentačního klíče

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

Instalace sady SDK do aplikace

Nainstalujte do aplikace sadu Application Insights SDK. Tento krok do značné míry závisí na typu vaší aplikace.

Pomocí instrumentačního klíče nakonfigurujte sadu SDK, kterou nainstalujete do aplikace.

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 odesílá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 tom, jak načíst instrumentační klíč, najdete v dokumentaci k Azure PowerShell.

Azure CLI (Preview)

Pokud chcete získat přístup k příkazům Rozhraní příkazového řádku Azure CLI pro Application Insights ve verzi Preview, musíte nejprve spustit:

 az extension add -n application-insights

Pokud příkaz nespusíte az extension add , zobrazí se chybová zpráva s oznámením: 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 tom, jak načíst instrumentační klíč, najdete v dokumentaci k Azure CLI.

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

Upozornění

Neupravujte koncové body. Přechod na připojovací řetězce za účelem zjednodušení konfigurace a eliminace nutnosti ú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 trochu jiné úpravy, které jsou popsány v tomto článku.

Tyto změny vyžadují, abyste upravili ukázkový 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. Konec tohoto článku obsahuje odkazy na adresy koncových bodů pro oblasti, ve kterých se tato konfigurace vyžaduje.

Poznámka

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

---

Změny kódu sady SDK

.NET

Poznámka

Soubor applicationinsights.config se automaticky přepíše pokaždé, když se provede upgrade sady SDK. Po upgradu sady SDK nezapomeňte znovu zadat hodnoty koncového bodu pro konkrétní 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 v projektu soubor appsettings.json a upravte hlavní koncový bod:

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

Hodnoty live metrics a koncového bodu dotazu na profil je možné nastavit pouze prostřednictvím kódu. Pokud chcete přepsat výchozí hodnoty všech hodnot 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ězce nastavené v nastavení aplikace funkce. Pokud chcete získat přístup k nastavení aplikace pro svoji funkci z podokna funkcí, vyberte Nastavení>Konfigurace Nastavení>Nastavení Aplikace.

Název: APPLICATIONINSIGHTS_CONNECTION_STRING
Hodnota: Connection String Value

Java

Upravte souborapplicationinsights.xml tak, aby se změnila adresa výchozího 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 také možné konfigurovat 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, který je tady uvedený, je verze 5. Verze se ve fragmentu kódu zakóduje jako sv:"#". Aktuální verze je k dispozici 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 řádku s komentářem, můžete ho odebrat.

Python

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

Oblasti, které vyžadují úpravu koncového bodu

V současné době jsou jedinými oblastmi, které vyžadují úpravy koncových bodů, 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 (Live Metrics)	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 (Live Metrics)	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 běžně přistupuje přes api.applicationinsights.io, musí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 pokynech k monitorování a správě Azure.
• Další informace o Azure China najdete v playbooku Azure China.