设备日志服务

设备日志是指按照时间排序的设备使用记录。涂鸦 设备日志存储服务 提供线上已激活设备使用数据的近实时记录与长周期存储服务，安全灵活，提升数据运营力。

应用场景

• 全天候设备记录与观测：

  • 帮助设备管理者了解设备与耗材的使用情况，及时为指定用户提供设备维护、更换耗材等服务。

  • 针对用户的问题反馈，设备管理者可通过查看设备的日志情况，复原场景、定位问题、排查问题。

• 用户面板显示日志记录：

  自定义在面板上呈现的功能使用记录（即 DP 记录），当用户操作该 DP 时，就会在面板中显示出来。

  例如，安防的告警记录、门锁的开门记录等，帮助用户更好地了解该设备的告警和运行情况。

存储周期

免费版

在 涂鸦 IoT 开发平台 默认可查询近 7 天的设备日志情况，在面板中同样显示近 7 天的日志。

付费版

开通 设备日志存储服务 后，可选择不同的日志类型存储周期。目前可选的有 1 个月、3 个月、6 个月、1 年、2 年、3 年。同时，您可以：

• 针对某些上报的 DP 进行存储周期的延长。
• 自定义设置需要查询的日志类型和存储周期。

计费方式

设备日志存储服务 按月统计累计用量。

服务版本

费用组成

计费案例一

计费案例二

开通服务

1. 请访问 设备日志存储增值服务 进行开通。

2. 开通了付费版，请联系涂鸦客服人员获取付费版面板调试接口。

   在面板中进行调用时，免费版和付费版接口不同。

查看日志

1. 登录 涂鸦 IoT 开发平台。

2. 在左侧导航栏中，选择 产品 > 设备管理 > 设备日志 进入设备日志页面。

3. 输入设备 ID，默认搜索近 7 天的日志。可以按照功能 ID、日志类型、日志时间进行筛选。

   

   字段	说明
   时间	根据所选时区后转换的时间。
   设备事件	日志的类型。
   事件名称	具体的事件名称，上报和下发类型的日志展示的是具体的 DP 功能。
   事件详情	日志上报的内容，如果是上报和下发则为某 DP 上报的内容。
   来源	分为设备本身、云端、客户端、第三方语音平台。
   来源详情	触发该事件的原因。例如，来源是第三方语音平台，这里的来源详情可能就为 Alexa。

   默认您可以查看近 7 天的数据，如果您开通了 设备日志存储服务，则可以查看更长时间的日志数据。

日志事件与来源

• 软件复位

  设备首次激活配网，正常配网成功，云端会记录事件详情为 软件复位。

  

• 硬件复位

  当模组 Vcc 通断电或 RST 脚低电平复位后，再上电连⽹成功，云端会记录事件详情为 硬件复位。

  

• 心跳超时（keepalive_timeout）

  如果模组离线超过 3 分钟，云端会有 keepalive_timeout（⼼跳超时） 的⽇志，记录事件为下线。再次连到路由器时会记录事件为上线。

  

• 离线时间小于 3 分钟

  如果离线时间⼩于 3 分钟内再次连⽹，日志中只会显示上线的记录。如果⽹络⼀直不稳定在重复连⽹和断⽹，云端⽇志就会记录多条上线记录。

  

• 设备重置

  在 App 上移除设备或恢复出⼚设置使设备进⼊待配⽹状态，云端会记录事件为 设备重置，并会在来源详情⼀栏标识出详细原因。

  

• 设备信号量

  设备信号量的值越大表示信号越好。信号强弱参考下表：

  信号量的值	信号强弱
  小于等于 -100	没有信号
  -100 到 -66 之间	信号较差
  -66 到 -55 之间	信号正常
  大于 -55	信号较好
  等于 99	接入方式为有线接入

配置日志数据

如果开通了设备日志服务，可以获取付费的 API。如果需要配置面板，请联系您的涂鸦客户经理或运营人员，获取相关的 API。

常见问题

如何选择不同的设备日志服务版本？

越高级的服务版本折扣越高，但是同时也要关注设备真实的用量，费用主要跟写入条数和存储的条数有关。

1w 的基础版大概可以供：

• 1w 台设备，每个设备每天上报 1500 条日志使用。

• 10w 台设备，每个设备每天上报 150 条日志使用。

  ……

您可以按照当前设备量、上报频率、以及预估未来一年激活设备数进行预估。

一个账号下有多个产品，是否需要多次开通服务？

不需要。

开通设备日志存储服务后，您的 IoT 账号可在任意数据区，针对任意 PID 去选择设置日志存储，费用会合在一起计算。

多次开通服务，结果会怎样？

多次购买并不会提升服务版本量，而是生效周期会延长。

例如，您购买了两次基础版服务，那么不是这一年有 2 万的额度，而是该服务有 2 年的有效期。

如何只存储部分上报的 DP 和下发的 DP？

该部分选择目前无法在 涂鸦 IoT 开发平台 上直接勾选。如果有此需求，请联系您的涂鸦客户经理或运营人员。