事务搜索和诊断

事务搜索是 Application Insights 中的一项功能，可用于查找和浏览单个遥测项，例如页面视图、异常或 Web 请求。 你还可以查看编码的日志跟踪和事件。

若要对数据进行更复杂的查询，请使用 Log Analytics。

可以在 Azure 门户或 Visual Studio 中找到“事务搜索”。

可以从应用程序的 Application Insights“概述”选项卡打开事务搜索。 还可以在左侧菜单中的“调查”下选择“搜索”。

转到“事件类型”下拉菜单，查看遥测项列表，例如服务器请求、页面视图、你已编码的自定义事件。 “结果”列表的顶部是摘要图表，显示一段时间内的事件计数。

退出下拉菜单或选择“刷新”以获取新的事件。

在 Visual Studio 中，也有一个“Application Insights 搜索”窗口。 该窗口最适合显示由正在进行调试的应用程序生成的遥测事件， 但也可显示从 Azure 门户的已发布应用收集的事件。

在 Visual Studio 中打开“Application Insights 搜索”窗口：

“Application Insights 搜索”窗口的功能与 Web 门户类似：

打开请求或页面视图时，“跟踪操作”选项卡便可供使用。 “操作”是一系列与单个请求或页面视图关联的事件。 例如，依赖项调用、异常、跟踪日志和自定义事件可能是单个操作的一部分。 “跟踪操作”选项卡以图形方式显示与请求或页面视图相关的这些事件的计时和持续时间。

选择任一遥测项可查看关键字段和相关的项。

此时会打开“端到端事务详细信息”视图。

打开“事件类型”下拉菜单，选择要查看的事件类型。 如果稍后要还原筛选器，请选择“重置”。

事件类型包括：

• 跟踪：诊断日志，包括 TrackTrace、log4Net、NLog 和 System.Diagnostic.Trace 调用。
• 请求：服务器应用程序收到的 HTTP 请求，包括页面、脚本、图像、样式文件和数据。 这些事件用于创建请求和响应概述图表。
• 页面视图：Web 客户端发送的遥测数据，用于创建页面视图报告。
• 自定义事件：如果插入了对 TrackEvent() 的调用以便监视使用情况，可以在此处搜索这些调用。
• 异常：未捕获到的服务器中的异常，以及使用 TrackException() 记录的异常。
• 依赖项：来自服务器应用程序的调用（调用对象为 REST API 或数据库等其他服务），以及来自客户端代码的 AJAX 调用。
• 可用性：可用性测试的结果

可以按事件的属性值筛选事件。 可用的属性取决于所选的事件类型。 若要开始，请选择“筛选器”。

不选择特定属性的任何值与选择所有值的效果相同； 这会关闭根据该属性进行筛选的功能。

请注意，筛选器值右侧的计数显示当前筛选的集内有多少个出现的项。

若要查找具有相同属性值的所有项，请在“搜索”框中输入该属性值，或者在“筛选”选项卡上浏览属性时选中相应的复选框。

可以搜索任何属性值中的关键词。 如果你已编写包含属性值的自定义事件，则此功能非常有用。

你可能希望设置时间范围，因为搜索一小段时间内的值可以更快地返回结果。

搜索完整单词，而不搜索子字符串。 使用引号将特殊字符引起来。

可以使用以下搜索表达式：

如果应用生成大量遥测数据并使用 ASP.NET SDK 版本 2.0.0-beta3 或更高版本，则它会通过自适应采样自动减少发送到门户的数据量。 此模块仅发送一小部分事件。 它选择或取消选择与相同请求相关的事件组，从而你允许在相关事件之间导航。

了解采样。

可以使用任何遥测项中的详细信息，在 GitHub 或 Azure DevOps 中创建 Bug。

通过单击任何遥测项转到端到端事务详细信息视图。 然后选择“创建工作项”。

首次执行此步骤时，系统将要求配置指向 Azure DevOps 组织和项目的链接。 还可以在“工作项”选项卡上配置此链接。

除了 Application Insights SDK 原本发送的遥测数据以外，可以：

• 从 .NET 或 Java 中偏好的日志记录框架捕获日志跟踪。 也就是说，可以搜索日志跟踪并将其与页面视图、异常和其他事件相关联。

• 编写代码用于发送自定义事件、页面视图和异常。

了解如何向 Application Insights 发送日志和自定义的遥测数据。

找到常见问题的答案。

请参阅限制摘要。

我们不自动记录 POST 数据，但可以使用 TrackTrace 或日志调用。 POST 数据放在消息参数中。 无法像筛选属性一样筛选消息，但消息的大小限制更大。

Azure Functions 不会记录 URL 查询字符串。

统一诊断体验自动将所有受 Application Insights 监视的组件中的服务器端遥测关联到一个单独的视图。 如果你有多项资源，也没关系。 Application Insights 可检测基础关系，并可用于轻松诊断导致事务缓慢或失败的应用程序组件、依赖项或异常。

组件是分布式或微服务应用程序的可独立部署的部件。 开发者或操作团队具有代码级可见性，或有权访问由这些应用程序组件生成的遥测。

