Application Insights 将遥测数据从 Web 应用程序发送到 Azure 门户，以便深入了解应用程序和基础结构的性能和使用情况。 为了帮助你更好地了解和组织遥测数据，我们将它分类为不同的类型。
遥测数据模型是标准化的，因此可以创建独立于平台和语言的监视。 我们将努力保持该模型的精简结构，以便支持基本方案，并让用户根据高级用途扩展架构。
Application Insights 收集的数据可建模此典型的应用程序执行模式：
默认情况下，1availabilityResults 不可用，需要设置可用性测试。
2customEvents 和 customMetrics 仅适用于自定义检测。
注意
Application Insights 出于旧原因将 traces 日志存储在表中。
分布式跟踪的跨度存储在requests和dependencies两个表中。 我们计划在将来的版本中解决此问题，以避免任何混淆。
遥测类型
以下类型的遥测用于监视应用程序的执行。 Azure Monitor OpenTelemetry 发行版和 Application Insights JavaScript SDK 收集：
| 遥测类型 | 表名称 （Application Insights） |
表名称 （日志分析） |
说明 |
|---|---|---|---|
| 可用性 | availabilityResults |
AppAvailabilityResults |
定期发送 Web 请求，并在应用程序未响应或响应时间过慢时发出警报，从而监视应用程序的可用性和响应能力。 |
| 浏览器计时 | browserTimings |
AppBrowserTimings |
测量网页的性能，包括页面加载时间和网络持续时间。 |
| 依赖项 | dependencies |
AppDependencies |
跟踪从应用程序到外部服务或存储（例如 REST API 或 SQL 数据库）的调用，并测量这些调用的持续时间和成功。 |
| 事件 | customEvents |
AppEvents |
通常用于捕获应用程序中的用户交互和其他重大事件，例如按钮单击或订单结帐，以分析使用模式。 |
| 例外 | exceptions |
AppExceptions |
捕获对故障排除和理解失败至关重要的错误信息。 |
| 指标 | performanceCounterscustomMetrics |
AppPerformanceCountersAppMetrics |
性能计数器提供有关应用程序和系统性能的各个方面（例如 CPU 使用率和内存消耗）的数字数据。 此外，自定义指标允许你定义和跟踪应用程序特有的特定度量值，从而灵活地监视自定义性能指标。 |
| 页面视图 | pageViews |
AppPageViews |
跟踪用户查看的页面，从而深入了解应用程序中的用户导航和参与度。 |
| 请求 | requests |
AppRequests |
记录应用程序收到的请求，并提供作 ID、持续时间和成功或失败状态等详细信息。 |
| 跟踪 | traces |
AppTraces |
记录应用程序特定的事件，例如自定义诊断消息或跟踪语句，这些事件可用于一段时间内调试和监视应用程序行为。 |
重要
可以从 Application Insights 和 Log Analytics （建议）查询应用程序遥测数据，但表和字段名称在两者之间有所不同。 这种区别保留了向后兼容性，例如，为了确保在 Log Analytics 命名约定之前创建的具有自定义查询的客户仪表板继续正常运行。
每个遥测项可以包含 上下文信息 ，例如应用程序版本或用户会话 ID。 上下文由一组强类型字段组成，这些字段支持不同的分析方案。
例如，正确初始化应用程序版本时，Application Insights 可以在与重新部署相关的应用程序行为中检测新模式。 同样，可以使用会话 ID 来评估服务中断或问题对用户的影响。 通过计算与失败依赖项、错误跟踪或严重异常关联的唯一会话 ID 数，可以更清楚地了解用户影响。
Application Insights 遥测模型还支持将遥测项关联到它们所属的操作。 例如，如果请求触发 SQL 数据库调用，则请求和依赖项调用都可以包含诊断数据，并通过共享关联上下文进行链接，从而跟踪作的完整流。
本文介绍特定于每个遥测类型的字段。 若要查看任何遥测类型可用字段（包括上下文字段）的完整列表，请遵循每个相关表下提供的链接。
可用性遥测
可用性遥测涉及综合监视，其中测试模拟用户交互，以验证应用程序是否可用且响应迅速。 我们建议设置 标准可用性测试 ，以监视全球各个点的应用程序的可用性，并将自己的测试信息发送到 Application Insights。
可用性特定字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
id |
Id |
可用性测试结果的唯一标识符，用于各个测试执行之间的关联，这有助于跟踪一段时间内的特定失败或模式。 有关详细信息，请参阅 Application Insights 中的遥测关联。 |
name |
Name |
可用性测试的名称。 创建测试时定义它（例如“主页 ping 测试”）。 |
location |
Location |
执行可用性测试的地理位置或数据中心区域（例如中国北部 3）。 它有助于确定区域中断或延迟问题。 |
success |
Success |
此字段指示可用性测试是否成功。 它是一个布尔值，表示 true 测试成功， false 表示测试失败。 |
message |
Message |
描述性消息，其中包含有关测试结果的详细信息。 它通常包含异常详细信息或错误响应。 |
duration |
Duration |
执行可用性测试所花费的时间。 它有助于测量性能并确定响应时间问题。 持续时间通常以毫秒为单位。 |
有关所有可用字段的列表，请参阅 AppAvailabilityResults。
浏览器计时遥测
浏览器使用 性能 API 公开页面加载作的度量值。 Application Insights 通过将相关计时合并到 标准浏览器指标中来简化这些度量。
特定于浏览器计时的字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
networkDuration |
NetworkDurationMs |
客户端联系 DNS 来解析网站主机名，DNS 使用 IP 地址进行响应。 客户端创建 TCP，然后与 Web 服务器进行 TLS 握手。 |
sendDuration |
SendDurationMs |
客户端发送请求有效负载，等待服务器执行请求，并接收第一个响应数据包。 |
receiveDuration |
ReceiveDurationMs |
客户端从 Web 服务器接收响应有效负载字节的其余部分。 |
processingDuration |
ProcessingDurationMs |
客户端现在已经得到了完整的响应数据包，必须将内容渲染到浏览器中并加载 DOM。 |
totalDuration |
TotalDurationMs |
所有浏览器时间的总和。 |
有关所有可用字段的列表，请参阅 AppBrowserTimings。
依赖项遥测
依赖项遥测项表示受监视组件与远程组件（如 SQL 或 HTTP 终结点）的交互。
特定于依赖项的字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
id |
Id |
依赖项调用实例的唯一标识符，用于与与此依赖项调用相对应的请求遥测项关联。 有关详细信息，请参阅 Application Insights 中的遥测关联。 |
target |
Target |
依赖项调用的目标站点。 示例包括服务器名称和主机地址。 有关详细信息，请参阅 Application Insights 中的遥测关联。 |
type |
DependencyType |
依赖项类型名称。 低基数值，用于对依赖项进行逻辑分组和解释 commandName 和 resultCode 等其他字段。 示例包括 SQL、Azure 表和 HTTP。 |
name |
Name |
使用此依赖项调用启动的命令的名称。 它的基数值低。 示例包括存储过程名称和 URL 路径模板。 |
data |
Data |
此依赖项调用启动的命令。 示例包括使用所有查询参数的 SQL 语句和 HTTP URL。 |
success |
Success |
此字段指示调用是否成功。 它是一个布尔值，表示 true 调用成功，表示 false 调用失败。 |
resultCode |
ResultCode |
依赖项调用的结果代码。 示例包括 SQL 错误代码和 HTTP 状态代码。 |
duration |
DurationMs |
请求持续时间的格式为 DD.HH:MM:SS.MMMMMM。 此值必须小于 1000 天。 |
有关所有可用字段的列表，请参阅 AppDependencies。
事件遥测
可以创建事件遥测项来表示应用程序中发生的事件。 通常它是用户交互，如按钮单击或订单结账。 它还可以是应用程序生命周期事件，如初始化或配置更新。
若要详细了解如何创建自定义事件遥测，请参阅 添加和修改适用于 .NET、Java、Node.js和 Python 应用程序的 Azure Monitor OpenTelemetry。
特定于事件的字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
name |
Name |
若要允许适当的分组和有用的指标，请限制应用程序，以便它生成几个单独的事件名称。 例如，不要为事件中每个生成的实例使用单独的名称。 |
有关所有可用字段的列表，请参阅 AppEvents。
异常遥测
异常遥测项表示在执行受监视的应用程序期间发生的已处理或未经处理的异常。
异常特定的字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
problemId |
ProblemId |
标识在代码中引发异常的位置。 它用于对异常进行分组。 通常为异常类型和调用堆栈中某个函数的组合。 |
type |
ExceptionType |
发生的特定异常类型。 这通常包括命名空间和类名，例如 System.NullReferenceException 或 System.InvalidOperationException。 |
assembly |
Assembly |
引发异常的程序集。 这对于查明负责异常的应用程序组件非常有用。 |
method |
Method |
引发异常的程序集中的方法名称。 这会提供有关代码中发生错误的位置的上下文信息。 |
outerType |
OuterType |
如果当前异常嵌套在另一个异常中，则外部（包装）异常的类型。 这对于了解发生内部异常的上下文非常有用，有助于跟踪错误序列。 |
outerMessage |
OuterMessage |
此消息提供对外部异常的可读解释，有助于了解更广泛的问题。 |
outerAssembly |
OuterAssembly |
外部异常产生的程序集。 |
outerMethod |
OuterMethod |
外部异常的方法。 这会提供有关外部异常中故障点的详细信息。 |
severityLevel |
SeverityLevel |
跟踪严重性级别可以是以下值之一：Verbose、、Information、WarningError或Critical。 |
details |
Details |
包含异常信息，例如异常消息和调用堆栈。 |
有关所有可用字段的列表，请参阅 AppExceptions。
指标遥测
Application Insights 支持两种类型的指标遥测：
- 单个度量具有名称和值。
- 预先聚合的指标在 1 分钟的聚合周期内采用多个度量值。
性能计数器
性能计数器始终是包含name和value的单个测量指标，同时还附带其他字段category、counter，以及适用于Windows应用程序的instance。
特定于性能计数器的字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
name |
Name |
要在 Application Insights 门户中看到的指标的名称。 |
value |
Value |
用于度量的单个值。 它是要聚合的各个度量值的总和。 |
category |
Category |
表示一组相关的性能计数器（例如 Process）。 |
counter |
Counter |
指定在类别中度量的特定性能指标（例如， IO Data Bytes/sec）。 |
instance |
Instance |
标识类别中计数器的特定实例（例如 ??APP_WIN32_PROC??）。 |
有关所有可用字段的列表，请参阅 AppPerformanceCounters。
若要了解有关指标的详细信息，请参阅 Application Insights 中的指标。 有关指标 REST API 的详细信息，请参阅 指标 - 获取。
系统和进程计数器指标
| .NET 名称 | 说明 |
|---|---|
\Processor(_Total)\% Processor Time |
总计算机 CPU 百分比。 |
\Memory\Available Bytes |
显示可用于计算机上运行的进程的物理内存量（以字节为单位）。 通过对清零、可用和备用内存列表上的空间量进行求和来进行计算。 可用内存可供使用。 归零内存由零填充的内存页面组成，用于防止后续进程看到前一个进程使用的数据。 备用内存是指已从进程的工作集（其物理内存）中删除并路由到磁盘的内存，路由到磁盘，但仍可供召回。 请参阅内存对象。 |
\Process(??APP_WIN32_PROC??)\% Processor Time |
托管应用程序的进程的 CPU 百分比。 |
\Process(??APP_WIN32_PROC??)\Private Bytes |
托管应用程序的进程所占用的内存量。 |
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec |
托管应用程序的进程运行的 I/O 操作速率。 |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec |
应用程序处理的请求速率。 |
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec |
应用程序引发的异常速率。 |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time |
平均请求执行时间。 |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue |
队列中等待处理的请求数。 |
自定义属性
如果指标的自定义属性 CustomPerfCounter 设置为 true，则表明该指标表示 Windows 性能计数器。 这些指标放置在 performanceCounters 表中，而不是放置在 customMetrics 中。 此外还分析此指标的名称，以提取类别、计数器和实例名称。
自定义指标
自定义指标是你定义的性能指标或特定于业务指标的指标，用于获取标准指标未涵盖的见解。 若要详细了解自定义指标，请参阅 Azure Monitor 中的自定义指标（预览版）。
自定义指标字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
单一度量 | 预先聚合的指标 |
|---|---|---|---|
name |
Name |
此字段是指想要在 Application Insights 门户和 UI 中看到的指标的名称。 | |
value |
Value |
此字段是单个度量值。 它是要聚合的各个度量值的总和。 | 对于预先聚合的指标， 值 等于 Sum。 |
Max |
Max |
对于单个度量指标， 最大值 等于 值。 | 此字段是聚合指标的最大值。 不应为度量设置。 |
Min |
Min |
对于单个度量指标， 最小值 等于 值。 | 此字段是聚合指标的最小值。 不应为度量设置。 |
Sum |
Sum |
对于单个度量指标， Sum 等于 值。 | 聚合指标的所有值的总和。 不应为度量设置。 |
Count |
Count |
对于单个度量指标， 计数 为 1。 |
1 分钟聚合周期中的度量数。 不应为度量设置。 |
有关所有可用字段的列表，请参阅 AppMetrics。
注意
计算平均值，需将 Sum 除以 Count。
页面视图遥测
当应用程序用户打开受监视应用程序的新页时，将记录页面视图遥测数据。 此上下文中的 Page 是由开发人员定义为应用程序选项卡或屏幕的逻辑单元，不一定与浏览器网页加载或刷新操作相关联。
可以在单页应用程序 (SPA) 的上下文中进一步理解这种差别，其中页面之间的切换与浏览器页面操作不相关。
pageViews.duration 是应用程序将页面呈现给用户所花费的时间。
页面浏览特定字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
name |
Name |
用户查看的页面的名称（例如， "Home" 或 "Shopping Cart"）。 |
url |
Url |
已查看的页面的完整 URL。 此字段对于分析应用程序中的流量和用户行为至关重要。 |
duration |
DurationMs |
PageView 持续时间来自浏览器的性能计时接口 PerformanceNavigationTiming.duration。如果 PerformanceNavigationTiming 可用，则使用该持续时间。 如果不是，使用已弃用的PerformanceTiming 接口，并计算 NavigationStart 和 LoadEventEnd 之间的增量。开发人员在使用 PageView记录自定义 事件时指定持续时间值。 |
有关所有可用字段的列表，请参阅 AppPageViews。
注意
默认情况下，Application Insights JavaScript SDK 会记录每个浏览器网页加载操作上的单个
PageView事件，并通过pageViews.duration浏览器计时进行填充。 开发人员可以使用PageView来扩展 事件的进一步跟踪。默认日志保持期为 30 天。 如果要查看较长时间的
PageView统计信息，则必须调整设置。
请求遥测
请求遥测表示与应用程序传入的 HTTP 请求相关的信息。 这种类型的遥测有助于监视应用程序的基于 Web 的服务的性能和成功。 请求遥测项表示由外部请求对应用程序触发的执行逻辑序列。 每个请求执行均由包含所有执行参数的唯一 id 和 url 标识。
可以按逻辑 name 将请求分组，并定义此请求的 source。 代码执行的结果可能是 success 或 fail，并且具有特定的 duration。 可以通过使用 resultCode 对成功和失败执行进一步分步。 请求遥测的开始时间在信封级别定义。 请求遥测使用 自定义 properties 和 measurements 支持标准可扩展性模型。
请求特定的字段：
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
id |
Id |
请求调用实例的唯一标识符，用于在请求和其他遥测项之间关联。 ID 应该全局唯一。 有关详细信息，请参阅 Application Insights 中的遥测关联。 |
source |
Source |
源是请求的源。 示例包括调用方的检测密钥或调用方的 IP 地址。 有关详细信息，请参阅 Application Insights 中的遥测关联。 |
name |
Name |
此字段为请求的名称，它表示用于处理该请求的代码路径。 较小的基数值对请求分组更有利。 对于 HTTP 请求，该名称表示 HTTP 方法和 URL 路径模板，例如，不带实际 GET /values/{id} 值的 id。对于字母大小写，Application Insights Web SDK 会“按原样”发送请求名称。 UI 上的分组区分大小写，因此 GET /Home/Index 被视为不同于 GET /home/INDEX，即使两者通常生成相同的控制器和操作执行。 原因在于，URL 往往区分大小写。 你可能想要确定所有 404 错误是否都发生在以大写形式键入的 URL 上。 可在博客文章中详细了解 ASP.NET web SDK 如何处理请求名称集合。 |
url |
Url |
URL 是包含所有查询字符串参数的请求 URL。 |
success |
Success |
成功指示调用是成功还是失败。 此字段为必需字段。 如果请求未显式设置为 false，将它将视为成功。 如果操作被异常中断或者返回错误结果代码，请将此值设置为 false。对于 Web 应用程序，如果响应代码小于 400 或等于 401，则 Application Insights 会将请求定义为成功。 但是，在某些情况下，此默认映射与应用程序的语义不匹配。响应代码 404 可能指示“无记录”，这可能是常规流的一部分。 它也可能指示链接断开。 对于断开的链接，可以实现更高级的逻辑。 仅当通过分析 URL 引用站点确定这些断开的链接位于同一站点时，才可以将这些链接标记为失败。 或者，在从公司的移动应用程序访问这些链接时，可将它们标记为失败。 同样，在从不支持重定向的客户端访问这些链接时，301 和 302 将指示失败。部分接受的内容 206 可能指示整个请求失败。 例如，Application Insights 终结点可能以单个请求的形式接收一批遥测项。 未成功处理该批中的某些项时，它将返回 206。
206 比率提高指示出现了需要调查的问题。 类似的逻辑适用于 207 多状态，其中的成功结果可能是不同响应代码的最差结果。 |
resultCode |
ResultCode |
响应代码是请求执行的结果。 它是 HTTP 请求的 HTTP 状态代码。 对于其他请求类型，它可能是 HRESULT 值或异常类型。 |
duration |
DurationMs |
请求持续时间的格式为 DD.HH:MM:SS.MMMMMM。 它必须是正数且小于 1000 天。 此字段是必填字段，因为请求遥测表示具有开始和结束时间的操作。 |
有关所有可用字段的列表，请参阅 AppRequests。
追踪遥测
跟踪遥测表示文本搜索的 printf 样式跟踪语句。
Log4Net、NLog 和其他基于文本的日志文件条目将转换成此类型的实例。 跟踪没有作为扩展性的度量。
特定于跟踪的字段：
| 字段名称 （应用程序洞察） |
字段名称 （日志分析） |
说明 |
|---|---|---|
message |
Message |
跟踪消息。 |
severityLevel |
SeverityLevel |
跟踪严重性级别。 |
有关所有可用字段的列表，请参阅 AppTraces。
注意
severityLevel 的值是枚举的，并且特定于平台。
自定义属性和测量
自定义属性
自定义属性的名称-值集合：该集合用于通过自定义维度来扩展标准遥测。 示例为部署槽位，该槽位生成特定于遥测或遥测项的属性，例如订单号。
- 最大密钥长度：150
- 最大值长度：8,192
自定义度量值
自定义度量值集合：使用此集合报告与遥测项关联的命名度量值。 典型用例如下：
- 依赖项遥测有效负载的大小。
- 由请求遥测处理的队列项数。
- 客户完成事件遥测的向导步骤所花费的时间。
可以在 Application Analytics 中查询自定义度量值：
customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)
注意
- 与所属遥测项关联的自定义度量值。 它们受到包含这些度量值的遥测项的采样的影响。 使用指标遥测跟踪其值独立于其他遥测类型的度量值。
- 不要对自定义度量使用字符串值。 仅支持数值。
最大密钥长度：150
上下文
每个遥测项可能都有一个强类型化上下文字段。 每个字段均会启用特定监视方案。 使用自定义属性集合存储自定义或特定于应用程序的上下文信息。
| 字段名称 （Application Insights） |
字段名称 （日志分析） |
说明 |
|---|---|---|
account_ID |
user_AccountId |
在多租户应用程序中，帐户 ID 是用户使用的租户帐户 ID 或名称。 当用户 ID 和已经过身份验证的用户 ID 不足时，它用于进一步的用户细分。 例如，Azure 门户的订阅 ID 或博客平台的博客名称。 |
application_Version |
AppVersion |
应用程序上下文字段中的信息总是与发送遥测的应用程序有关。 应用程序版本用于分析应用程序行为的趋势变化及其与部署的关联。 |
appId |
ResourceGUID |
Application Insights 资源的唯一标识符，用于区分遥测数据与不同的应用程序。 |
appName |
无 | 在 Application Insights 中，appName 与 _ResourceId 相同。 |
client_Browser |
ClientBrowser |
客户端使用的 Web 浏览器的名称。 |
client_City |
ClientCity |
收集遥测数据时客户端所在的城市（基于 IP 地理位置）。 |
client_CountryOrRegion |
ClientCountryOrRegion |
收集遥测数据时客户端所在的国家或地区（基于 IP 地理位置）。 |
client_IP |
ClientIP |
客户端设备的 IP 地址。 支持 IPV4 和 IPV6。 从服务发送遥测数据时，位置上下文与在服务中发起操作的用户有关。 Application Insights 从客户端 IP 中提取地理位置信息，然后将其截断。 无法将客户端 IP 本身用作用户的可识别信息。 |
client_OS |
ClientOS |
指示生成遥测数据的客户端的作系统。 |
client_StateorProvince |
ClientStateOrProvince |
收集遥测数据时客户端所在的州或省（基于 IP 地理位置）。 |
client_Type |
ClientType |
描述发送遥测数据的客户端设备类型（例如， Browser 或 PC.） |
cloud_RoleInstance |
AppRoleInstance |
运行应用程序的实例的名称。 例如，它是本地的计算机名称或 Azure 的实例名称。 |
cloud_RoleName |
AppRoleName |
应用程序所属的角色的名称。 它直接映射到 Azure 中的角色名称。 也可用于区分单个应用程序包含的微服务。 |
iKey |
IKey |
用于将遥测数据与特定 Application Insights 资源关联的旧唯一标识符。 |
itemId |
无 | 特定遥测项的唯一标识符。 |
itemCount |
ItemCount |
与单个遥测事件关联的出现次数或计数。 |
operation_Id |
OperationId |
根操作的唯一标识符。 此标识符允许跨多个组件对遥测分组。 有关详细信息，请参阅遥测关联。 操作 ID 由请求或页面视图创建。 其他所有遥测将此字段设置为包含请求或页面视图的值。 |
operation_Name |
OperationName |
操作的名称（组）。 操作名称由请求或页面视图创建。 其他所有遥测项将此字段设置为包含请求或页面视图的值。 操作名称用于查找一组操作的所有遥测项（例如，GET Home/Index）。 此上下文属性用于回答“此页面的典型异常有哪些？”等问题。 |
operation_ParentId |
ParentId |
遥测项直接父级的唯一标识符。 有关详细信息，请参阅遥测关联。 |
operation_SyntheticSource |
SyntheticSource |
合成源的名称。 来自应用程序的一些遥测可能代表综合流量。 可能是索引网站的 Web 爬网程序、站点可用性测试或来自诊断库（如 Application Insights SDK 本身）的跟踪。 |
sdkVersion |
SDKVersion |
发送遥测数据的 Application Insights SDK 的版本。 有关详细信息，请参阅 SDK 版本。 |
session_Id |
SessionId |
会话 ID 是用户与应用交互的实例。 会话上下文字段中的信息总是与用户有关。 从服务发送遥测时，会话上下文与在服务中启用操作的用户有关。 |
user_AuthenticatedId |
UserAuthenticatedId |
经过身份验证的用户 ID 与匿名用户 ID 相反。 此字段表示具有易记名称的用户。 默认情况下，仅使用 ASP.NET Framework SDK 的 AuthenticatedUserIdTelemetryInitializer 收集此 ID。使用 Application Insights SDK 初始化经过身份验证的用户 ID，该 ID 具有跨浏览器和设备永久标识用户的值。 通过这种方式，所有遥测项都归属于该唯一 ID。 使用此 ID 可以查询针对特定用户收集的所有遥测数据（根据采样配置和遥测数据筛选）。 用户 ID 可以与会话 ID 交叉进行引用，以提供唯一的遥测维度，并在会话持续时间内建立用户活动。 |
user_Id |
UserId |
匿名用户 ID 表示应用程序的用户。 从服务发送遥测时，用户上下文与在服务中启用操作的用户有关。 采样是最小化遥测收集量的一种技术。 采样算法尝试在所有相关遥测内部或外部采样。 匿名用户 ID 用于采样分数生成，因此匿名用户 ID 应该是一个足够随机的值。 匿名用户 ID 的计数与唯一应用程序用户的数量不同。 匿名用户 ID 的计数通常更高，因为每当用户在不同的设备或浏览器中打开你的应用时或清理浏览器 Cookie 时，都会分配一个新的唯一匿名用户 ID。 此计算可能会导致多次统计相同的实际用户。 用户 ID 可以与会话 ID 交叉进行引用，以提供唯一的遥测维度，并在会话持续时间内建立用户活动。 使用匿名用户 ID 存储用户名是字段误用。 使用已经过身份验证的用户 ID。 |
_ResourceId |
_ResourceId |
Application Insights 组件的完整 Azure 资源 ID，其中包括订阅、资源组和资源名称。 |
常见问题
本部分提供常见问题的解答。
如何报告数据模型或架构问题和建议？
若要报告数据模型或架构问题以及建议，请使用 GitHub 存储库。
如何衡量监视活动的影响？
PageView 遥测包括 URL，你可以使用 Kusto 中的正则表达式函数分析 UTM 参数。
如果用户或企业禁止在浏览器设置中发送用户代理，则此数据偶尔可能会缺失或不准确。 用户代理分析程序正则表达式可能未包含所有设备信息。 或者 Application Insights 可能未采用最新更新。
为什么自定义度量会成功且没有错误，但没有显示日志？
如果使用字符串值，可能会发生这种情况。 自定义度量只能使用数值。
后续步骤
- 查看 Application Insights 支持的平台。
- 了解如何 使用 Azure Monitor OpenTelemetry 发行版收集自定义遥测。
- 了解如何将 Application Insights API 用于自定义事件和指标。
- 了解如何扩展和筛选遥测。
- 了解如何使用 采样 来最大程度地减少基于数据模型的遥测量。