OneNET Studio 简介
产品介绍
快速入门
设备接入与管理
设备接入流程
创建产品
开发产品物模型
数据解析
创建设备
转移设备
文件管理
远程配置
标准协议接入
泛协议接入
物模版库
生态接入认证
应用开发
应用开发流程
新建项目
添加设备
设备分组
场景联动
应用数据流转
应用API
运维监控
数据可视化
边缘计算
人工智能AI
位置定位
语音通话
工业互联网标识
权限管理
服务协议
更新日志
使用说明
安全鉴权
错误码
SDK下载
设备管理类
应用开发类
应用长连接
规则引擎（新）
项目概况
项目集成产品列表
项目集成设备列表
项目添加设备
项目移除设备
分组创建
分组删除
分组编辑
分组详情
分组列表
分组设备添加
分组设备移除
设备详情
设备状态查询
设备状态记录查询
设备属性设置
设备属性获取
设备属性期望设置
设备属性期望查询
设备属性期望删除
设备操作日志查询
设备最新数据查询
设备属性记录查询
设备事件记录查询
设备服务调用
设备服务执行记录查询
设备文件上传
设备文件下载
设备文件删除
账户文件列表查询
账户文件存储空间查询
账户设备文件数量查询
场景联动规则创建
场景联动规则编辑
场景联动规则详情
场景联动规则列表
场景联动触发日志
LwM2M-IPSO类
设备日志
1.功能概述
设备日志是在设备行为（设备上下线）、上行消息(设备通过Topic上报数据(属性、事件)到云端、设备侧属性期望操作)、下行消息 (通过开放API、控制台给设备下发消息、更新期望等)以及各云后业务处理（物模型调用、存储、规则引擎、HTTP推送、MQ推送）等业务过程中的全链路业务处理记录，通过设备日志功能，用户可以非常方便、迅速地监控业务运行状态和排查运行时问题。
OneNET Studio 面向用全量开放内部服务全链路日志，用户可通过每条链路唯一的链路ID追踪每条访问请求以及该请求的相应触发消息的处理情况，便于用户实时消息追踪与定位问题。 设备日志功能具有以下特点：
(1) 内存级索引查询，多条件查询优化
(2) 24小时不间断监控，实时展示用户业务运行状态
(3) 更加直观地向用户展示系统业务架构和用户的每个业务流程
(4) 更加快速的问题朔源和故障定位系统，对用户友好，降低用户使用成本
(5) 提供上下行原始消息缓存，助力用户精准地分析问题
(6) 集中的标准化日志管理、查询，高可拓展性，其它业务模块可以进行快速接入
(7) 用户级业务日志暴露，用户可自主查询绝大多数的设备侧操作日志，无需通过工单排查问题
2.查询设备日志
(1) 登录物联网平台控制台。
(2) 在左侧导航栏，单击监控运维 > 设备日志，进入设备日志页签。
(3) 选择产品，输入搜索条件，然后单击搜索图标。
支持的搜索条件如下表。
| 搜索条件 | 说明 |
|---|---|
| DeviceName | 输入设备名称。根据设备名称，搜索该设备的相关日志。 |
| TraceId | 输入追踪ID，搜索串联模块日志。 |
| 消息ID | 消息ID |
| 日志状态 | 执行日志的状态，可选择：日志状态（全部）、成功、失败 |
| 业务类型 | 选择要查询的业务类型，可选择：业务类型（全部）、设备行为、上行消息、下行消息、物模型调用、数据存储、规则引擎、MQ推送、HTTP推送、开放API、应用长连接 |
| 时间范围 | 选择要查询日志的时间范围，可选择：近15分钟、近1小时、近4小时、近24小时、近7天、自定义 |
日志字段说明
设备日志列表中包含的字段说明如下表。
| 参数 | 含义 | 备注 |
|---|---|---|
| 日志时间 | 日志打印时间。 | 业务开始时间，格式yyyy-MM-dd HH:mm:ss.SSS，精确到毫秒 |
| 设备名称 | 设备名称。 | 无 |
| 链路ID | 追踪ID，可用于搜索串联模块。 | 32位，一条消息在系统内部各个服务模块流转以及相关触发消息的唯一标识ID |
| 消息ID | 该条日志的消息ID | 设备与平台上下行消息的消息唯一标识，用户可根据消息ID，查询消息通信数据内容，消息查询时效性为一天（自然天，当天可查当天，跨天则不可查询），目前仅上行消息、下行消息有消息ID，具体消息可在操作栏点击详情进入日志详情页面查看。 |
| 业务类型 | 默认显示所有业务类型的日志，您可以仅查询某一业务类型的日志。-设备行为-上行消息-下行消息-物模型调用-数据存储-规则引擎-MQ推送-HTTP推送-开放API-应用长连接 | 日志的业务类型，由各个服务定义 |
| 日志状态 | 日志执行的结果状态 | 200代表成功，其它状态定义码参见日志业务状态码 |
| 日志内容 | 日志执行的内容 | 详细的日志输出内容 |
3.日志业务类型及状态码
日志业务类型
| 服务模块 | 日志类型 | 日志触发时机 |
|---|---|---|
| CoAP/MQTT接入服务 | 设备行为类 | 设备上/下线、设备心跳（目前仅CoAP协议支持） |
| 上行消息 | 设备侧上报（设备上报属性、事件），设备侧期望操作（设备获取、删除属性期望值），平台侧属性设置操作设备回复 | |
| 下行消息 | 设备上报属性、事件平台回复，设备获取、删除属性期望值平台回复，平台侧属性设置操作 | |
| 物模型服务 | 物模型调用 | 见下表业务日志状态码中的物模型服务模块说明 |
| 数据存储服务 | 数据存储 | 暂未接入 |
| 规则引擎服务 | 规则引擎 | 当配置了相应产品、设备的消费规则时，见下表业务日志状态码中的规则引擎服务模块说明 |
| MQ推送服务 | MQ推送 | 暂未接入 |
| HTTP推送服务 | HTTP推送 | 当推送数据被消费时，见下表业务日志状态码中的HTTP推送服务模块说明 |
| 开放API服务 | 开放API | 使用API进行属性设备、属性期望值查询、更新、删除等操作时，见下表业务日志状态码中的开放API服务模块说明 |
业务日志状态码
| 服务模块 | 状态码 | 消息 | 原因 | 排查步骤 |
|---|---|---|---|---|
| 通用 | 200 | - | 成功 | |
| MQTT接入服务 | 1001 | rpc failed | rpc调用失败（上行） | 请通过提交工单进行排查 |
| 1002 | thing error | 物模型服务错误 | 根据返回的desc信息排查设备数据 | |
| 1021 | channel not writable | 设备socket不可写（下行） | 设备正在断开连接或设备接收的tcp缓冲区已满，排查设备状态 | |
| 1022 | subscription not exist | 订阅不存在,设备未订阅主题(无法推送下行消息) | 排查设备是否订阅了接收下行消息的topic | |
| 1023 | device replied but timeout | 设备在超时时间后才回复设备设置属性 | 请排查设备是否在超时时间后才回复设备设置属性 | |
| 1024 | session not exist | 设备session不存在（下行） | 请通过提交工单进行排查 | |
| 1025 | duplicate id | 重复的下行id（下行） | 请通过提交工单进行排查 | |
| 1026 | internal error | 接入机内部错误 | 请通过提交工单进行排查 | |
| 1027 | invalid id field or json format error | set_reply响应中id字段错误(不存在或类型错误)或json格式错误 | 排查是否为合法json格式，及id字段是否存在或是字符串类型 | |
| 1028 | id not found | id未找到 | 排查设备是否在超时时间到期后回复了设置属性 | |
| 1101 | invalid argument | 无效的参数 | 无效的鉴权参数，排查填写的clientId、userName、password字段是否为空 | |
| 1102 | internal error | 内部错误 | 请通过提交工单进行排查 | |
| 1103 | invalid token | 无效的token | 排查设备token字段是否填写正确(有且仅包括et、version、method、res、sign等) | |
| 1104 | token expired | token已过期 | 检查token的过期时间 | |
| 1105 | seckey not found | 设备/产品sec_key未找到 | 请通过提交工单进行排查 | |
| 1106 | sign not match | 签名不匹配 | 检查设备token中sign签名是否计算正确 | |
| 1107 | device not found | 根据pid + dev_name未找到设备 | 排查设备是否真实(产品id + 设备名称)存在 | |
| 1108 | internal pid not found | 未找到对应的内部产品id | 请通过提交工单进行排查 | |
| 1109 | internal device id not found | 未找到对应的内部设备id | 请通过提交工单进行排查 | |
| 1110 | sign method not supported | 不支持的签名算法 | 检查token中的method是否被平台支持 | |
| 1111 | invalid version | 非法的版本号 | 检查token中的version字段是否正确 | |
| 1112 | protocol not match | 协议不匹配 | 检查设备协议类型是否与连接的接入服务匹配 | |
| 1114 | argument not match with token | 输入的参数与token不匹配 | 检查填写的clientId、userName字段是否与token中res字段中的一致(clientId填写设备名称、userName为产品id) | |
| 1201 | invalid argument | 无效的参数 | 请通过提交工单进行排查 | |
| 1202 | internal error | 内部错误 | 请通过提交工单进行排查 | |
| 1204 | session not exist | 设备session未找到 | 请通过提交工单进行排查 | |
| 1210 | login on other acceptor | 该设备/协议适配服务实例已登录到其他接入机 | 请通过提交工单进行排查 | |
| 1401 | abnormal offline | 设备异常离线 | 请查看日志中的offline_reason以便获取具体原因 | |
| CoAP接入服务 | 400 | coap_bad-request | 错误请求 | CoAP请求报文格式错误，（请检查参数、编码等是否正确） |
| 401 | coap_unauthorized | 鉴权失败 | 设备鉴权信息不匹配 | |
| 403 | coap_forbidden | 禁止上行 | 设备上行消息速率超过平台限制 | |
| 404 | coap_not-found | 找不到对应设备资源 | 设备可能已在平台离线 | |
| 405 | coap_method-not-allowed | 该资源不允许当前请求方式（GET/PUT/POST/DELETE） | 请根据平台使用规范使用CoAP请求方式 | |
| 406 | coap_not-acceptable | 无可返回的消息格式 | 平台暂无法返回该种消息格式 | |
| 415 | coap_unsupported-content-format | 不支持的特殊消息格式 | 平台暂不支持该种消息格式 | |
| 500 | internal_server_error | 内部错误 | 请通过提交工单进行排查 | |
| 601 | time_out | 下行命令请求超时 | 检查设备是否回复响应，若回复，请通过提交工单进行排查 | |
| 602 | req_param_error | 请求格式错误 | 请通过提交工单进行排查 | |
| 603 | resp_error | 回复格式错误 | 检查设备回复格式，若仍有问题，请通过提交工单进行排查 | |
| 604 | offline | 设备已离线 | 请重新上线设备 | |
| 605 | addr_occupied | 地址被占用 | 该设备地址已被其他设备占用 | |
| 606 | limit | CoAP接入服务策略限制 | 请根据平台限流规则使用 | |
| 物模型服务 | 301 | json format error | json格式错误 | 请确认数据格式重试 |
| 302 | data type error | 数据类型错误 | 请确认数据格式重试 | |
| 303 | internal error | 内部错误 | 请通过提交工单进行排查。 | |
| 304 | resp error | 返回错误 | 请确认属性设置响应数据格式后重试 | |
| 305 | no thing-model | 物模型定义不存在 | 请确认产品下有物模型的定义后重试 | |
| 306 | timeout | 属性设置响应超时 | 请确认设备有无响应属性设置消息 | |
| 307 | invalid pid or devName | 请求中pid或devicename不合法 | 请确认pid和devName是有效数据后重试 | |
| 308 | device not online | 设备不在线 | 请检查设备是否在线 | |
| 309 | identifier not exist | 标识符不存在 | 请检查标识符是否存在 | |
| 310 | mqtt acc error | MQTT接入服务调用失败 | 请通过链路ID查询链路上对应的MQTT接入服务日志进行排查 | |
| 311 | coap acc error | CoAP接入服务调用失败 | 请通过链路ID查询链路上对应的CoAP接入服务日志进行排查 | |
| 312 | invalid msg id | 消息id不符合规范 | 请检查消息id是否是不超过13位的字符串类型的数字 | |
| 313 | bad request | 请求不合法 | 请确认请求正确后重试 | |
| 规则引擎服务 | 900 | internal error | 内部错误 | 请通过提交工单进行排查。 |
| 901 | format error | 数据格式错误 | 请确认数据格式后重试 | |
| HTTP推送服务 | 2001 | code error | 状态码错误 | HTTP响应未正常返回200状态码 |
| 3001 | parameter error | 参数错误 | 请确认数据格式后重试 | |
| 3002 | service degradation | 推送超时服务降级 | 请确认网络是否正常 | |
| 3003 | failures reached the maximum number | 重推次数达到上限 | 请确认服务是否正常 | |
| 4001 | send failed | 推送失败 | 请通过提交工单进行排查 | |
| 开放API服务 | 800 | internal error | 内部服务错误 | 请通过提交工单进行排查 |
| 801 | rpc failed | rpc调用失败 | 请通过提交工单进行排查 | |
| 802 | thing sevice error | 物模型命令服务调用失败 | 请通过链路ID查询链路上对应的物模型日志进行排查 |
这篇文档是否帮助您解决了问题?