文档首页/ 设备接入 IoTDA/ API参考/ 设备侧MQTT/MQTTS接口参考/ 设备日志收集/ 设备上报日志内容
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

设备上报日志内容

Topic

上行: $oc/devices/{device_id}/sys/events/up

接口功能

日志收集开关开启时设备使用该接口向平台上报日志内容，最大不超过1MB。

参数说明

字段名

必选/可选

类型

参数描述

services

可选

List<ServiceEvent>

参数解释：

事件服务列表。

ServiceEvent定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

参数解释：

系统字段。

取值范围：

固定为："$log"。

event_type

必选

String

参数解释：

系统字段。

取值范围：

固定为："log_report"。

event_time

可选

String

参数解释：

事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。

设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。

paras

必选

Object

参数解释：

设备服务的事件列表，具体字段在设备关联的产品模型中定义。

paras参数列表

字段名

必选/可选

类型

参数描述

timestamp

可选

String

参数解释：

日志产生时间。

type

必选

String

参数解释：

日志类型。

取值范围：

DEVICE_STATUS ：设备状态。

DEVICE_PROPERTY ：设备属性。

DEVICE_MESSAGE ：设备消息。

DEVICE_COMMAND：设备命令。

content

必选

String

参数解释：

日志内容。

示例

Topic: $oc/devices/{device_id}/sys/events/up   
数据格式：  
{ 
    "services": [{ 
        "service_id": "$log", 
        "event_type": "log_report", 
        "event_time": "20151212T121212Z",
        "paras": { 
            "timestamp": "1235668997",
            "type": "DEVICE_MESSAGE",
            "content": "log content"
        } 
    }] 
}
父主题： 设备日志收集