• 组件不同于“观察到的”外部依赖项，例如 SQL 和事件中心，你的团队或组织可能无权访问这些依赖项（代码或遥测）。
• 组件在任意数目的服务器、角色或容器实例上运行。
• 即使订阅不同，组件也可以是单独的 Application Insights 检测密钥。 组件还可以是向单个 Application Insights 检测密钥报告的不同角色。 新体验显示了所有组件的详细信息，而不论其设置方式。

此视图有四个关键部分：

• 结果列表
• 跨组件事务图
• 与此操作相关的所有遥测的时序列表
• 任何所选遥测项的细节窗格

此图提供使用水平条的时间线，表示请求的持续时间及各组件间的依赖项。 收集的任何异常也会标记在时间线上。

• 此图表上的顶行表示入口点。 它是对此事务中调用的第一个组件的传入请求。 持续时间是指完成事务所用的总时间。
• 对外部依赖项的任何调用都是简单的不可折叠行，以图标表示依赖项类型。
• 对其它组件的调用均属于可折叠行。 每一行都与在组件处调用的特定操作对应。
• 默认情况下，所选择的请求、依赖项或异常显示在一侧。 选择任意行以查看其详细信息。

本部分以与此事务相关的所有遥测的时间序列显示平面列表视图。 它还显示自定义事件以及未在事务图中显示的跟踪。 可以将此列表筛选为由特定组件或调用生成的遥测。 可以在此列表中选择任意遥测项，并在一侧查看相应的详细信息。

此可折叠窗格显示事务图或列表中任何所选项的详细信息。 “全部显示”列出了收集的所有标准属性。 任何自定义属性都在标准集下单独列出。 选择“调用堆栈”跟踪窗口下的省略号按钮 (...) 以获取复制跟踪的选项。 单击“打开探查器跟踪”和“打开调试快照”，在相应的详细信息窗格中查看代码级诊断信息。

此可折叠窗格会显示符合筛选条件的其他结果。 选择任何结果以更新前三个部分的相应详细信息。 我们试图找到最可能从所有组件中获得详细信息的样本，即使在任何一个组件中采样都是有效的。 这些示例显示为建议。

.NET Profiler 或 Snapshot Debugger 有助于对性能和失败问题进行代码级诊断。 通过此体验，仅需选择一次即可查看任意组件的 .NET Profiler 跟踪或快照。

如果无法让 .NET Profiler 正常工作，请联系 serviceprofilerhelp@microsoft.com。

如果无法让 Snapshot Debugger 正常工作，请联系 snapshothelp@microsoft.com。

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

可能的原因：

• 是否使用 Application Insights 检测了其他组件？
• 是否使用了最新的稳定 Application Insights SDK？
• 如果这些组件是单独的 Application Insights 资源，验证你是否具有访问权限。 如果确实具有访问权限，并且使用了最新的 Application Insights SDK 来检测组件，请通过右上角的反馈通道告知我们。

当前，出站依赖项调用与入站请求分开显示。 通常情况下，这两种调用大致相同，但持续时间值因网络往返而不同。 可通过前导图标和样式不同的持续时间条来区分它们。 这份数据演示文稿是否包含令人困惑的内容？ 欢迎提供反馈！

在事务图中针对时钟偏差调整了时间线。 可以在详细信息窗格中查看确切的时间戳，或使用 Log Analytics 进行查看。

此行为是设计使然。 所有组件的全部相关项都已显示在左侧（顶部和底部）。 新体验中有两个左侧未包含的相关项：此事件发生前后五分钟内的所有遥测，以及用户时间线。

事务诊断体验显示共享操作 ID 的单个操作中的所有遥测数据。 默认情况下，Application Insights SDK for JavaScript 为每个唯一的页面视图创建一个新操作。 在单页应用程序 (SPA) 中，将仅生成一个页面视图事件，并对生成的所有遥测数据使用单个操作 ID。 这会导致许多事件与相同操作相关联。

在这些情况下，可以使用自动路由跟踪来自动创建新操作，以便在 SPA 中进行导航。 必须打开 enableAutoRouteTracking，以便在每次更新 URL 路由（逻辑页面视图出现）时生成页面视图。 若要手动刷新操作 ID，请调用 appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId()。 手动触发 PageView 事件还将重置操作 ID。

甘特图中未说明的时间是跟踪的依赖项未涵盖的时间。 出现此问题的原因是未自动或手动检测外部调用。 也可能是因为时间花在了处理上，而不是因为外部调用。

如果所有调用都已检测，则进程中可能是所花时间的根本原因。 .NET Profiler 是用于诊断进程的有用工具。

此错误表示浏览器无法调用所需的 API 或 API 返回了失败响应。 若要解决此问题，请打开浏览器 InPrivate 窗口并禁用正在运行的任何浏览器扩展，然后确定是否仍可以重现门户行为。 如果门户错误仍然发生，请尝试使用其他浏览器或其他计算机进行测试，从 API 调用失败的客户端计算机调查 DNS 或其他与网络相关的问题。 如果门户错误仍然存在并需要进一步调查，请在重现意外的门户行为并从 Azure 门户打开支持案例时收集浏览器网络跟踪。