设备日志服务

什么是日志服务

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

说明：设备日志是按照时间排序的设备使用记录。该服务可以将线上已激活设备的日志存储在 涂鸦 IoT 平台 > 产品 > 设备日志，开通后即可实时查看。

应用场景

B 端客户—24小时设备体检

帮助您了解每一台设备与耗材的使用情况，及时为指定用户提供设备维护、更换耗材等服务，实现精准、及时的用户关怀。当消费者有反馈的问题时，可通过查看设备的日志情况，复原当时的场景，帮助定位问题并排查问题。

C 端消费者—面板端显示日志记录

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

说明：默认提供 7 天的免费版本，可通过开通增值服务个性化定义日志存储周期。

免费版与付费版区别

免费版仅可在 涂鸦 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. 首次开通第一个月账单费用为何如此高？

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

举例：

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

第一个月的费用为 （1000+100）* 1=1100 元；

第二个月因为没有新增的激活设备，故第二个月费用为 0

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

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

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

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

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

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

说明：通用配置中的 上报 为所有 DP 点的上报情况，下面的 DP 配置是部分 DP 点的存储周期情况，两者取存储的最大值，比如通用配置中 上报 为 3 个月，下面 DP 配置为 1 个月，那么所有的 DP 依然是存储 3 个月。

5. 如何停止计费？

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

警告：取消服务之后，超出 7 天的日志数据均会被删除，无法恢复。并且下次再开通时，会再重新抽取设备激活后的费用，请慎重处理。

产品使用

在涂鸦 IoT 平台中查看设备日志

登录 涂鸦 IoT 平台，在左侧导航栏中，选择 产品 > 设备管理 > 设备日志 进入设备日志页面。

输入设备 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 接口）。

开通流程

详见 服务开通流程。