交易搜索和诊断

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

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

哪里可以看到“搜索”？

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

在 Azure 门户中

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

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

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

在 Visual Studio 中

在 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

除了 Application Insights SDK 默认发送的遥测数据以外，你还可以：

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

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

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

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

什么是组件？

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

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

事务诊断体验

此视图有四个关键部分：

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

跨组件事务图

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

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

所有使用此操作 ID 的遥测

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

所选遥测数据的详细信息

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

搜索结果

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

.NET 探查器和 Snapshot Debugger

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

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

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