诊断功能

重要

Visual Studio App Center 于 2025 年 3 月 31 日停用，但分析和诊断功能除外，这些功能将继续受支持，直到 2026 年 6 月 30 日。 了解详细信息。

在本部分中，你将了解可用于 App Center 诊断服务的功能集。

崩溃和错误分析

在 App Center 诊断中，可以查看 App Center 自动生成的分析数据，以了解应用中何时发生崩溃或错误。

默认情况下，App Center 会在并排视图中显示应用每天的崩溃和错误。

使用左上角的选项卡，向下钻取到“崩溃”和“错误”。 执行此作时，左侧图表指示每天的崩溃/错误数，右侧图表显示受影响的用户数。 按应用版本、时间范围和状态筛选图表，以获取更集中的视图。

重要

受影响的用户图表需要 App Center Analytics 模块中的会话数据。 启动崩溃和分析模块以计算准确的受影响的用户百分比。 如果没有 Analytics，崩溃和错误似乎会影响 100% 用户。

注释

App Center 会筛选潜在的敏感信息。 App Center 筛选器的敏感信息示例包括 URL、JSON 字符串和请求 ID。

分组

App Center 诊断按相似性（例如问题的原因和应用中发生问题的原因）对崩溃和错误进行分组。 对于每个崩溃和错误组，App Center 将显示失败的代码行、类或方法名称、文件名、行号、崩溃或错误类型和消息，以便您一目了然地了解这些组。 选择一个组以查看详细信息，并访问详细问题报告和日志列表。 这样，你就可以更深入地深入了解并使用功能集来更好地了解在崩溃或错误期间应用的行为。

如果崩溃是由于调用某个 URL 失败导致的（例如“调用 azure.com 或 google.com 时出错”），App Center 可以根据该 URL 对崩溃进行分组。 例如，对 azure.com 的所有失败调用都组合在一起，对 google.com 的所有失败调用都分组在一起。 但是，由于 App Center 会从崩溃日志中删除带有 HTTP 或 HTTPS 前缀的 URL，因此，只有在避免使用这种语法时，这种分组方式才有效。 例如，“调用 http://azure.com" 时出错”不会与其他 azure.com 调用归为一组，而“调用 azure.com 时出错”则会与类似的错误报告归为一组。

用户标识

App Center Diagnostics 允许你将用户 ID 附加到你的崩溃和错误。 为此，请在目标平台 Android、 iOS、 macOS、 React Native、 tvOS、 Unity、 UWP、 WPF/WinForms 和 MAUI/Xamarin 中使用 App Center SDK。 当你单击组内的问题时，你会找到与崩溃或错误关联的用户 ID。

在连接用户 ID 后，您可以使用 App Center 的搜索功能，通过指定的 ID 搜索崩溃问题。 请按照 App Center 的 搜索文档了解如何完成此操作。

附件

在 App Center 诊断 UI 中，可以查看和下载崩溃和错误报告的二进制和文本附件。

可以通过阅读 Android、 iOS、 macOS、 React Native、 UWP、 WPF/WinForms 和 MAUI/Xamarin 应用的 SDK 崩溃文档，了解如何向崩溃报告添加附件。

仅 Android、Unity、UWP、WPF、WinForms 和 Xamarin 平台支持已处理错误的附件。 了解如何在 适用于 Android、 Unity、 UWP、 WPF/WinForms 和 MAUI/Xamarin 应用的 SDK 文档中向错误报告添加附件。

若要查看和下载附件，请选择崩溃或错误组、特定设备报告，然后单击“附件”选项卡。

崩溃前的事件

跟踪导致崩溃的事件，以捕获有关应用状态的有用信息。

此功能需要 App Center Analytics 模块。 若要定义自定义事件，请查看适用于 Android、iOS、macOS、React Native、Windows 和 MAUI/Xamarin的SDK 文档。

若要查看故障前的事件，请选择崩溃组、特定设备报告，然后单击“事件”选项卡。

键值对

可以通过将字符串值字典（作为键/值对）传递给 TrackError 方法，定制发送到 App Center 的错误报告，以便包含与错误相关的更多上下文信息。 这些属性是可选的。 若要设置键值对，请查看我们的 Android、 MAUI/Xamarin、 Unity、 UWP 和 WPF/WinForms 文档。

注释

目前，此功能仅支持 Android、iOS、Xamarin、React Native、Unity、UWP、WinForms 和 WPF 错误。

导出诊断数据

App Center 可以将诊断（崩溃和错误）原始数据导出到 Azure。 将诊断数据导出到 Blob 存储以自定义数据。

若要导出崩溃、附件和错误，必须调用 导出配置 API：

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

在 exportEntities API 属性的字段中，必须指示要导出的数据类型：崩溃、错误、附件。 执行此作时，将导出完整的符号化崩溃和相应的堆栈跟踪。

了解更多有关数据导出的好处以及如何在导出文档中进行导出的信息。

线程

在崩溃报告中，可以看到应用崩溃时处于活动状态的当前线程。 崩溃的线程以红色突出显示，以便更好地了解应用的状态。

注释

在 Windows 上，报告仅显示崩溃线程中的堆栈跟踪。 Windows 不支持在崩溃时显示其他线程的状态。

配置警报

通过配置 App Center 应用定义设置以发送电子邮件通知来随时了解崩溃情况。 可以为每个应用配置此设置，以在创建新的崩溃组时立即发送电子邮件，或者发送每日摘要电子邮件，其中包含应用的顶级崩溃。 若要配置这些警报，请执行以下操作：

1. 登录到 App Center 并选择你的应用
2. 在左侧菜单中，导航到 “设置”
3. 单击 “电子邮件通知”
4. 选择“立即”、“每日”或“永不”。 默认配置设置为 Never。

可以在 App Center 仪表板文档中了解有关通知的详细信息。

创建 Bug 跟踪器

可以将第三方 bug 跟踪器工具与 App Center 集成，以保持知情并更好地管理崩溃。 阅读 bug 跟踪器文档 ，了解如何开始使用。

将报表上传到 App Center

通过 API 上传崩溃的文档已移动。