Tworzenie zasobu usługi Application Insights

Uwaga

Ten artykuł dotyczy klasycznych zasobów usługi Application Insights, które nie są już zalecane.

Informacje zawarte w tym artykule są nieaktualne i nie zostaną zaktualizowane.

Przejście do usługi Application Insights opartej na obszarze roboczym w celu skorzystania z nowych funkcji.

Usługa Application Insights wyświetla dane dotyczące aplikacji w zasobie platformy Azure. Tworzenie nowego zasobu jest częścią konfigurowania usługi Application Insights w celu monitorowania nowej aplikacji. Po utworzeniu nowego zasobu możesz pobrać jego klucz instrumentacji i użyć go do skonfigurowania zestawu SDK usługi Application Insights. Klucz instrumentacji łączy dane telemetryczne z zasobem.

Ważne

29 lutego 2024 r. zakończy się obsługa klasycznej usługi Application Insights. Przejście do usługi Application Insights opartej na obszarze roboczym w celu skorzystania z nowych funkcji. Nowsze regiony wprowadzone po lutym 2021 r. nie obsługują tworzenia klasycznych zasobów usługi Application Insights.

Uwaga

31 marca 2025 r. zostanie zakończone świadczenie pomocy technicznej dla pozyskiwania klucza instrumentacji. Pozyskiwanie klucza instrumentacji będzie nadal działać, ale nie udostępnimy już aktualizacji ani obsługi funkcji. Przejście do parametry połączenia w celu skorzystania z nowych funkcji.

Logowanie się do platformy Azure

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Tworzenie zasobu usługi Application Insights

Zaloguj się do witryny Azure Portal i utwórz zasób usługi Application Insights.

Ustawienia	Wartość	Opis
Nazwa/nazwisko	Unique value	Nazwa identyfikującą monitorowaną aplikację.
Grupa zasobów:	myResourceGroup	Nazwa nowej lub istniejącej grupy zasobów do hostowania danych usługi Application Insights.
Region	East US	Wybierz lokalizację w pobliżu lub w pobliżu miejsca, w którym jest hostowana aplikacja.
Tryb zasobu	Classic lub Workspace-based	Zasoby oparte na obszarze roboczym umożliwiają wysyłanie danych telemetrycznych usługi Application Insights do wspólnego obszaru roboczego usługi Log Analytics. Aby uzyskać więcej informacji, zobacz Zasoby usługi Application Insights oparte na obszarze roboczym.

Uwaga

Możesz użyć tej samej nazwy zasobu w różnych grupach zasobów, ale korzystne może być użycie globalnie unikatowej nazwy. Jeśli planujesz wykonywać zapytania obejmujące wiele zasobów, użycie globalnie unikatowej nazwy upraszcza wymaganą składnię.

Wprowadź odpowiednie wartości w wymaganych polach. Wybierz pozycję Przejrzyj i utwórz.

Po utworzeniu aplikacji w nowym okienku zostaną wyświetlone dane wydajności i użycia dotyczące monitorowanej aplikacji.

Kopiowanie klucza instrumentacji

Klucz instrumentacji identyfikuje zasób, który chcesz skojarzyć z danymi telemetrycznymi. Musisz skopiować klucz instrumentacji i dodać go do kodu aplikacji.

Instalowanie zestawu SDK w aplikacji

Zainstaluj zestaw SDK usługi Application Insights w aplikacji. Ten krok zależy w dużym stopniu od typu aplikacji.

Użyj klucza instrumentacji, aby skonfigurować zestaw SDK instalowany w aplikacji.

Zestaw SDK zawiera standardowe moduły, które wysyłają dane telemetryczne, więc nie trzeba pisać więcej kodu. Aby śledzić akcje użytkownika lub diagnozować problemy bardziej szczegółowo, użyj interfejsu API do wysyłania własnych danych telemetrycznych.

Automatyczne tworzenie zasobu

Użyj programu PowerShell lub interfejsu wiersza polecenia platformy Azure, aby automatycznie utworzyć zasób.

PowerShell

Utwórz nowy zasób usługi Application Insights.

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

Przykład

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

Wyniki

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}

Aby uzyskać pełną dokumentację programu PowerShell dotyczącą tego polecenia cmdlet i dowiedzieć się, jak pobrać klucz instrumentacji, zobacz dokumentację programu Azure PowerShell.

Interfejs wiersza polecenia platformy Azure (wersja zapoznawcza)

Aby uzyskać dostęp do poleceń interfejsu wiersza polecenia platformy Azure usługi Application Insights w wersji zapoznawczej, należy najpierw uruchomić następujące polecenie:

 az extension add -n application-insights

Jeśli polecenie nie zostanie uruchomione az extension add , zostanie wyświetlony komunikat o błędzie informujący o tym, że: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Uruchom następujące polecenie, aby utworzyć zasób usługi Application Insights:

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

Przykład

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

Wyniki

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

Aby uzyskać pełną dokumentację interfejsu wiersza polecenia platformy Azure dla tego polecenia i dowiedzieć się, jak pobrać klucz instrumentacji, zobacz dokumentację interfejsu wiersza polecenia platformy Azure.

