物联网平台控制台的日志服务默认日志存储时间为7天,支持将云端运行日志导出到您阿里云日志服务的日志库(Logstore)中长期存储。开通云端运行日志转储后,您可在物联网平台控制台查询分析日志,查看、订阅日志报表和设置告警通知。

前提条件

已开通日志服务。具体操作,请参见日志服务准备流程

开通云端运行日志转储

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

您需为每个待开通日志转储功能的产品,逐一执行开通操作。

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

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

    • 日志导出服务关联角色:用于获得日志导出权限,请参见角色说明
  7. 设置日志保存时间。
    导出的日志达到日志保存时间后将被删除,默认的日志保存时间为7天,您可设置保存时间为1天~3000天或永久保存。

    云端运行日志转储页签,单击设置日志保存时间,跳转到Logstore管理页面,单击修改,设置数据保存时间,然后单击保存

使用日志查询分析功能

开通云端运行日志转储后,您可在云端运行日志转储页签,进行以下操作:

  • 原始日志页签:
    操作 说明
    查询分析日志 原始日志页签,通过SQL语句查询指定时间内的日志,并进行统计分析。SQL语法详情,请参见查询语法分析语法
    统计图表 统计图表页签,查看生成的统计图表。
    日志聚类 日志聚类页签,聚合相似度高的日志,快速掌握日志全貌。
    快速分析 查询日志后,快速分析日志某一字段在日志查询结果中的分布情况。
    设置告警 当触发告警条件时,系统将通过短信、语音、邮件、钉钉机器人等方式发送告警信息。
  • 日志报表页签:
    操作 说明
    查看报表 查看指定时间内的日志报表。日志报表反映设备运行情况和异常问题。包含项目,请参见下表报表说明

    报表默认展示最近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. 报表说明
    报表 展示样式 说明
    设备上下线次数 折线图 展示指定时间内,设备的上线次数、下线次数。
    设备上线IP按区域分布 地图 展示指定时间内,设备上线IP的区域分布。
    设备上行/下行消息数量 折线图 展示指定时间内,设备上行消息量、下行消息量。
    上行/下行消息量TOP20设备列表 列表 展示上行消息量或下行消息量最多的20个设备,及相应的消息量。
    数据解析脚本错误码分布 饼图 展示指定时间内,脚本解析错误码的分布。

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

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

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

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

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

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

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

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

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

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

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

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

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

停止云端运行日志转储

您可根据业务需求,随时关闭指定产品的云端运行日志转储功能,以便节约存储空间。

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