设备日志服务

更新时间:2024-06-21 06:45:20下载pdf

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

应用场景

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

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

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

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

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

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

存储周期

免费版

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

付费版

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

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

计费方式

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

服务版本

服务版本 年费 每月赠送额度 折扣 设备数和上报量参考示例
基础版 1 万元 1,000 元 83 折 可支持 1 万台设备,每设备每天上报 1,500 条日志,存储 1 个月
高级版 5 万元 6,000 元 7 折 可支持 6 万台设备,每设备每天上报 1,500 条日志,存储 1 个月
旗舰版 10 万元 15,000 元 55 折 可支持 16 万台设备,每设备每天上报 1,500 条日志,存储 1 个月
  • 上表中的 设备数 和设备 上报量 仅供参考。不同的设备每天上报条数差异较大,您可根据实际情况计算。例如,假设一台设备每天上报 15,000 条日志,则基础版设备日志存储服务,可支持存储 1,000 台设备日志一年。
  • 如果用量超出每月 赠送额度,超出的部分需要按量计费,会在次月初出账单。相关费用计算案例,请参考下文 计费案例

费用组成

计费项 计费区间 计费单位 单价(元)
写入费用 所有区 每百万条 1.4
存储费用 所有区 每百万条每天 0.02

写入费用和存储费用均按月统计累计用量,不足一百万条时,按一百万条数据取整。

计费案例一

计费信息 说明
所选版本 基础版
当月日志数
  • 每日写入 1,000w 条,按月统计则为 3 亿条
  • 每日存储 3 亿条
当月费用计算
  • 写入费用:3 亿条 * 1.4 元/百万条 = 420 元
  • 存储费用:3 亿条 * 30 天 * 0.02 元/百万条 天 = 180 元
总费用 420 + 180 = 600 元
是否另行支付 600 元在 1,000 元额度内,无需另行支付

计费案例二

计费信息 说明
所选版本 旗舰版
当月日志数
  • 每日写入 3 亿条,按月统计则为 90 亿条
  • 每日存储 200 亿条
当月费用计算
  • 写入费用:90 亿条 * 1.4 元/百万条 = 12,600 元
  • 存储费用:200 亿条 * 30 天 * 0.02 元/百万条 天 = 12,000 元
总费用 12,600 + 12,000 = 24,600 元
是否另行支付 24,600 元超出了 15,000 元的赠送额度,您还需另行支付 9,600 元账单

开通服务

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

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

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

查看日志

  1. 登录 涂鸦开发者平台

  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?

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