设备日志服务

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

应用场景

全天候设备体检

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

• 当消费者有反馈的问题时，设备管理者可通过查看设备的日志情况，复原当时的场景，帮助定位问题并排查问题。

面板端显示日志记录

可以自定义需要在面板上呈现的功能使用记录（DP 记录），当设备使用者消费者操作该 DP 时，就会在面板中显示出来。比如安防的告警记录、门锁的开门记录等，帮助消费者更好的了解该设备的告警和运行情况。

免费版与付费版区别

• 免费版仅可在涂鸦 IoT 开发平台中查询 7 天的日志情况，在面板中也是显示近 7 天的日志。

• 付费版可选择不同的日志类型存储周期，并可针对某些上报的 DP 进行存储周期的延长，您可以按照自己的需求去设置需要查询的日志类型和存储周期。

  在面板中进行调用时，免费版和付费版接口不同，如果开通了付费版，请联系我们的客服人员获取付费版的接口。

产品定价

计费周期

日志服务以天为周期统计每个设备的写入和存储条数。超出阈值的部分按照使用量结算。

费用组成

日志服务按照设备激活后买断付费，设备激活后终身使用。每个设备每天都有一个写入和存储的阈值，超出部分按照写入和存储单独计算，每天统计超额部分，按月计费。

设备单价根据设备一级类目和日志存储周期确定，同时不同的类目和存储周期会有不同的写入和存储阈值。详见下图：

超出阈值的部分，按照写入和存储单独计算，如下图所示：

计费案例

• 案例 1：

  • 每天激活 100 个通用类目设备，选择的存储周期为 1 个月，每个设备写入条数均为 900 条，存储条数均为 20000 条。

  • 一天的费用为 100* 1 元+0+0=100 元，具体明细如下表所示：

  收费项	说明
  设备终生使用费	存储 1 个月的通用类目，设备终生使用单价为 1 元，所以每天的费用为 100*1=100 元。
  超额写入费用	因为每个设备的写入条数小于阈值 1000 条，故没有任何费用。
  超额存储费用	因为每个设备的存储条数小于阈值 30000 条，故没有任何费用。

• 案例 2：

  • 通用类目产品，选择的存储周期为 1 个月，每天没有激活设备，目前共 1 万个设备，每个设备写入条数均为 1100 条，存储条数均为 31000 条。

  • 一天的费用为 0 元 + 1.4 元 + 0.013 = 1.413 元，具体明细如下表所示：

  收费项	说明
  设备终生使用费	没有新增的设备，故此部分费用为 0
  超额写入费用	共 1 万个设备，每个设备每天写入超出阈值为 100 条，所以超额写入费为：10000 * 0.0000014 *（1100-1000）= 1.4
  超额存储费用	共 1 万个设备，每个设备每天存储超出阈值为 1000 条，所以超额写入费为：10000 * 0.0000000013 *（31000-30000）= 0.013

费用计算

在 日志存储服务 开通页面，单击 价格计算器 进入。

进入后选择产品和存储周期，会默认显示该产品近 7 天日均新增激活设备数、日均超额写入条数、日均超额存储条数。您也可以根据输入更合理的数字去进行计算。单击 开始计算 之后得到的每日费用会显示出来。

开通流程

详见 服务开通流程。

产品使用

查看设备日志

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

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

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

   各字段说明如下：

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

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

事件与来源说明

软件复位

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

硬件复位

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

心跳超时（keepalive_timeout）

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

离线时间小于 3 分钟

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

设备重置

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

设备信号量

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

配置日志数据

如果需要配置面板请联系客服或相关的商务，获取相关的 API 接口（如果开通了日志服务可以获取付费的 API 接口）。

常见问题

首次开通第一个月账单费用为何如此高？

首次开通并不会收费，在第一个月账单中不仅包括本月产生的写入超额费用和存储超额费用，还包括历史所有该产品的激活设备的设备终生使用费。在第二个月之后就只会有该月新增的激活设备终生使用费、该月的超额写入费用和超额存储费用。

示例：在开通前激活了 1000 个设备，该产品为通用类目产品，开通时选择了 1 个月的存储。当月新增激活设备 100 个，第二个月新增激活设备 0 个，每个设备每天的写入条数为 900 条，每天的存储条数为 20000 条。因为没有超出写入和存储阈值，故没有超额费用，只有设备终生使用费。

• 第一个月的费用为 （1000+100）* 1=1100 元。
• 第二个月因为没有新增的激活设备，故第二个月费用为 0

设备日志存储服务需要什么前提条件？

已经量产并在市场上销售的产品均可购买设备日志存储服务。

设备日志存储周期有多长？

目前可选的有 1 个月、3 个月、6 个月、1 年、2 年、3 年。

如何延长上报 DP 的存储周期？

在开通页面，选择某个产品之后，在通用配置 项中选择 上报 类型的日志，下面会出现 DP 配置，然后可以选择需要延长某些 DP 的存储周期。如下图所示举例，配置之后就可以在面板中显示 总开关 和 喷雾开关 这两个 DP 3 个月的日志情况。

如何停止计费？

可联系客服取消该服务，在结清费用之后，会在 7 个工作日内取消该服务。