简介

为了便于开发调试和远程错误定位，联犀提供了设备本地日志上传功能。可在联犀管理后台关闭/开启单个设备的本地日志功能。

日志级别

级别	说明
1	关闭
2	错误
3	告警
4	信息
5	调试

注意：服务端不对日志等级进行严格限制，建议：

• 后台设置设备日志级别为 5 的时候，设备上报 2、3、4、5 等级日志
• 后台设置设备日志级别为 4 的时候，设备上报 2、3、4 等级日志
• 以此类推

Topic 介绍

1. 设备主动查询服务端设置的日志等级

上行 Topic： $log/up/operation/{productID}/{deviceName}

{
  "method": "getStatus",
  "timestamp": 1654844328734,
  "msgToken": "xxxxxx"
}

下行 Topic： $log/down/operation/{productID}/{deviceName}

{
  "method": "getStatusReply",
  "msgToken": "xxxxxxx",
  "timestamp": 1654844328734,
  "code": 200,
  "msg": "成功",
  "data": {
    "logLevel": 2
  }
}

2. 日志直传

上行 Topic： $log/up/report/{productID}/{deviceName}

参数说明：

• logLevel：日志级别（2)错误 3)告警 4)信息 5)调试），不传默认为 5
• content：日志内容，在后台将以文本形式直接展示
• timestamp：日志时间戳

{
  "method": "reportInfo",
  "timestamp": 1654844328734,
  "msgToken": "xxxxxx",
  "params": [
    {
      "timestamp": 1654844328734,
      "logLevel": 5,
      "content": "long string,不要超过500k"
    },
    {
      "timestamp": 1654844328734,
      "logLevel": 4,
      "content": "long string"
    },
    {
      "timestamp": 1654844328734,
      "content": "sdsdadasfafasdf sdfasd sadfasdf sdfsdfs sdf4asdfsdf"
    }
  ]
}

下行 Topic： $log/down/report/{productID}/{deviceName}

{
  "method": "reportReply",
  "msgToken": "xxxxxx",
  "timestamp": 1656553866096,
  "code": 200,
  "msg": "成功"
}

3. 服务端主动推送修改日志等级

下行 Topic： $log/down/update/{productID}/{deviceName}

{
  "method": "getStatusReply",
  "msgToken": "xxxxxx",
  "code": 200,
  "msg": "成功",
  "data": {
    "logLevel": 1
  }
}

使用建议

1. 日志级别设置：根据实际需求合理设置日志级别，避免产生过多无用日志
2. 日志内容：日志内容应简洁明了，便于问题定位
3. 时间戳：确保设备时间同步，日志时间戳准确
4. 性能考虑：日志上报频率不宜过高，避免影响设备性能