查看故障组分析¶

（仅限本机应用）查看故障组的分析和无法分析的故障转储。

开发人员必须启用 iOS、Android、visionOS 和 iPadOS 应用程序以使用全局捕获处理器捕获异常，并将其上传到移动服务服务器。在 SAP 移动服务主控室中，还必须启用该应用程序才能上传故障日志。

SAP BTP SDK for Android 和 SAP BTP SDK for iOS 可能会收集以下故障日志信息：

平台和版本（例如 iOS 的“16.6”）
平台体系结构（如“模拟器”或“体系结构”）
堆栈跟踪和线程池
应用程序标识和版本
构建和 SDK 版本
设备模型名称和标识
设备区域设置和屏幕尺寸
记录时戳
网络连接

故障日志可能是开发流程中重要的信息源。您可以启用测试应用以捕获故障并上传数据。配置移动服务以自动收集故障日志并按组报告故障。查看 SAP 移动服务主控室中报告的数据，并用于修复问题和确保质量。

请记住以下准则：

每个请求最多可以将 10 个故障日志上传到服务器。如果超出此限制，服务器将报告 Bad Request（400 错误代码）。SDK 必须指定如何处理限制并回复客户端。
最大文件大小和最大请求大小的默认值均为 150 MB，最大故障日志转储大小的默认值为 1 MB。
故障日志会保留三个月，然后删除。
您可以下载故障日志文件以及 dSYM 和映射配置文件：
- 下载移动服务中列出的故障报告的故障日志文件，如下所述。
- 如管理符号文件 (iOS) 中所述，从移动服务中下载 dSYM 配置文件。
- 如管理映射文件 (Android) 中所述，从移动服务中下载映射文件。
- 如果有与崩溃报告相关的客户端日志文件，您可以下载日志文件来帮助分析问题。客户端日志以 ZIP 格式下载，可能包含一个或多个日志文件。必须将客户端日志功能分配给移动应用并进行配置（有关信息，请参阅配置移动客户端日志上载）。如果没有可用的客户端日志，则不会显示下载相关客户端日志的选项。

您可以租用故障日志，并通过我的警报管理它们。如果您通过 SAP BTP Alert Notification 服务 (ANS) 为租用创建条件，您可以在三个月内继续接收警报通知。您可以使用我的警报将租用再延长三个月。

在 SAP 移动服务主控室中，选择分析 > 故障。
（可选）您可以通过选择平台、应用程序标识、应用程序版本和时间范围筛选器来缩小故障的焦点。受影响应用程序显示在应用程序标识中以供选择。如果选择平台和应用程序标识，则会显示可用应用程序版本以供选择。需要时间范围。选择重置清除筛选器。

两个图表提供有关故障和用户的可视信息：
- 故障 - 随时间推移发生的故障次数。
- 用户 - 随时间推移受故障影响的用户数。

在故障组下查看检测到的故障组。

故障组

列	描述
标题	故障组的标题。
计数	故障组计数。
影响用户	受影响的用户数。
平台	平台，如 iOS、Android、visionOS 或 iPadOS。
应用程序版本	应用程序版本的范围。
应用程序标识	应用程序标识符。
上次报表 (UTC)	采用 UTC 格式的上次报表更新的日期和时间 (`YYYY-MM-DD HH:MM:SS`)。
状态	按平台列出的故障转储状态。选择状态按钮导航到特定应用程序以获取详细信息。

对于 iOS 故障转储状态：

符号化 - 故障转储已完全符号化。
正在处理 - 正在处理上传的故障转储（无论是否已上传 dSYMs）。
缺少 dSYM - 故障转储已处理。缺少一些调试符号 (dSYMs)，因此仅对此故障转储进行了部分符号化。请参阅管理符号文件 (iOS)。上传所需的 dSYM 文件后，将再次触发符号化流程。
初始 - 故障转储已上传，正在等待处理。

对于 Android 故障转储状态：

故障转储已反混淆。
故障转储已混淆。

选择故障组以查看更多详细信息。
选择概览标签以查看所选故障组的 KPI、图表和堆栈跟踪。
- KPI 包括：
  - 发生次数 - 报告的发生次数。
  - 用户 - 受影响的用户数。
  - 应用程序版本 - 报告故障的应用程序版本。
