# 游戏日志分析

为帮助开发者更便捷地定位问题，从基础库 3.7.4 开始，我们推出了小游戏日志功能。开发者可通过 wx.getGameLogManager 获取游戏日志实例并上报相关游戏日志，日志会进行汇聚并实时上报到小游戏管理后台。

开发者可从小游戏管理后台 “基础数据 -> 游戏日志分析”进入日志分析页面，查看开发者上报的相关日志信息。

# 如何使用

# 日志上报

从基础库 3.7.4 开始，小游戏即可使用游戏日志上报的相关功能，接口的相关能力可通过 wx.getGameLogManager 进行了解，以下是日志上报的相关示例：

1、调用 wx.getGameLogManager 获取游戏日志管理器实例，为了兼容旧的基础库版本，在使用游戏日志上报相关功能时，建议使用如下代码封装一下，例如将相关兼容代码封装在本地的gamelog.js中：

let logger = null;
if (wx.getGameLogManager) {
  logger = wx.getGameLogManager({
    commonInfo: {
      version: "1.0.0",
      env: "prod"
    }
  });
}

export const gameLogAdaptor = {
  log() {
    if (!logger) return;
    logger.log.apply(logger, arguments);
  },
  tag() {
    if (!logger) return;
    logger.tag.apply(logger, arguments);
  },
  getCommonInfo() {
    if (!logger) return;
    logger.getCommonInfo.apply(logger, arguments);
  },
  updateCommonInfo() {
    if (!logger) return;
    logger.updateCommonInfo.apply(logger, arguments);
  }
};

2、在游戏逻辑合适的位置打印相关的日志

import { gameLogAdaptor } from "./gamelog.js"; // 引用上面的gamelog.js文件，具体路径以游戏实现为准

// 直接使用log方法上报日志
logger.log({
  level: "info",
  key: "login",
  value: { loginTime: "1731915939" }
});
// 使用tag后的上报方法上报日志
const cacheLogger = logger.tag("cache"); // 用于缓存相关日志上报
cacheLogger.warn("cache not found", { key: "tableCache" }); // 上报 warn 级别的日志

# 如何查看/分析日志

登录 小游戏管理后台，通过“基础数据 -> 游戏日志分析” 进入游戏日志分析页面。

开发者对游戏日志执行过滤、聚合等操作；使用可视化的视图查看数据维度的分布及其变化趋势；通过数据表格查看相关日志的详细上报信息，并可下钻查看用户单次游戏生命周期内的所有游戏日志信息。具体的使用方式详见下方文档描述。

# 游戏日志筛选

开发者可使用日志筛选区域提供的相关能力，通过选择具体的协议、OpenID、设置日期范围、指标/维度筛选等筛选条件，查询指定条件的日志信息。

# 特别说明

1. 目前仅开放了 小游戏礼包发货、小游戏游戏日志上报、小游戏异常退出上报三个协议，如需查看开发者自主上报的游戏日志信息，请选择 小游戏游戏日志上报 协议。
2. OpenID: OpenID 是小游戏用户唯一的身份标识，可以使用 OpenID 筛选特定用户产生的数据。
3. 筛选条件：每个协议支持不同的数据维度筛选，单维度的筛选条件由三部分（维度、操作符、内容）组成，平台支持的所有操作符如下：

不同的数据维度，根据其数据特性的不同，支持不同的操作符。请以页面展示的可用操作符为准

# 分布与趋势

分布与趋势模块由分布统计饼图和趋势统计折线图组成，开发者可通过此区域查看指标的分布占比情况以及指标的趋势变化/对比统计

注意：该模块默认为收起状态，如需查看，请通过点击「展开分布/趋势」按钮展开

# 分布统计饼图

开发者可通过分布统计饼图查看各维度值的分布情况，并可通过点击饼图扇区，快速添加该扇区对应值的筛选条件，进一步分析对应的维度值数据。

# 趋势统计图

趋势统计折线图默认展示当前协议在过去一段时间内的数据量变化趋势。开发者可以通过趋势统计上面的筛选条件区，设置趋势图的时间粒度、对比项和统计方法。

# 特别说明

1. 时间粒度：最大粒度为 天，最小粒度为 秒（1 个小时内）。
2. 对比项：支持按时间（天数）对比或按维度对比。
3. 统计方法：支持对数据类型为数值的维度进行求和、最大/最小值、分位数等多种方式统计。

# 日志详细数据

日志详细数据区域展示了当前协议的日志详细信息，如下所示：

# 特别说明

1. 列表中的每条日志信息均展示了当前协议下各维度的详细值，表格提供了对维度的排序、单位转换等能力，并且，当维度过多时，开发者可通过左右滑动表格或点击展开按钮的方式，查看维度的完整数据。
2. 协议默认只展示部分维度列，开发者可根据自身需要，通过表格右上角 「配置显示列」按钮，自定义需要展示的维度列（自定义设置将被缓存，无需重复设置）。
3. 当维度值过长时，在相应的维度值后会展示「查看」按钮，开发者可通过点击按钮查看维度值的完整数据，若维度值为 json 格式，开发者可通过「格式化」按钮对数据进行格式化。

# 分析单生命周期的日志数据

针对单生命周期内上报的日志数据，针对小游戏游戏日志上报协议的 TraceId（小游戏实例唯一标识）维度，设计了 TraceId 分析功能，点击详情数据表格 TraceId 数据后的「分析」按钮，可进入 TraceId 分析模式。

页面顶部展示了当前关联日志信息中的公共信息，如设备类型、基础库版本、运行时模式、开发者上报的 commonInfo 等。

开发者可通过日志筛选区域的能力，对当前生命周期内的日志信息进行过滤筛选

# 特别说明

1. 日志信息将按照上报时间 升序 展示，日志的内容格式如下 [time][key] [logInfo]。
2. 不同等级的日志将会是不用不同的背景颜色进行区分。

3. 如果日志是由插件上报的，在日志信息的右侧会展示 ”插件上报“ 标签信息。

# 联系我们

如有任何问题，欢迎扫码联系小助手咨询