建立 Application Insights 資源

警告

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

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

轉換為工作區型的 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

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

建立 Application Insights 資源

登入 Azure 入口網站，並建立 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 的預留位置值。 本文章結尾包含需要此設定的區域本身的端點位址連結。

注意

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

---

SDK 程式碼變更

.NET

注意

每次執行 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>

.NET Core

修改專案中的 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

Azure Functions

針對 Azure Functions，建議使用函數應用程式設定中設定的連接字串。 若要從函式窗格內存取函式的應用程式設定，請選取 [設定]>[設定]>[應用程式設定]。

名稱：APPLICATIONINSIGHTS_CONNECTION_STRING
值：Connection String Value

Java

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

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

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

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

JavaScript

此處列出的程式碼片段為版本 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 錯誤，在上述程式碼片段中，所有可能的設定都會在新行中列出。 如果您不想變更加註行的值，可以將其移除。

Python

如需修改 opencensus-python SDK 擷取端點的指導，請參閱 opencensus-python 存放庫。

需要端點修改的區域

目前需要修改端點的區域只有 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 中國劇本。