通过

诊断功能

  • 项目

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方法。

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

故障和错误分析

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

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

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

注意

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

App Center 显示有关崩溃和错误的分析

分组

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

如果崩溃是由对 URL (调用失败引起的，例如“呼叫 azure.com 或 google.com 时出错”) App Center 可能会按该 URL 进行分组崩溃 (例如，所有调用失败 azure.com 将分组在一起，无法调用 google.com 将分组) 。 但是，由于我们从崩溃日志中删除前面附加 HTTP 或 HTTPS 的 URL，因此此分组仅在避免此语法时才起作用，例如：“调用 http://azure.com"时出错;不会与其他 Azure 调用分组，但“错误调用 azure.com”将与类似的错误报告分组。

App Center 组基于相似性崩溃和错误

用户标识

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

附加用户 ID 后，可以使用 App Center 的搜索功能搜索具有指定 ID 的崩溃。 按照 App Center 的 搜索文档了解如何执行此操作。

Attachments

在 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 允许你向崩溃和错误报告添加附件

崩溃前的事件

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

若要定义自定义事件，检查适用于 Android、iOS、macOS、React Native、Windows 和 MAUI/Xamarin 的 SDK 文档。

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

App Center 允许跟踪导致崩溃的事件

键值对

可以通过将字符串值的字典作为键/值对 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 属性的 字段中，必须指示要导出的数据类型：崩溃、错误、附件。 执行此操作时，将导出完整的符号化崩溃和相应的堆栈跟踪。

在 导出文档中详细了解 其优点以及如何导出数据。

线程

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

App Center 显示崩溃时的当前线程

注意

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

“配置警报”

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

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

设置崩溃电子邮件通知频率的屏幕截图

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

创建 Bug 跟踪器

可将第三方 bug 跟踪器工具与 App Center 集成，以便及时了解最新动态并更好地管理故障。 若要了解如何开始，请阅读 bug 跟踪器文档。

将报表上传到 App Center

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