文档

云端运行日志转储

更新时间:

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

前提条件

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

使用说明

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

开通日志转储至阿里云日志服务的日志库(Logstore),会按照阿里云日志服务计费标准进行收费。详细内容,请参见日志服务的计费说明

开通云端运行日志转储

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

  1. 登录物联网平台控制台
  2. 实例概览页签的全部环境下,找到对应的实例,单击实例卡片。

  3. 在左侧导航栏,选择监控运维 > 日志服务
  4. 选择产品,单击云端运行日志转储页签。
  5. 单击立即开启
  6. 阅读弹出对话框中的说明,然后完成云端运行日志转储的开启。
    说明 若还未开通日志服务,单击立即开启将跳转到日志服务开通入口。
    1. 依次单击角色日志转储位置右侧的创建
      说明 角色日志转储位置右侧显示已创建,则跳过此操作。
    2. 单击确定
    产品开通云端运行日志转储后,系统自动创建日志存储位置和日志导出服务关联角色。
    • 日志导出服务关联角色:用于获得日志导出权限,请参见角色说明
    • 日志存储位置:
      • 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中。已导出的日志仍保留,达到设置的日志保存时间后被删除。
  • 本页导读 (1)