查询历史日志

根据您的业务需求，您可以查询客户端上报的历史日志。可以查询的日志类型包括行为日志、自动化日志、异常日志、客户端性能日志。查询历史日志时，您可以使用关键字类型和高级过滤规则快速定位到日志位置，并且下载搜索结果。

前置条件

确保您具备日志查询的权限。具体的权限问题，咨询您的系统管理员。

关于此任务

对于任意一种日志类型，您可以选择以下关键字类型之一进行查询：

• 用户 ID
• 设备 ID
• Trace ID
• 任意关键字

根据您的用户类型，选择合适的关键字类型进行查询：

• 作为普通用户，大多数情况下，您只需要选择 任意关键字。
  注意：

  • 由于 任意关键字 使用全文索引，并根据英文分词，因此支持以下搜索内容：
    • 字母和数字。例如，全文中 hello Peter how are you 会被分成 hello、 Peter、 how、 are、 you 等单词，输入以上任意一个单词都可以搜索出来。
    • 不包含 path 的 URL。例如，支持 www.google.com 搜索， 但是 www.google.com.hk/webhp 中 /webhp 不会被索引，无法进行搜索。
  • 任意关键字 支持多关键词查询，不同的关键字之间用空白字符分开。空白字符包括空格键、TAB 按键。多关键字遵循叠加规则。
• 作为开发者，您可以选择特定的关键字类型进行日志查询。例如，选择 Trace ID 来追溯某次远程过程调用（RPC） 调用了哪些系统。其中，Trace ID 表示一次 RPC 请求的唯一 ID。客户端要追溯一次 RPC 的情况，必须将该请求的 Trace ID 投递到响应的日志位置。对于行为埋点来说，对应的位置是行为日志中的 extcol4 列，该列由一组组数据对构成： key=value，key1=value1，key2=value2，...，keyN=valueN。当投递的 key 是 TraceID 的数据对，对应的 value 就是 TraceID。

重要：

• 查询功能支持最近 7 天的日志查询，但是每次查询的时间跨度不能超过 2 天。
• 对于积压未上传的客户端日志，达到限度时会择旧删除 1/4 以释放存储空间。限度说明如下：
  • 在 Android 客户端，埋点日志总量超过 15MB，或 applog 总量超过 50MB 时。
  • 在 iOS 客户端，埋点日志或 applog 超过 30MB 时。

操作步骤

登录 mPaaS 控制台，完成以下步骤：

1. 在左侧导航栏，点击 移动分析 > 日志管理 > 日志回放。

2. 选择要查询的日志类型、日志查询的时间顺序，并输入关键字，点击 搜索。默认查询最近 12 小时的日志。
   

   • 日志查询支持 正序 和 倒序 查询。

   • 您可以通过点击搜索框下方显示的历史查询记录，进行快速查询。

     

3. 在 日志列表 下方，您可以看到查询的日志结果。
4. 如果想要精确日志查询的时间范围，点击 时间条件 展开日志查询的条件，选择时间类型，设置日志查询的开始和结束时间，选择时间区间、每页显示的日志条数。
   注意：如果您选择的时间区间和开始/结束时间冲突，开始/结束时间会根据您选择的时间区间自动调整。
5. 要添加高级过滤规则，点击关键字输入列右边的加号按钮（）。

6. 在 高级过滤规则 栏中，选择规则类型，并添加对应的过滤内容。

   • 支持的规则类型包括 埋点（Seed）、平台（Platform）、版本(Version)。

   • 您可以添加多条高级过滤规则，过滤规则会叠加。如果要移除当前的过滤规则，点击删除按钮（）。

     

7. 在 日志列表 下方，查看过滤后的查询结果，关键字高亮显示。查询结果默认折叠显示：
   • 点击单条查询结果，可以展开单条结果的完整日志内容。
   • 勾选 展开全部，可以展开所有日志内容。
     
8. 要下载搜索结果，点击关键字输入列右边的下载按钮（）。搜索结果汇总在 .xlsx 文件中。

相关链接

• Android 客户端埋点
• iOS 客户端埋点
• 日志埋点说明