Zastępowanie domyślnych punktów końcowych

Ostrzeżenie

Nie modyfikuj punktów końcowych. Przejście do parametry połączenia w celu uproszczenia konfiguracji i wyeliminowania konieczności modyfikacji punktu końcowego.

Aby wysyłać dane z usługi Application Insights do niektórych regionów, należy zastąpić domyślne adresy punktów końcowych. Każdy zestaw SDK wymaga nieco różnych modyfikacji, z których wszystkie zostały opisane w tym artykule.

Te zmiany wymagają dostosowania przykładowego kodu i zastąpienia wartości symboli zastępczych dla QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Addressi Profile_Query_Endpoint_address rzeczywistymi adresami punktu końcowego dla określonego regionu. Koniec tego artykułu zawiera linki do adresów punktów końcowych dla regionów, w których ta konfiguracja jest wymagana.

Uwaga

31 marca 2025 r. zostanie zakończone świadczenie pomocy technicznej dla pozyskiwania klucza instrumentacji. Pozyskiwanie klucza instrumentacji będzie nadal działać, ale nie udostępnimy już aktualizacji ani obsługi funkcji. Przejście do parametry połączenia w celu skorzystania z nowych funkcji.

---

Zmiany kodu zestawu SDK

.NET

Uwaga

Plik applicationinsights.config jest automatycznie zastępowany za każdym razem, gdy zostanie wykonane uaktualnienie zestawu SDK. Po uaktualnieniu zestawu SDK pamiętaj o ponownym wprowadzeniu wartości punktów końcowych specyficznych dla regionu.

<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

Zmodyfikuj plik appsettings.json w projekcie, aby dostosować główny punkt końcowy:

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

Wartości metryk na żywo i punktu końcowego zapytania profilu można ustawić tylko za pomocą kodu. Aby zastąpić wartości domyślne dla wszystkich wartości punktu końcowego za pomocą kodu, wprowadź następujące zmiany w ConfigureServices metodzie Startup.cs pliku:

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

W przypadku usługi Azure Functions zalecamy użycie parametry połączenia ustawionych w ustawieniach aplikacji funkcji. Aby uzyskać dostęp do ustawień aplikacji dla funkcji z poziomu okienka funkcji, wybierz pozycję Ustawienia> Ustawienia ustawienia aplikacji konfiguracji.>

Nazwa: APPLICATIONINSIGHTS_CONNECTION_STRING
Wartość: Connection String Value

Java

Zmodyfikuj plik applicationinsights.xml, aby zmienić domyślny adres punktu końcowego:

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

Zmodyfikuj application.properties plik i dodaj:

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

Punkty końcowe można również skonfigurować za pomocą zmiennych środowiskowych:

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

JavaScript

Bieżący fragment kodu wymieniony w wersji 5. Wersja jest kodowana we fragmencie kodu jako sv:"#". Bieżąca wersja jest również dostępna w usłudze 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>

Uwaga

Aby uzyskać czytelność i zmniejszyć możliwe błędy języka JavaScript, wszystkie możliwe opcje konfiguracji są wyświetlane w nowym wierszu w poprzednim kodzie fragmentu kodu. Jeśli nie chcesz zmieniać wartości skomentowanego wiersza, można go usunąć.

Python

Aby uzyskać wskazówki dotyczące modyfikowania punktu końcowego pozyskiwania dla zestawu SDK opencensus-python, zapoznaj się z repozytorium opencensus-python.

Regiony wymagające modyfikacji punktu końcowego

Obecnie jedynymi regionami, które wymagają modyfikacji punktów końcowych, są Azure Government i Azure (Chiny).

Region (Region)	Nazwa punktu końcowego	Wartość
Azure Chiny	Kanał telemetrii	https://dc.applicationinsights.azure.cn/v2/track
Azure Chiny	QuickPulse (Metryki na żywo)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure Chiny	Zapytanie dotyczące profilu	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Kanał telemetrii	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (Metryki na żywo)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Zapytanie dotyczące profilu	https://dc.applicationinsights.us/api/profiles/{0}/appId

Jeśli obecnie używasz interfejsu API REST usługi Application Insights, który jest zwykle uzyskiwany za pośrednictwem api.applicationinsights.iousługi , musisz użyć punktu końcowego lokalnego w twoim regionie.

Region (Region)	Nazwa punktu końcowego	Wartość
Azure Chiny	Interfejs API REST	api.applicationinsights.azure.cn
Azure Government	Interfejs API REST	api.applicationinsights.us

Następne kroki

• Użyj wyszukiwania diagnostycznego.
• Eksplorowanie metryk.
• Pisanie zapytań usługi Log Analytics.
• Aby dowiedzieć się więcej o modyfikacjach niestandardowych dla platformy Azure Government, zobacz szczegółowe wskazówki dotyczące monitorowania i zarządzania platformą Azure.
• Aby dowiedzieć się więcej na temat platformy Azure w Chinach, zobacz podręcznik Azure (Chiny).