跳转至

errDump

一、errDump 功能概述

LuatOS-Air 错误日志上报功能模块名叫:errDump,errDump 对“量产投放市场的设备,远程调试初步定位问题”至关重要, 强烈建议客户一定要使用此功能

errDump 就是将模块运行过程中产生的错误信息或者应用日志通过 TCP/UDP 上报到互联网上的指定服务器,技术人员可以在服务器上查阅日志,协助远程了解设备运行情况,或者故障诊断。

使用合宙云服务器时,迫于服务器压力,只有手动打开 debug 开关(见后面第六节代码示例介绍),才有日志上报(当使用合宙调试服务器时,开机前先检查一下 log 开关,每 2 小时查询一次 log 开关,如果开关未开启,则不允许上传调试日志),打开方式见《三、实例介绍》

二、演示功能概述

本示例将演示上报错误日志的功能。

三、准备硬件环境

3.1 Air201 模组一套

本文以 Air201模组 为例,如下图所示:

点击链接购买:合宙Air201模组淘宝购买链接

此模组的详细使用说明参考:Air201 产品手册

3.2 SIM 卡

请准备一张可正常上网的 SIM 卡,该卡可以是物联网卡或您的个人手机卡。

特别提醒:请确保 SIM 卡未欠费且网络功能正常,以便顺利进行后续操作。

3.3 数据通信线

typec 接口 USB 数据线即可。

3.4 PC 电脑

WIN10以及以上版本的WINDOWS系统。

四、准备软件环境

2.1 基本的下载调试工具

使用说明参考:Luatools 下载和详细使用

五、errDump 软硬件资料

本文通过 demo 演示来说明本章节内容的基本用法。

5.1 源码和工具

5.2 demo使用api介绍

errDump.config(enable, period, user_flag, custom_id, host, port)

作用:配置关键日志上传至 IOT 平台,包括引起 Lua VM 异常退出的日志和用户通过 record 写入的日志,类似于 Air 的 errDump。

参数

参数 传入值类型 解释
enable boolean 是否启用记录功能,false 时不记录任何日志
period int 定时上传周期,单位秒,默认 600 秒。此为自动上传后的重试时间,开机或 record 操作后会尝试快速上传至 IOT 平台。如果为 0,则不自动上传,由用户 dump 后上传至自己的平台
user_flag string 用户的特殊标识,可为空
custom_id string 设备识别号,4G 设备默认是 IMEI,其他设备默认是 mcu.unique_id
host string 服务器域名,默认 dev_msg1.openluat.com
port int 服务器端口,默认 12425,为合宙云平台默认端口

返回值

返回值类型 解释
nil 无返回值

errDump.dump(zbuff, type, isDelete)

作用:手动读取异常日志,用于将日志发送至用户自有服务器而非 IOT 平台。如果在 errDump.config 中配置了周期上传,则不可使用本函数。

参数

参数 传入值类型 解释
zbuff zbuff 日志信息缓存,若为 nil 则不会读取日志
type int 日志类型,目前支持 errDump.TYPE_SYS 和 errDump.TYPE_USR
isDelete boolean 是否删除日志

返回值

返回值类型 解释
boolean true 表示在本次读取前无数据写入,false 表示有数据写入。删除日志前建议再次读取以确保无新数据写入

errDump.record(msg)

作用:写入用户异常日志,注意最大仅为 4KB,超过部分会覆盖旧数据。开启自动上传后会上传至 IOT 平台。

参数

参数 传入值类型 解释
msg string 用户日志

返回值

返回值类型 解释
nil 无返回值

六、代码示例介绍

6.1 上传错误日志到合宙云平台

6.1.1 云平台配置

合宙云平台:https://iot.openluat.com

6.1.1.1 打开 IoT 平台

6.1.1.2 新建一个项目

6.1.1.3 将你自己建的项目 key 复制到 demo 中

6.1.1.4 打开设备 DEBUG 开关

6.1.2 demo 介绍

这里测试用的是合宙云平台上报。

demo 程序中打开自动上报合宙云平台部分,注释掉手动获取信息部分。

使用合宙云平台查看上报错误信息的话,代码更改如下:

PROJECT = "errdump_test"
VERSION = "1.0"
PRODUCT_KEY = "yIobDFbJ4LSIk6eDHj1kLl8VSmHaDsp4" --换成自己的
-- sys库是标配
_G.sys = require("sys")
_G.sysplus = require("sysplus")
log.style(1)

--下面演示自动发送
errDump.config(true, 600, "user_id")    -- 默认是关闭,用这个可以额外添加用户标识,比如用户自定义的ID之类

local function test_user_log()
    while true do
        sys.wait(15000)
        errDump.record("测试一下用户的记录功能")
    end
end

local function test_error_log()
    sys.wait(60000)
    lllllllllog.record("测试一下用户的记录功能") --默认写错代码死机
end

-- -- 下面演示手动获取信息
-- errDump.config(true, 0)
-- local function test_user_log()
--  local buff = zbuff.create(4096)
--  local new_flag = errDump.dump(buff, errDump.TYPE_SYS)       -- 开机手动读取一次异常日志
--  if buff:used() > 0 then
--      log.info(buff:toStr(0, buff:used()))    -- 打印出异常日志
--  end
--  new_flag = errDump.dump(buff, errDump.TYPE_SYS)
--  if not new_flag then
--      log.info("没有新数据了,删除系统错误日志")
--      errDump.dump(nil, errDump.TYPE_SYS, true)
--  end
--  while true do
--      sys.wait(15000)
--      errDump.record("测试一下用户的记录功能")
--      local new_flag = errDump.dump(buff, errDump.TYPE_USR)
--      if new_flag then
--          log.info("errBuff", buff:toStr(0, buff:used()))
--      end
--      new_flag = errDump.dump(buff, errDump.TYPE_USR)
--      if not new_flag then
--          log.info("没有新数据了,删除用户错误日志")
--          errDump.dump(nil, errDump.TYPE_USR, true)
--      end

--  end
-- end

-- local function test_error_log()
--  sys.wait(60000)
--  lllllllllog.record("测试一下用户的记录功能") --默认写错代码死机
-- end

sys.taskInit(test_user_log)
sys.taskInit(test_error_log)
sys.run()

七、功能验证

7.1 Luatools 日志打印

7.2 云平台查看错误上报

八、总结

本示例介绍了将错误日志上报到合宙云平台的功能。

扩展

常见问题