建立 Application Insights 資源

文章
02/28/2023

警告

本文適用於不再建議使用的 Application Insights 傳統資源。

本文中的資訊已過時，且將不會更新。

Application Insights 會在 Azure 資源中顯示您應用程式的相關資料。建立新的資源是屬於設定 Application Insights 以監視新應用程式的一環。建立新資源之後，您會取得其檢測金鑰，並將該金鑰用來設定 Application Insights SDK。此檢測金鑰會將您的遙測連結至資源。

重要

在 2024 年 2 月 29 日，傳統 Application Insights 的支援將會結束。轉換為工作區型的 Application Insights，以充分利用新功能。 2021 年 2 月之後引進的較新區域不支援建立傳統型 Application Insights 資源。

注意

針對檢測金鑰擷取的支援將在 2025 年 3 月 31 日結束。檢測金鑰擷取將會繼續運作，但我們不再提供該功能的更新或支援。轉換至連接字串以利用新功能。

如尚未擁有 Azure 訂用帳戶，請在開始之前先建立免費帳戶。

建立 Application Insights 資源

登入 Azure 入口網站，並建立 Application Insights 資源。

此螢幕快照顯示選取左上角的 [+ 登入]、[開發人員工具] 和 [Application Insights]。

設定	值	描述
名稱	`Unique value`	用來識別您所監視之應用程式的名稱。
資源群組	`myResourceGroup`	用於裝載 Application Insights 資料之新的或現有的資源群組名稱。
區域	`East US`	選取您附近或接近應用程式裝載位置的地點。
資源模式	`Classic` 或 `Workspace-based`	工作區形式資源可讓您將 Application Insights 遙測傳送至通用 Log Analytics 工作區。如需詳細資訊，請參閱工作區型 Application Insights 資源。

注意

您可以跨不同的資源群組使用相同的資源名稱，但是使用全域唯一名稱會很有幫助。如果您打算執行跨資源查詢，使用全域唯一名稱可簡化必要的語法。

在必要欄位中輸入適當的值。選取 [檢閱 + 建立]。

此螢幕快照顯示輸入必要欄位中的值，以及 [檢閱 + 建立] 按鈕。

建立應用程式之後，新的窗格會顯示受監視應用程式的效能和使用方式資料。

複製檢測金鑰

檢測金鑰可識別您想要與遙測資料建立相關聯的資源。您必須複製檢測金鑰，並將其新增至應用程式的程式碼。

在應用程式中安裝 SDK

在應用程式中安裝 Application Insights SDK 核心。此步驟高度仰賴於應用程式的類型。

使用檢測金鑰來設定您在應用程式中安裝的 SDK。

SDK 包含傳送遙測的標準模組，因此您不必再撰寫任何程序碼。若要更詳細追蹤使用者動作或診斷問題，請使用 API 來傳送您自己的遙測。

自動建立資源

使用 PowerShell 或 Azure CLI 自動建立資源。

PowerShell

建立新 Application Insights 資源。

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

範例

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

結果

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}

如需此 Cmdlet 的完整 PowerShell 文件，並了解如何擷取檢測金鑰，請參閱 Azure PowerShell 文件。

Azure CLI (預覽)

若要存取預覽 Application Insights Azure CLI 命令，您必須先執行：

 az extension add -n application-insights

如果您未執行 az extension add 命令，則會看到錯誤訊息，指出：az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

執行下列命令以建立您的 Application Insights 資源：

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

範例

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

結果

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

如需此命令的完整 Azure CLI 文件，並了解如何擷取檢測金鑰，請參閱 Azure CLI 文件。

覆寫預設端點

警告

請勿修改端點。轉換至連接字串以簡化設定，而且不需要修改端點。

若要將資料從 Application Insights 傳送至特定區域，您必須覆寫預設端點位址。每個 SDK 都需要稍微不同的修改，本文章會說明全部修改。

這些變更需要您調整範例程式碼，並以特定區域的實際端點位址取代 QuickPulse_Endpoint_Address、TelemetryChannel_Endpoint_Address 和 Profile_Query_Endpoint_address 的預留位置值。本文章結尾包含需要此設定的區域本身的端點位址連結。

注意

SDK 程式碼變更

注意

每次執行 SDK 升級時，會自動覆寫 applicationinsights.config 檔案。在您執行 SDK 升級之後，請務必重新輸入區域特定的端點值。

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

修改專案中的 appsettings.json 檔案，以調整主要端點：

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

即時計量和設定檔查詢端點的值只能透過程式碼設定。若要透過程式碼覆寫全部端點值的預設值，請在 Startup.cs 檔案的 ConfigureServices 方法中進行下列變更：

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

修改 applicationinsights.xml 檔案以變更預設端點位址：

<?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 並新增：

azure.application-insights.channel.in-process.endpoint-address= TelemetryChannel_Endpoint_Address

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

您也可以透過環境變數來設定端點：

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

此處列出的程式碼片段為版本 5。版本會在程式碼片段中編碼為 sv:"#"。目前的版本也可在 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>

注意

為提高可讀性並減少可能的 JavaScript 錯誤，在上述程式碼片段中，所有可能的設定都會在新行中列出。如果您不想變更加註行的值，可以將其移除。

需要端點修改的區域

目前需要修改端點的區域只有 Azure Government 和 Azure 中國。

區域	端點名稱	值
Azure 中國	遙測通道	`https://dc.applicationinsights.azure.cn/v2/track`
Azure 中國	QuickPulse (即時計量)	`https://live.applicationinsights.azure.cn/QuickPulseService.svc`
Azure 中國	設定檔查詢	`https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId`
Azure Government	遙測通道	`https://dc.applicationinsights.us/v2/track`
Azure Government	QuickPulse (即時計量)	`https://quickpulse.applicationinsights.us/QuickPulseService.svc`
Azure Government	設定檔查詢	`https://dc.applicationinsights.us/api/profiles/{0}/appId`

如果您目前使用 Application Insights REST API，通常會透過 api.applicationinsights.io 存取，您必須使用區域的端點。

區域	端點名稱	值
Azure 中國	REST API	`api.applicationinsights.azure.cn`
Azure Government	REST API	`api.applicationinsights.us`

下一步

使用診斷搜尋。
探索計量。
撰寫 Log Analytics 查詢。
若要深入了解 Azure Government 的自訂修改，請參閱 Azure 監視和管理的詳細指導。
若要深入了解 Azure 中國，請參閱 Azure 中國劇本。

分享方式：

建立 Application Insights 資源

建立 Application Insights 資源

複製檢測金鑰

在應用程式中安裝 SDK

自動建立資源

PowerShell

範例

結果

Azure CLI (預覽)

範例

結果

覆寫預設端點

SDK 程式碼變更

Spring Boot

需要端點修改的區域

下一步

更多資源