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

遥测上下文:Application Insights 数据模型

每个遥测项可能都有一个强类型化上下文字段。 每个字段均会启用特定监视方案。 使用自定义属性集合存储自定义或特定于应用程序的上下文信息。

应用程序版本

应用程序上下文字段中的信息总是与发送遥测的应用程序有关。 应用程序版本用于分析应用程序行为的趋势变化及其与部署的关联。

最大长度:1,024

客户端 IP 地址

此字段是客户端设备的 IP 地址。 支持 IPV4 和 IPV6。 从服务发送遥测时,位置上下文与在服务中启用操作的用户有关。 Application Insights 从客户端 IP 中提取地理位置信息,然后将其截断。 无法将客户端 IP 本身用作用户的可识别信息。

最大长度:46

设备类型

最初,该字段用于指示应用程序的用户使用的设备类型。 现在,其主要用于区分设备类型为 Browser 的 JavaScript 遥测与设备类型为 PC 的服务器端遥测。

最大长度:64

Operation ID

此字段是根操作的唯一标识符。 此标识符允许跨多个组件对遥测分组。 有关详细信息,请参阅遥测关联。 操作 ID 由请求或页面视图创建。 其他所有遥测将此字段设置为包含请求或页面视图的值。

最大长度:128

父操作 ID

此字段是遥测项的直接父级的唯一标识符。 有关详细信息,请参阅遥测关联

最大长度:128

操作名称

此字段是操作的的名称(组)。 操作名称由请求或页面视图创建。 其他所有遥测项将此字段设置为包含请求或页面视图的值。 操作名称用于查找一组操作的所有遥测项(例如,GET Home/Index)。 此上下文属性用于回答“此页面的典型异常有哪些?”等问题。

最大长度:1,024

操作的综合源

此字段是合成源的名称。 来自应用程序的一些遥测可能代表综合流量。 可能是索引网站的 Web 爬网程序、站点可用性测试或来自诊断库(如 Application Insights SDK 本身)的跟踪。

最大长度:1,024

会话 ID

会话 ID 是用户与应用交互的实例。 会话上下文字段中的信息总是与用户有关。 从服务发送遥测时,会话上下文与在服务中启用操作的用户有关。

最大长度:64

匿名用户 ID

匿名用户 ID (User.Id) 代表应用程序的用户。 从服务发送遥测时,用户上下文与在服务中启用操作的用户有关。

采样是最小化遥测收集量的一种技术。 采样算法尝试在所有相关遥测内部或外部采样。 匿名用户 ID 用于采样分数生成,因此匿名用户 ID 应该是一个足够随机的值。

注意

匿名用户 ID 的计数与唯一应用程序用户的数量不同。 匿名用户 ID 的计数通常更高,因为每当用户在不同的设备或浏览器中打开你的应用时或清理浏览器 Cookie 时,都会分配一个新的唯一匿名用户 ID。 此计算可能会导致多次统计相同的实际用户。

用户 ID 可以与会话 ID 交叉进行引用,以提供唯一的遥测维度,并在会话持续时间内建立用户活动。

使用匿名用户 ID 存储用户名是字段误用。 使用已经过身份验证的用户 ID。

最大长度:128

已经过身份验证的用户 ID

经过身份验证的用户 ID 与匿名用户 ID 相反。 此字段表示具有易记名称的用户。 默认情况下,仅使用 ASP.NET Framework SDK 的 AuthenticatedUserIdTelemetryInitializer 收集此 ID。

使用 Application Insights SDK 初始化经过身份验证的用户 ID,该 ID 具有跨浏览器和设备永久标识用户的值。 通过这种方式,所有遥测项都归属于该唯一 ID。 使用此 ID 可以查询针对特定用户收集的所有遥测数据(根据采样配置遥测数据筛选)。

用户 ID 可以与会话 ID 交叉进行引用,以提供唯一的遥测维度,并在会话持续时间内建立用户活动。

最大长度:1,024

帐户 ID

在多租户应用程序中,帐户 ID 是用户使用的租户帐户 ID 或名称。 当用户 ID 和已经过身份验证的用户 ID 不足时,它用于进一步的用户细分。 例如,Azure 门户的订阅 ID 或博客平台的博客名称。

最大长度:1,024

云角色

此字段是应用程序所属的角色的名称。 它直接映射到 Azure 中的角色名称。 也可用于区分单个应用程序包含的微服务。

最大长度:256

云角色实例

此字段是正在运行应用程序的实例的名称。 例如,它是本地的计算机名称或 Azure 的实例名称。

最大长度:256

内部:SDK 版本

有关详细信息,请参阅此 SDK 版本一文

最大长度:64

内部:节点名称

此字段表示用于计费的节点名称。 使用该字段替代节点的标准检测。

最大长度:256

后续步骤