Tworzenie zasobu usługi Application Insights

Przestroga

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 możliwości.

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 uzyskać 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 możliwości. 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 parametrów połączenia w celu skorzystania z nowych możliwości.

Logowanie 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 Azure Portal i utwórz zasób usługi Application Insights.

Ustawienia	Wartość	Opis
Nazwa	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 Ciebie 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 może być korzystne użycie globalnie unikatowej nazwy. Jeśli planujesz wykonywanie zapytań obejmujących 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 nowe okienko wyświetla dane dotyczące wydajności i użycia monitorowanej aplikacji.

Kopiowanie klucza instrumentacji

Klucz instrumentacji identyfikuje zasób, który chcesz skojarzyć z danymi telemetrii. 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 dokładniej śledzić akcje użytkownika lub diagnozować problemy, 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ę Azure PowerShell.

Interfejs wiersza polecenia platformy Azure (wersja zapoznawcza)

Aby uzyskać dostęp do podglądu poleceń interfejsu wiersza polecenia platformy Azure usługi Application Insights, 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 parametrów 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 końcowe. 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_Addressoraz Profile_Query_Endpoint_address rzeczywistymi adresami punktu końcowego dla określonego regionu. Na końcu tego artykułu znajdują się 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 parametrów połączenia w celu skorzystania z nowych możliwości.

---

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 należy ponownie wprowadzić wartości punktu końcowego specyficzne 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 Startup.cs za pomocą kodu, wprowadź następujące zmiany w ConfigureServices metodzie 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 Azure Functions zalecamy użycie parametrów połączenia ustawionych w ustawieniach aplikacji funkcji. Aby uzyskać dostęp do ustawień aplikacji dla funkcji w okienku funkcji, wybierz pozycję Ustawienia ustawienia>aplikacjikonfiguracji>.

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 zakodowana w 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 wiersza komentarza, 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 punktu końcowego, są Azure Government i Azure —Chiny.

Region (Region)	Nazwa punktu końcowego	Wartość
Azure China	Kanał telemetrii	https://dc.applicationinsights.azure.cn/v2/track
Azure China	QuickPulse (Metryki na żywo)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure China	Zapytanie 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 profilu	https://dc.applicationinsights.us/api/profiles/{0}/appId

Jeśli obecnie używasz interfejsu API REST usługi Application Insights, do którego zwykle uzyskuje się dostęp za pośrednictwem api.applicationinsights.iousługi , musisz użyć punktu końcowego, który jest lokalny w twoim regionie.

Region (Region)	Nazwa punktu końcowego	Wartość
Azure China	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 na temat niestandardowych modyfikacji 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.