Application Insights 中的連接字串

2025-05-24

連接字串指定檢測應用程式應該將遙測資料傳送到哪個 Application Insights 資源。連接字串是由多個設定所組成，每個設定都以索引鍵/值組表示，並以分號分隔。這個合併的組態方法可藉由消除多個 Proxy 設定的需求來簡化設定程式。

重要

連接字串包含ikey和ApplicationId。

ikey 是擷取服務用來將遙測與特定 Application Insights 資源產生關聯的唯一標識符。 Ikey 唯一標識碼不是安全性令牌或安全性密鑰，而且不會被視為秘密。 藉由新增ApplicationId值來增強連接字串。此更新是一項新功能，可支援使用開放式遙測 SDK 之案例的自動檢測。如果您想要保護 Application Insights 資源免於誤用，擷取端點會根據 Microsoft Entra ID 提供已驗證的遙測擷取選項。

附註

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

連線字串功能

可靠性：連接字串移除對全域擷取端點的相依性，讓遙測擷取更可靠。
安全性：連接字串使用 Application Insights 的 Microsoft Entra 驗證，可進行經過驗證的遙測擷取。
自訂端點 (主權或混合式雲端環境)：端點設定允許將資料傳送至特定的 Azure Government 區域。 (請參閱範例。)
隱私權 (區域端點)：連接字串可藉由將資料傳送至區域端點來減緩隱私權問題，確保資料不會離開地理區域。

尋找您的連接字串

您的連接字串會出現在 Application Insights 資源的 [概觀] 區段上。

架構

下列各節將說明結構描述元素。

最大長度

連線的最大支援長度為 4,096 個字元。

索引鍵/值組

連接字串由以分號分隔的機碼值組表示的設定清單所組成：key1=value1;key2=value2;key3=value3

秘訣

本文件涵蓋可設定的索引鍵/值組。某些鍵-值組合是無法配置的，且會自動設置，例如 ApplicationId。如果在您的環境中觀察到這些配對，可以安全地忽略。

語法

InstrumentationKey (例如，00000000-0000-0000-0000-000000000000)。 InstrumentationKey 是必要欄位。
Authorization (例如，ikey)。這是選用設定，因為現今我們只支援 ikey 授權。
EndpointSuffix (例如，applicationinsights.azure.cn)。設定端點尾碼是告訴 SDK 要連接到哪個 Azure 雲端。 SDK 會為個別服務組合其餘端點。
明確端點。任何服務都可以在連接字串中明確覆寫：
- IngestionEndpoint (例如 https://dc.applicationinsights.azure.com)
- LiveEndpoint (例如 https://live.applicationinsights.azure.com)
- ProfilerEndpoint (例如 https://profiler.monitor.azure.com)
- SnapshotEndpoint (例如 https://snapshot.monitor.azure.com)

端點結構描述

<prefix>.<suffix>

前置詞： 定義服務。
後置詞：定義常見網域名稱。

有效的後置詞

applicationinsights.azure.cn
applicationinsights.us

如需詳細資訊，請參閱需要修改端點的區域。

有效的前置詞

遙測擷取：dc
即時計量：live
適用於 .NET 的分析工具： profiler
快照: snapshot

連接字串範例

以下是連接字串的一些範例。

具有端點後綴的連接字串

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

在此範例中，連接字串會指定端點尾碼，而 SDK 會建構服務端點：

授權配置預設為「ikey」
儀器金鑰：00000000-0000-0000-0000-000000000000
區域服務統一資源識別碼（URI）是以提供的端點後綴為基礎：
- 擷取：https://dc.ai.contoso.com
- 即時計量： https://live.ai.contoso.com
- 適用於 .NET 的分析工具：https://profiler.ai.contoso.com
- 偵錯工具：https://snapshot.ai.contoso.com

具有明確端點覆寫的連接字串

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;

在此範例中，連接字串會指定每個服務的明確覆寫。 SDK 會使用所提供的確切端點，而不會進行修改：

授權配置預設為「ikey」
儀器金鑰：00000000-0000-0000-0000-000000000000
區域服務 URI 以明確的覆寫值為基礎：
- 擷取：https://custom.com:111/
- 即時計量： https://custom.com:222/
- 適用於 .NET 的分析工具：https://custom.com:333/
- 偵錯工具：https://custom.com:444/

具有明確區域的連接字串

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

在此範例中，連接字串指定美國中南部區域：

授權配置預設為「ikey」
儀器金鑰：00000000-0000-0000-0000-000000000000
區域服務 URI 以明確的覆寫值為基礎：
- 擷取：https://southcentralus.in.applicationinsights.azure.com/

若要列出可用的區域，請在 Azure CLI 中執行下列命令：

az account list-locations -o table

設定連接字串

我們所有的 OpenTelemetry 供應專案和下列 SDK 版本都支援連接字串：

.NET v2.12.0
JavaScript v2.3.0
NodeJS v1.5.0
Python v1.0.0
Java v3.1.1

您可以使用環境變數或組態檔，在程式代碼中設定連接字串。

環境變數

連接字串：APPLICATIONINSIGHTS_CONNECTION_STRING

程式碼範例

語言	經典 API	OpenTelemetry
ASP.NET Core	Application Insights SDK	AzMon OTel Distro
.NET Framework	Application Insights SDK	AzMon 匯出工具
爪哇島	不適用	Java 代理程式
JavaScript	JavaScript (Web) SDK 載入器指令碼	不適用
Node.js	Application Insights SDK	AzMon OTel Distro
Python（程式語言）	OpenCensus Python SDK	AzMon OTel Distro

下一步

若要檢閱常見問題（FAQ）：

Application Insights 常見問題中的連接字串

在執行階段開始使用：

在開發階段開始使用：

共用方式為