你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Application Insights 中的连接字符串

项目
10/30/2024

连接字符串指定被检测的应用程序要将遥测数据发送到哪个 Application Insights 资源。连接字符串由多个设置组成，每个设置以键值对的形式表示并用分号分隔。这种整合的配置方法消除了对多个代理设置的需要，因而简化了设置过程。

重要

连接字符串包含 ikey，后者是引入服务用于将遥测与特定 Application Insights 资源关联的唯一标识符。 Ikey 唯一标识符不是安全令牌或安全密钥，也不被视为机密。

如果你要防止 Application Insights 资源遭到滥用，请使用引入终结点，它提供基于 Microsoft Entra ID 的经身份验证的遥测引入选项。

注意

对检测密钥引入的支持将于 2025 年 3 月 31 日结束。检测密钥引入功能将会继续工作，但我们将不再为该功能提供更新或支持。转换为连接字符串，以利用新功能。

连接字符串功能

可靠性：连接字符串通过删除全局引入终结点上的依赖项提高遥测引入的可靠性。
安全性：连接字符串允许通过使用 Application Insights 的 Microsoft Entra 身份验证引入经过身份验证的遥测。
自定义终结点（主权或混合云环境）：终结点设置允许将数据发送到特定的 Azure 政府区域。（请参阅示例。）
隐私（区域终结点）：连接字符串通过将数据发送到区域终结点来解决隐私问题，从而确保数据不会离开某一地理区域。

查找连接字符串

连接字符串显示在 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
探查器：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
- 探查器：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/
- 探查器：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

可以使用环境变量或配置文件在代码中设置连接字符串。

环境变量

连接字符串：APPLICATIONINSIGHTS_CONNECTION_STRING

代码示例

语言	经典 API	OpenTelemetry
ASP.NET Core	Application Insights SDK	AzMon OTel Distro
.NET Framework	Application Insights SDK	AzMon Exporter
Java	空值	Java 代理
JavaScript	JavaScript (Web) SDK 加载程序脚本	空值
Node.js	Application Insights SDK	AzMon OTel Distro
Python	OpenCensus Python SDK	AzMon OTel Distro

常见问题解答

本部分提供常见问题的解答。

新的 Azure 区域是否需要使用连接字符串？

新的 Azure 区域要求使用连接字符串而不是检测密钥。连接字符串会标识出要与遥测数据相关联的资源。它还允许你修改可供你的资源将其用作遥测目标的终结点。复制连接字符串，并将其添加到应用程序的代码或添加到环境变量中。

是否应该使用连接字符串或检测密钥？

建议使用连接字符串，而不是检测密钥。

后续步骤

在运行时开始使用：

在开发时开始使用：

通过