配置移动客户端日志上传¶
为应用程序和单个用户配置移动客户端日志上传。此功能需要移动客户端日志上传服务。
您可以指定日志记录配置并查看日志文件。使用日志文件时,请记住以下日志文件保留规则:
-
对于错误日志,仅显示最近 7 天内上传的日志。超过 7 天的错误日志将从 SAP Mobile Services 中移除。
-
对于日志文件,仅显示最近 30 天内上传的文件,更早的文件将从 SAP Mobile Services 中移除。
-
SAP Mobile Services 可能会在事件日志过期之前将其清除,以便在极少数情况下提供稳定服务。
您还可以查看重要的 URL,并以 JSON 格式导出 移动服务 数据。
-
在 SAP 移动服务主控室 中,选择移动应用程序 > 本机/
MDK。 -
选择应用程序,导航到设置标签,然后从扩展组件功能部分中选择客户端日志更新(或先进行添加)。
-
选择错误日志以查看应用程序的错误或致命客户端日志。使用错误日志时,请记住上述日志文件保留规则。
输入搜索条件以缩小范围,然后选择执行。您可以根据日志记录级别、相关性标识和时间范围(预定义时间范围或使用日历日期选取器定义范围的自定义时间范围)进行搜索。您可以对搜索结果进行排序、查看客户端日志的详细内容,并以
JSON格式下载日志。下载操作仅适用于 2021 年 7 月版本发布后上传的日志。下载的日志文件包含特定的错误日志以及与错误日志相关的其他日志级别的日志。对于此版本之前上传的日志,下载选项不可用。
错误日志文件
列 描述 时间 (UTC+0000) 以 UTC 格式表示的日志时间。 级别 日志级别,包括“致命”或“错误”。 消息文本 日志消息文本。 用户名 上传包含日志的日志文件的用户的名称。 位置 位置,例如 com.<company>.class。操作 要执行的操作,例如查看日志详细信息或将日志文件( JSON格式)下载到本地环境。 -
选择配置并配置默认和用户特定的客户端日志上传属性。
-
在默认日志记录下, 配置服务器和客户端日志记录属性。除非提供用户特定的值,否则将使用默认值。
默认日志记录属性
属性 描述 日志上传 是否启用服务器以上传客户端日志。 日志级别 所有用户的默认客户端日志级别设置。 - 无 - 未设置日志级别。
- 调试 - 出于调试目的,包括广泛和低级信息。
- 信息 - 信息性文本,通常用于回应已经执行的内容。除非主动排除故障或查找特定信息,否则为默认和建议设置。
- 警告 - 应用程序可从异常中恢复,继续完成任务,但要求开发人员或操作人员加以注意。
- 错误 - 应用程序可从错误中恢复,但由于出错而无法完成任务。
- 致命 - 应用程序无法从错误中恢复,严重情况导致致命终止。
- 路径 - 针对跟踪执行流。用于进入和离开方法、循环和分支操作等上下文中。(不适用于离线日志记录组件。)
此后删除上传的日志 选择一个时间期间,超出该时间期间将从设备中删除上传的日志。默认情况下,数据库中的日志文件保留七天。 日志最大数量 输入可同时存储于用户系统的日志文件的最大数量。选择 1 - 99999 之间的值。 最大日志大小 输入每个日志文件的最大大小。从 0-100 MB 中选择一个值。'0 MB' 表示文件大小不受限制。如果日志文件的最大数量或文件大小超出定义的值,则会删除最老的日志文件,并将日志写入到新日志文件。无论是否将日志上载至服务器,都可能发生此情况。要确保日志得以保留,您可以将日志文件的最大数量设置为 "1",将文件大小设置为 0 MB。 -
在用户特定日志记录下,查看现有的用户特定日志记录值。用户特定值将覆盖该用户的默认值。您可以选择加号以使用提供的准则添加用户,或编辑现有值。
-
选择保存。
注释
每个移动应用程序在错误或致命级别上客户端日志上载限制为 100 万行。如果超出此限制,移动应用程序将无法上载更多日志,直到过期日志从数据库中清除。
-
-
选择日志文件可查看已上传的日志文件,包括所有级别,而不仅是错误或致命。每次上传都会创建一个日志文件。请注意,这适用于从 2021 年 7 月版本开始上传的日志文件。在此版本之前上传的日志文件将不会显示在此处。使用日志文件时,请记住上述日志文件保留规则。
您可以选择一个或多个日志文件,并使用用户名和时间范围 (UTC+0000) 来筛选和搜索日志。您可以选择一个或多个日志文件将
JSON格式的文件下载到您的本地环境。日志文件
列 描述 用户名 上传日志文件的用户的名称。 已上传 (UTC+0000) 以 UTC 格式上传文件的日期和时间。 行 日志文件中的日志总数。 有错误的行 日志文件中日志级别为“错误”或“致命”的日志数。 开始时戳 (UTC+0000) 日志文件中第一个日志的时戳(UTC 格式)。 结束时戳 (UTC+0000) 日志文件中最后一个日志的时戳(UTC 格式)。 -
选择信息以查看功能详细信息,例如功能描述和有用的 URL,并以
JSON格式导出移动服务数据。