- 图表包括：
  - 受影响的设备型号 - 报告故障的设备型号。
  - 受影响的平台版本 - 报告故障的操作系统平台。
- 堆栈跟踪：故障的通用堆栈跟踪部分，以及附加系统详细信息。

选择报表标签以按设备查看各个故障转储的信息。

查看报告故障的设备摘要。

设备报表

列	描述
设备	设备类型，例如像素。
平台版本	操作系统平台版本，例如 Android：14、visionOS：1.1 和 iOS：50.1。
日期 (UTC)	采用 UTC 格式的设备报表的日期和时间 (`YYYY-MM-DD HH:MM:SS`)。

选择一个设备报表以查看其详细信息。
- 报表详细信息 - 设备详细信息，例如型号、语言、屏幕大小、应用程序版本、SDK 产品和版本以及平台版本。
- 原始数据 - 设备的故障数据。您可以下载该数据。
  1. 要下载一个或多个设备的故障报告，请选中设备列左侧的复选框。然后，单击以下载所选文件。
注释
- 用户每次可以下载 100 条故障日志。
- 下载对话框不会阻止用户执行其他操作。
- 如果您在尝试多次后仍无法下载故障日志，请为该组件MOB-CLD-CF 创建案例。

租用故障警报¶

您可以在租户级别租用故障日志以接收通知，并通过我的警报管理租用。

当您从 SAP 移动服务主控室租用故障警报时，您可以配置选项以将警报发送到 SAP Alert Notification 服务。这使您能够控制从移动服务向 Alert Notification 服务发送事件的频率和时间。您可以设置发送事件的时间阈值（例如，在一个警报之后，或在五个警报之后），或设置发送事件的时间计划（例如，每小时、每八小时或每 24 小时）。这减少了发送的重复警报的数量，因此 Alert Notification 服务不会被覆盖。

通知的实际条件必须通过 Alert Notification 服务创建。如果您通过 Alert Notification 服务为租用创建条件，您可以在三个月内继续接收警报通知。您可以使用我的警报将租用再延长三个月。

在 SAP 移动服务主控室中，选择分析 > 故障。
您可以通过选择平台、应用程序标识、应用程序版本和时间范围筛选器来缩小故障的焦点。选择执行以搜索。

要租用筛选的故障日志，请选择租用。

在租用故障日志中，分配租用名称并检查或编辑租用。这些条目反映了您选择的原始筛选器，但您可以修改它们。

故障日志租用

设置	描述
租用名称	输入对您有意义的租用名称，例如 TEST.sample.basic。
类别	故障日志
应用程序标识	应用程序标识符，例如 TEST.sample.basic。
平台	平台，如 iOS、Android、visionOS 或 iPadOS。
发送至 ANS	是否将故障日志警报发送到 Alert Notification 服务。如果您计划在 Alert Notification 服务中配置警报通知条件，请选择此选项。如果启用发送到 ANS 选项，则会显示两个附加字段。它们用于配置向 Alert Notification 服务发送事件的频率和时间。
阈值 (ANS)	如果启用发送至 ANS 复选框，则可以提供警报发送时间的阈值，例如 0、1 或 5。如果事件计数大于阈值数，则会向 Alert Notification 服务发送警报通知。
计划 (ANS)	如果启用发送至 ANS 复选框，则可以选择计划，例如每小时、每 8 小时和每 24 小时。警报通知将基于您的选择定期发送到 Alert Notification 服务。
Alert Notification 服务	如果启用发送至 ANS 复选框，请注意 Alert Notification 服务信息。您需要用此在 Alert Notification 服务中手动创建条件。

选择保存。

保存后，租用会显示在我的警报中。警报租用将一直保留，直到您将其删除。
要接收租用的持续警报通知，请在 Alert Notification 服务中创建条件。请参阅租用故障日志通知。

在这种情况下，您会收到三个月的警报通知。您可以使用我的警报将警报通知再延长三个月。请参阅管理我的警报。示例 Alert Notification 服务条件：

要接收特定故障日志租用的警报通知：
```
Key: tags.mobile_crash_log_alert
Predicate: Is Equal To
Value: MyCrashLogSubscription
```
要接收空间/租户中所有故障日志租用的警报通知：
```
Key: eventType
Predicate: Is Equal To
Value: MobileServicesCrashLogAlert
```

最后更新: February 12, 2025