Application Insights 中的连接字符串

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

重要

连接字符串包含一个检测密钥（ikey）和 ApplicationId。

ikey 是引入服务用于将遥测与特定 Application Insights 资源关联的唯一标识符。 Ikey 唯一标识符不是安全令牌或安全密钥，也不被视为机密。 若要增强连接字符串，请添加 ApplicationId 值。 此更新是一项新功能，支持自动检测使用 Open Telemetry SDK 的方案。

注意

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

连接字符串功能

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

查找连接字符串

可以在 Application Insights 资源的 概述节中找到连接字符串。

显示 Application Insights 概述和“连接字符串”的截图。

架构

以下部分介绍架构元素。

最大长度

连接最多支持 4,096 个字符。

键值对

连接字符串由以分号分隔的键值对表示的设置列表组成：key1=value1;key2=value2;key3=value3

提示

本文档介绍可配置的键值对。 某些键值对不可配置，并且会自动设置，例如 ApplicationId。 如果在环境中看到这些对，则可以放心忽略。

语法

  • InstrumentationKey（例如 00000000-0000-0000-0000-000000000000）。 InstrumentationKey 是必填字段。

  • Authorization（例如 ikey）。 此设置是可选的，因为目前 SDK 仅支持 ikey 授权。

  • EndpointSuffix（例如 applicationinsights.azure.cn）。 设置终结点后缀会告知 SDK 要连接到哪个Azure云。 SDK 会为各个服务组装端点的其余部分。

  • 显式终结点。 可以显式覆盖连接字符串中的任何服务：

    • IngestionEndpoint（例如 https://dc.applicationinsights.azure.cn）
    • LiveEndpoint（例如 https://live.applicationinsights.azure.cn）
    • ProfilerEndpoint（例如 https://profiler.monitor.azure.cn）
    • SnapshotEndpoint（例如 https://snapshot.monitor.azure.cn）

端点模式

<prefix>.<suffix>

  • 前缀：定义某个服务。
  • 后缀：定义公共域名。

有效后缀

  • Azure 应用见解 (applicationinsights.azure.cn)
  • applicationinsights.us

有关详细信息，请参阅需要修改终结点的区域。

有效的前缀

连接字符串示例

下面是连接字符串的一些示例。

带有终结点后缀的连接字符串

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=applicationinsights.azure.cn;

在此示例中，连接字符串指定由世纪互联管理的Microsoft Azure中的端点后缀，SDK 构建服务端点：

  • 授权方案默认为“ikey”
  • 仪器密钥：00000000-0000-0000-0000-000000000000
  • 提供的终结点后缀构成了区域服务的统一资源标识符 (URI) 的基础：
    • 引入：https://dc.applicationinsights.azure.cn
    • 实时指标：https://live.applicationinsights.azure.cn
    • .NET探查器：https://profiler.applicationinsights.azure.cn
    • 调试程序：https://snapshot.applicationinsights.azure.cn

带有显式终结点重写的连接字符串

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://chinaeast2.in.applicationinsights.azure.cn/

在此示例中，连接字符串指定中国东部 2 区域：

  • 授权方案默认为“ikey”
  • 仪器密钥：00000000-0000-0000-0000-000000000000
  • 区域服务 URI 基于显式重写值：
    • 引入：https://chinaeast2.in.applicationinsights.azure.cn/

若要列出可用区域，请在 Azure CLI 中运行以下命令：

az account list-locations -o table

设置连接字符串

若要了解如何设置连接字符串，请参阅 OpenTelemetry Configuration。

使用连接字符串进行身份验证的浏览器遥测

当组织在 Application Insights 上禁用本地身份验证以强制实施Microsoft Entra ID时，JavaScript SDK 无法直接对基于浏览器的遥测进行身份验证，遥测可能会停止流动。

一种实用模式是通过 Azure API 管理（APIM）路由浏览器遥测，该模式：

  • 使用托管标识向 Application Insights 进行身份验证。
  • 代表您将请求转发到地区数据引入终结点。

通过此设置，您的 连接字符串 将继续标识目标 Application Insights 资源，但 IngestionEndpoint 指向您的 API 管理代理 URL。

有关端到端指南（包括 CORS 和 APIM 策略），请参阅：将 Azure API 管理 作为 Application Insights 遥测的代理。

后续步骤

若要查看常见问题解答（FAQ），请参阅：

在运行时开始使用：

在开发阶段开始使用：

  • Last updated on