物联网平台控制台的日志服务默认支持存储7天内的日志,同时支持将云端运行日志导出到您的阿里云日志服务的Logstore中进行长期存储。开通日志转储后,支持在物联网平台控制台查询分析日志,并提供日志报表、报表订阅、告警通知等功能。

前提条件

已开通日志服务,参见日志服务准备流程

开通日志转储

说明 日志转储功能暂时仅支持主账号使用。

需要为每一个需要开通日志转储功能的产品逐一进行开通操作。

  1. 登录物联网平台控制台
  2. 在左侧导航栏,选择监控运维 > 日志服务
  3. 选择产品,单击日志转储页签。
  4. 单击立即开启
  5. 阅读弹出对话框中的说明,单击确定
    说明 若还未开通日志服务,单击立即开启将跳转到日志服务开通入口。
    产品开通日志转储功能,系统自动创建日志存储位置、日志导出服务关联角色。
    • 日志存储位置:
      • Project:iot-log-${uid}-${regionId}。其中,${uid}是您的阿里云账号ID,${regionId}是您的物联网平台服务所在地域代码。
      • Logstore:iot-logs。

      您的所有产品共用该存储位置,不同产品通过日志内容关键字ProductKey区分。详细日志说明,请参见云端运行日志

    • 日志导出服务关联角色:用于获得日志导出权限,请参见角色说明
  6. 设置日志保存时间。导出的日志达到日志保存时间后将被删除,默认的日志保存时间为7天,可以设置为保存1天~3000天或永久保存。
    单击设置日志保存时间,跳转到Logstore管理页面,单击修改,设置后单击保存

使用日志查询分析功能

开通日志转储后,您可以在物联网平台控制台选择监控运维 > 日志服务 > 日志转储,进行以下操作:
  • 查询分析日志:在原始日志页签,通过SQL语句查询指定时间内的日志,并进行统计分析,生成统计图表。SQL语法请参见查询语法分析语法,使用统计图表请参见分析图表
  • 快速分析:在原始日志页签查询日志后,快速分析日志某一字段在日志查询结果中的分布情况,请参见快速分析
  • 查看报表:在日志报表页签,查看指定时间内的日志报表。日志报表反映设备运行情况和异常问题。包含以下项目:
    报表 说明
    设备上下线次数 折线图展示指定时间内,设备的上线次数、下线次数。
    设备上线IP按区域分布 地图展示指定时间内,设备上线IP的区域分布。
    设备上行/下行消息数量 折线图展示指定时间内,设备上行消息量、下行消息量。
    上行/下行消息量TOP20设备列表 列表展示上行消息量或下行消息量最多的20个设备,及相应的消息量。
    数据解析脚本错误码分布 饼图展示指定时间内,脚本解析错误码的分布。

    您可以通过错误码查询日志,查看日志中的脚本解析错误详情,有针对性地优化脚本。

    数据解析脚本错误TOP10设备列表 列表展示指定时间内,发生脚本解析错误最多的10个设备,及相应的错误数量。

    您可以通过设备DeviceName查询日志,查看日志中脚本解析的错误详情,有针对性地优化脚本。

    物模型校验错误码分布 饼图展示指定时间内,物模型校验错误码的分布。

    您可以通过错误码查询日志,查看日志中的物模型校验错误详情,定位问题。

    物模型校验错误TOP10设备列表 列表展示指定时间内,发生物模型校验错误最多的10个设备,及相应的错误数量。

    您可以通过设备DeviceName查询日志,查看日志中的物模型校验错误详情,定位问题。

    服务端订阅流转消息量 折线图展示指定时间内,AMQP、MNS服务端订阅的流转消息量。
    最近20条设备异常消息记录 饼图展示指定时间内,最近20条设备异常消息记录。

    您可以通过设备DeviceName和错误码查询日志,查看日志中的设备异常消息详情,定位问题。

    云产品流转消息量 折线图展示指定时间内,云产品流转消息量。
    最近20条规则引擎流转异常记录 列表展示指定时间内,最近20条规则引擎流转异常记录。

    您可以通过设备DeviceName和错误码查询日志,查看日志中的规则引擎流转异常详情,定位问题。

    云端API调用错误分布 饼图展示指定时间内,云端API调用错误分布。

    你可以通过API名称查询日志,通过日志详情和错误码定位问题。

    报表时间范围和时间粒度说明:

    • 报表默认展示最近1小时(整点时间)的数据,折线图的粒度为1分钟。
    • 设置时间范围,可在页面右上角单击蓝色的时间设置下拉框,或在单个报表右上角单击按钮>选择时间范围进行设置。
    • 设置折线图的时间粒度,需要在原始日志页签使用SQL语言进行设置。相关语法请参见日期和时间函数

      例如:使用bizCode:device | SELECT date_format(date_trunc('hour',__time__), '%m-%d %H:%i') AS Time, count(1) AS count , operation GROUP BY Time, operation ORDER BY Time limit 1440,将时间粒度设为1小时。

  • 订阅报表:系统定期将报表渲染为图片,通过邮件、钉钉机器人发送给指定人员。订阅报表操作请参见订阅仪表盘
  • 设置告警:当触发告警条件时,系统将通过短信、语音、邮件、钉钉机器人等方式发送告警信息。设置告警操作请参见设置告警

停止日志转储

产品的日志转储功能可以按需求随时关闭,以便节约存储空间。停止某个产品的日志转储功能操作为:

  1. 登录物联网平台控制台
  2. 在左侧导航栏,选择监控运维 > 日志服务
  3. 选择产品,单击日志转储页签。
  4. 单击停止转储,单击确认后停止该产品的日志转储功能。
    新产生的日志不再导出到Logstore中。已导出的日志仍保留,达到设置的日志保存时间后被删除。