云端运行日志

物联网平台控制台提供云端运行日志,包含物联网平台、设备、您的应用程序三者之间的交互通信记录。通过日志记录的消息内容、业务类型、操作类型和状态码等信息,可以了解设备状态、通信情况,并定位操作失败的原因,帮助您监控和管理设备,进行故障排查。本文介绍如何查看云端运行日志,以及相关错误码和排错方法。

日志业务类型说明

上行消息的日志业务类型如下图所示。

上行消息日志

  1. 物联网平台接收设备上报数据,并打印设备到物联网平台的消息日志,包含消息的Topic。

  2. 对于数据处理的不同业务模块,分别打印各模块的日志。

  3. 如果消息通过云产品流转和服务端订阅(AMQP、MNS服务端订阅),对外发送给客户,将打印规则引擎(云产品流转)、服务端订阅模块的日志。

下行消息的日志业务类型如下图所示。

下行消息日志

  1. 用户通过API调用产生消息,打印API调用日志,包含API名称。

  2. 对于数据处理的不同业务模块,分别打印各模块的日志。

  3. 如果有消息发送到设备侧,物联网平台打印云端到设备的消息日志,包含消息的Topic。

查询云端运行日志

  1. 登录物联网平台控制台

  2. 实例概览页签的全部环境下,找到对应的实例,单击实例卡片。

  3. 在左侧导航栏,选择监控运维 > 日志服务,进入云端运行日志页签。

  4. 选择产品,输入搜索条件,然后单击搜索图标。

    支持的搜索条件如下表。

    重要

    如果输入的搜索条件(如设备名称、内容关键字等),包含以下特殊字符, '";=()[]{}?@&<>/:\n\t\r,输入内容会被拆分为多个词,从而导致查询日志失败,页面会出现报错提示:日志查询,查询参数异常

    搜索条件

    说明

    DeviceName

    输入设备名称。根据设备名称,搜索该设备的相关日志。

    TraceId

    输入追踪ID,搜索串联模块日志。

    内容关键字

    输入日志内容的任意关键字搜索日志。

    MessageID

    消息ID,物联网平台为消息生成的唯一标识符。

    仅上、下行消息分析支持根据MessageID搜索日志。

    状态

    查询某种结果状态的日志。可选择:

    • 全部状态

    • 成功:状态码为200。

    • 失败:其他状态码。

    业务类型

    选择要查询日志所属业务类型。

    时间范围

    选择要查询日志的时间范围。

日志字段说明

日志中包含的字段说明如下表。

参数

含义

备注

时间

日志打印时间。

无。

TraceId

追踪ID,可用于搜索串联模块。

无。

MessageID

消息ID。

无。

DeviceName

设备名称。

无。

业务类型

默认显示所有业务类型的日志,您可以仅查询某一业务类型的日志。

日志转储到日志服务中后,各业务类型对应的英文字段如下:

  • OTA升级OTA

  • 数据解析ScriptParsing

  • 物模型(物模型数据校验、物模型服务调用、物模型消息):ThingModel

  • 时序数据存储HotDataStorage

  • 远程配置RemoteConfig

  • 拓扑关系ThingTopo

  • 设备行为device

  • 设备到云消息uplink

  • 云到设备消息downlink

  • API调用ApiService

  • 服务端订阅ServiceSubscribe

  • 设备影子DeviceShadow

  • 规则引擎(云产品流转):RuleEngine

  • 订阅(订阅Topic):subscribe

  • 取消订阅(取消订阅Topic):unsubscribe

  • 设备任务ThingJob

  • 安全隧道DeviceSecureTunnel

  • 远程登录DeviceConsoleSsh

  • 设备文件上传DeviceFileUpload

  • 其他Other

业务一级区分符,表示业务模块。

操作

显示相应的操作名称、API名称、服务的method或消息的Topic。

API名称的具体说明,请参见API列表,服务的method或消息的Topic具体说明,请参见Alink协议

相关操作说明如下:

  • OTA升级相关操作:

    • OTAFirmwarePush:升级包推送,包括发起时推送、确认时推送、上线时推送。

    • OTAFirmwareRequest:设备端主动请求OTA升级包信息。

    • OTAVersionReport:设备上报OTA模块版本。

    • OTAProgressReport:设备上报升级进度。

  • 数据解析相关操作:

    • RawDataToProtocol:原始数据转换为Alink协议数据。

    • ProtocolToRawData:Alink协议数据转换为原始数据。

  • 物模型数据上报相关操作:

    • check:物联网平台根据物模型定义,校验上报的物模型数据。

    • 消息体中的method,请参见物模型通信Topic

  • 设备行为相关操作:

    • online:设备上线。

    • offline:设备下线。

  • 安全隧道相关操作:

    • CreateTunnel:创建安全隧道。

    • CloseTunnel:关闭安全隧道。

    • DeleteTunnel:删除安全隧道。

    • DeviceEndConn:设备端与安全隧道建立连接。

    • AccessEndConn:访问端与安全隧道建立连接。

    • SessionCreate:建立访问端与设备端的会话。

    • SessionRelease:关闭访问端与设备端的会话

    • DeviceEndDisconn:设备端与安全隧道断开连接。

    • AccessEndDisconn:访问端与安全隧道断开连接。

  • 远程登录相关操作:

    • OpenConsoleSsh:开启设备远程登录服务。

    • LoginConsoleSsh:在远程登录页面登录设备,包括登录记录和登录结果。

    • OpenConsoleSshShare:分享设备的远程登录信息。

    • UpdateConsoleSshSharePwd:更新已分享的设备远程登录密码。

    • CloseConsoleSshShare:关闭设备远程登录的分享。

    • CloseConsoleSsh:关闭设备远程登录服务。

  • 设备文件上传相关操作:

    • FileUploadInit:设备请求上传文件。

    • FileUploadFinished:设备文件上传完成。

    • FileUploadCancel:设备取消上传文件。

    • FileUploadIntegrityCheckFail:设备上传文件的完整性校验失败。

业务二级区分符。

内容

日志内容可能包含的参数:

  • TraceId:追踪ID,可用于搜索串联模块。

  • Message:失败原因。失败日志中包含该字段。

  • Params:请求参数。部分日志内容中包含。

  • ResultData:结果数据。有执行结果数据,则在日志中打印出来;没有,则日志中不包含该字段。

透传/自定义数据格式产品下的物模型数据解析日志,除了展示日志的内容之外,还会显示设备上报的原始数据的16进制字符串格式内容。

状态

结果码。200表示成功,其他表示失败。

API调用产生的错误码请参见错误码,其他错误码请参见下文。

无。

设备行为错误码

设备行为主要有设备上线(online)和设备下线(offline)的日志。

错误码

含义

原因

排查

200

设备上线、主动下线成功。

  • 下线:设备主动断开连接。

  • 上线:设备正常连接。

可在控制台,设备的设备详情页,查看设备的最后上线时间当前状态,确认设备状态。

1910

MQTT心跳超时,下线异常。

设备会定期向物联网平台发送心跳包,进行探活。发送的时间间隔由设备定义,需要小于云端设置的保活时间(设备接入时设置的保活时间)。如果在保活时间内,物联网平台没有收到设备发送的心跳包信息,物联网平台会断开连接,设备端需要进行重连。

设备端设置保活时间,请参见保活参数说明。

检查MQTT心跳保活时间是否超出设置。

1911

设备跟云端之间TCP连接断开,导致设备离线。

  • 设备端防火墙或NAT网关检测到TCP连接不活跃,会主动断开TCP连接。

  • 公网的网络环境复杂,TCP会偶现断连。若设备端配置了重连,且对业务无影响,可忽略该错误码。

可尝试更换网络环境,或检查防火墙、网关设置,例如关闭防火墙,然后进行验证。

说明

若频繁出现TCP断连,可通过TCPDUMP获取设备异常断连时的抓包文件,然后提交工单排查。

1913

子设备离线。

网关设备离线,导致子设备被动离线。

根据日志服务,查询网关设备离线原因。

1923

设备消息被限流。

  • 设备每分钟的最大的连接请求次数。

  • 设备的消息上下行限流。具体限制,请参见使用限制中的连接次数消息通信限流

降低设备请求或通信的次数。

401

设备无权限。

添加拓扑关系,判断子设备的身份信息时,校验子设备的签名信息失败。

按照Alink协议中签名的方法,通过算法工具校验生成签名和上报的签名。

Alink协议说明,请参见设备身份注册

427

设备下线异常。

设备证书信息被其他设备使用,使设备被迫下线。

物联网平台仅以设备证书信息(productKey、deviceName、deviceSecret)来判断设备。

  • 多个设备上烧录了相同的设备证书。

  • 设备端网络或电源不稳定,发生了瞬间断网或断电重连。这种情况下,设备与物联网平台是连接的,不影响设备使用。

  • 在物联网平台控制台设备的设备详情页,查看设备的上线时间,以此判断是否有其他设备使用相同的设备证书接入物联网平台。

  • 排查网络环境是否稳定

520

子设备会话错误。

  • 子设备会话不存在,可能子设备没有上线,也可能已经被下线。

  • 子设备会话在线,但并不是通过当前网关会话上线的。

在控制台设备列表下,搜索设备,查看设备状态。

521

设备被删除。

设备在云端已被删除。

在控制台设备列表下,搜索设备,查看设备是否已被删除。

522

设备被禁用。

设备在云端已被禁用。

在控制台,查看对应的设备状态,是否显示为已禁用

6100

设备不存在。

设备未创建或已删除。

在控制台设备列表下,搜索设备,查看设备是否存在。

6204

设备被禁用。

设备被禁用后,不能对设备进行操作,如添加拓扑关系、设置属性、调用服务等。

在控制台,查看对应的设备状态,是否显示为已禁用

6287

签名错误。

直连设备或子设备签名错误。

按照Alink协议中签名的方法,通过算法工具校验生成签名和上报的签名。

Alink协议说明,请参见设备身份注册

6288

设备动态注册开关已关闭。

子设备对应产品的动态注册开关未开启。

在控制台,设备所属产品的产品详情页面,开启动态注册开关。

6296

阿里云账号信息和实例信息不匹配。

当前实例不属于当前阿里云账号。

在控制台查看当前实例是否属于当前阿里云账号。

6401

拓扑关系不存在。

检查拓扑关系时,拓扑关系不存在。

在控制台设备管理 > 设备页面,搜索设备,查看设备信息。

6402

添加拓扑关系的网关设备和子设备相同。

添加拓扑关系时,不可把当前网关设备作为子设备,添加到当前网关设备下。

检查添加拓扑的子设备信息,是否有与网关设备信息一致的。

6619

子设备在其它网关设备下。

如果子设备已绑定到其它网关设备,不可再注册到当前网关设备下。

在控制台,该子设备的设备详情页面,查看该设备是否已绑定网关设备。

2043

因Token无效,导致设备认证失败。

设备认证的Token校验失败。

检查Token是否错误或者过期。您可刷新或者重新创建Token。

消息相关错误码

消息相关日志包括以下业务类型产生的日志:

  • 设备到云消息

  • 云到设备消息

  • 规则引擎(含服务端订阅、云产品流转)产生的数据流转消息

错误码

含义

原因

排查

1004

设备上报到云端消息的数据格式错误。

设备OTA升级时,在以下任一场景中上报的数据格式错误。

  • 设备上报OTA模块版本。

  • 设备主动请求升级包信息。

  • 设备上报升级进度。

请参见OTA升级消息的数据格式,检查对应场景数据格式,并按正确格式要求上报数据。

1901

受限于网络环境(如tcp write buffer拥堵等),消息发送失败。

设备端接受消息的通道阻塞,可能由于网络慢或者设备端消息能力不足,导致了服务端发送消息失败。

检查网络情况和设备端消息消费能力。

1902

消息写入网络时,发生异常。

网络异常导致发送失败。

检查网络情况。

1903

Topic格式错误。

消息Topic格式错误。

核对Topic格式。

1904

云端收到无效的RRPC响应。

云端收到的RRPC响应没有对应的RRPC请求。可能是之前的请求已经超时失败。

检查设备端回复的RRPC响应,是否已经超时。

1905

云端等待设备响应RRPC超时。

云端下发的RRPC请求,没有在超时时间内收到设备端的RRPC响应。

检查设备端上收的RRPC请求,是否已及时响应。

1941

请求授权失败。

Token认证失败。

检查并重新获取Token后,再次发起请求。

1942

消息通信限流。

Topic维度请求过多。

降低单个设备消息发送频率,或联系客服处理。

1950

消息写入时,网络连接发生异常。

网络错误导致发送消息失败。

检查网络状况。

1951

未知的响应类型。

设备端向云端发送了未知类型的消息。

检查设备发送的消息类型,如果您使用的是阿里云设备端SDK,请联系客服或提交工单处理。

6733

网络定位失败。

根据指定的网络信息,无法完成定位。

替换为其他网络信息,重新进行定位。

6736

IP定位失败。

根据指定的IP,无法获取定位结果。

替换为其他IP信息,重新进行定位。

6831

Topic或method不符合Alink协议定义。

设备上报的Topic或上行脚本解析结果中的method不符合Alink协议定义。

查看上报的Topic是否是Alink协议定义的Topic。查看上报的数据是否使用了Alink协议定义的method。

9200

设备未激活。

设备没有在物联网平台激活。新设备注册后,需要设备成功接入物联网平台,并进行数据上报才会激活设备。

在控制台,查看设备状态。

9201

  • 消费者离线。

  • 设备不在线。

  • 服务端订阅的消费组不在线。

  • 调用接口Pub发送消息给设备时,该设备不在线。

  • 在控制台的消息转发 > 服务端订阅的消费组页面查看消费组状态,然后在消费日志中查看服务端建连和断连原因。

  • 在控制台的设备管理 > 设备页面,查看目标设备的设备状态

9203

服务订阅端离线。

消息流转到服务端订阅时,服务端订阅的AMQP或MNS客户端不在线。

确认您服务端订阅的AMQP、MNS客户端是否正常在线。

9236

Topic鉴权失败。

发布或订阅消息的Topic对应的操作权限不一致。

在控制台,设备所属产品的Topic类列表中查看操作权限,检查Topic的操作权限是否正确。

  • 用于发布消息的Topic,操作权限必须包含发布。

  • 用于订阅消息的Topic,操作权限必须包含订阅。

9307

SQL语句解析失败。

可能是SQL语句不符合语法,或运行时的参数不符合函数的用法。

排查SQL语句正确性,和其中的函数正确性。

9324

限流。

设备或者租户流转请求过多。

说明

限流详细说明,请参见云产品流转的使用限制

降低消息发送频率,或者咨询客服。

9325

云产品流转服务熔断。

数据流转的目标云产品不可用。

查看目标云产品是否存在问题。

例如云产品服务欠费、云产品实例被删除、物联网平台访问目标云产品的权限被删除等,都会导致云产品在物联网平台不可用。

9326

企业版实例规格超限。

当前实例下的消息上下行TPS消息转发TPS等资源规格已经不满足业务需求。

在控制台的实例详情页面,查看实时运行数据中的各资源用量。具体操作,请参见查看实例的可用资源

确认规格不足的资源后,可升配实例的规格资源。具体操作,请参见实例升配

9321

参数非法。

传递的请求参数不合法,包括其他云产品参数。

根据提示检查对应的参数设置。

9320

Payload非法。

设备发送的消息体的格式不合法。

检查消息体的格式是否规范。

9331

消息流转的目标云产品内部错误。

数据流转目标云产品的内部发生错误。

根据内容中的错误码,到对应云产品官网上查询,或者联系客服。

9332

云产品配置异常。

设置消息流转时,配置有误,导致连接目标云产品服务时出错。

检查数据流转规则,查看目标产品的配置是否正确,资源是否存在。根据内容中的错误码,到对应云产品官网上查询原因和处理方法。

9362

脚本执行异常。

规则引擎执行脚本时发生异常解析,可能原因如下:

  • 脚本解析发生异常。

  • 脚本中函数调用异常。

您可根据日志内容,确定具体原因。

根据日志内容说明,检查脚本语法、函数调用是否正确。

脚本和函数使用说明,请参见脚本语法函数列表

9333

云产品授权错误。

授予物联网平台访问目标云产品的权限可能有误。

检查您的阿里云RAM授权策略。

9389

因网关设备不在线,导致子设备发送消息失败。

子设备所属网关设备不在线。

在控制台设备列表下,搜索目标网关设备,查看设备状态。

请确认网关设备在线,或重启网关设备使子设备上线。

9399

服务器内部未知错误。

物联网平台内部错误。

请联系客服或提交工单。

9600

单个消费组下的连接数目超过限制。

连接数过多,参见服务端订阅使用限制

清除多余连接。

9601

心跳值不符合要求。

心跳值不符合要求,参见服务端订阅使用限制

设置符合要求的心跳值。

9602

云端主动断开连接。

负载均衡调整、云端发布可能触发该问题,接收端需要实现重连逻辑,一般无影响。

请提交工单排查。

9650

消息ACK超时,未收到接收端响应。

接收端回复ACK超时。

排查接收端消息处理逻辑。

9651

接收端回复ACK released。

接收端回复ACK released。

9652

接收端回复NACK。

接收端回复NACK。

物模型相关错误码

物模型相关日志包括以下业务类型产生的日志:

  • 物模型数据上报

  • 物模型服务调用

透传/自定义数据格式产品下的物模型相关日志,除了展示日志的内容之外,还会显示设备上报的原始数据的16进制字符串格式内容。

调用服务和设置属性失败错误码如下表。

调用服务时,物联网平台会通过设备的物模型描述(TSL),校验该服务的入参是否符合该服务在TSL中的定义。

错误码

含义

原因

排查

通用错误码

100000

参数错误。

查询物联网平台公共实例或企业版实例下,对应产品的配置信息时,未获取到实例ID。

请确认是否已进入物联网平台实例。若已进入物联网平台实例,可以通过提交工单排查。

9201

消费者离线。

服务端订阅的消费组不在线。

在控制台的消息转发 > 服务端订阅的消费组页面查看消费组状态,然后在消费日志中查看服务端建连、断连原因。

9200

设备没有激活。

设备没有在物联网平台激活。新设备注册后需要进行数据上报。

在控制台,查看设备的在线状态。

9237

物联网平台服务欠费。

当前阿里云账号处于欠费状态。

在控制台,单击右上方费用,在用户中心查看余额。

请确保账号的余额充足,否则会导致物联网平台设备不可用。

9389

因网关设备不在线,导致子设备发送消息失败。

子设备所属网关设备不在线。

在控制台设备列表下,搜索目标网关设备,查看设备状态。

请确认网关设备在线,或重启网关设备使子设备上线。

6208

设备被禁用。

设备被禁用时,属性设置、服务调用被禁止使用。

在控制台,查看设备的状态。 如果设备被禁用,启用该设备然后重试操作即可。

6300

TSL校验时,method不存在。

TSL校验时,设备上报的Alink(标准)格式数据,或者自定义(透传)格式数据经过脚本转换后,没有Alink协议要求的method参数。

查看设备属性上报的日志,查看上报的数据。 或者查看设备的本地日志,查看上报的数据。

6206

查询服务定义出错。

调用服务时,会查询服务的定义信息,如果服务不存在会报这个错误。

在控制台产品详情中,查看设备所属产品的功能定义,查看传入的服务是否存在。如果存在,请校验传入的参数中是否包含不可见字符。

6200

脚本不存在。

对于透传(自定义)格式的产品,下行服务调用时,会调用产品脚本进行数据的转换。如果脚本不存在,会报这个错误。

在控制台产品详情中,查看产品的脚本是否存在。如果存在,请重新保存脚本后再尝试操作。

6201

脚本转换后数据为空。

脚本执行正常,但是脚本中返回的数据为空。如rawDataToProtocol返回null, protocolToRawData返回null或者空数组。

查看脚本的内容,确认在什么情况下返回数据为空。

6207

数据的格式错误。

下行同步调用时,或者设备上报数据时出现。

下行同步调用时,可能有如下原因:

  • 设备返回的数据格式错误。

  • 对自定义/透传格式数据进行解析后的数据格式错误。

  • 服务调用传入的参数格式不正确。

参见API接口文档及TSL,查看服务需要的数据格式。同时参见Alink协议文档,查看对应的数据格式。

6330

数据格式不符合Long类型的规范。

物模型功能定义了Long类型的参数或者属性,消息对应的数据格式不符合Long类型。

  • 查看设备属性上报的日志。

  • 在控制台查看物模型的功能定义。

6335

设备响应物模型属性设置的reply消息,参数非空。

物模型的属性设置方法,定义的响应数据为空,所以云端向设备下发属性设置指令后,data字段应该返回空。

  • 查看设备属性上报日志中设备上报的数据。

  • 查看设备本地日志中设备上报的数据。

6336

物模型中时间参数值错误。

设备上报物模型属性或事件数据时,携带的time时间戳不满足要求。

重要

设备上报物模型属性和事件数据时,仅支持上报未来24小时内的数据。

查看设备上报的物模型属性和事件数据中的time字段是否全部符合要求。

5490

物模型功能模块不存在。

物模型自定义功能模块不存在。

  • 在控制台查看对应的物模型标识符,确认参数是否传错。

  • 在控制台查看对应的自定义模块是否已经被删除。

5092

属性在物模型中不存在。

上下行信息中的属性不在物模型中。

重要

如果是自定义物模型模块中的属性,上下行通信的属性要拼接自定义模块标识符,格式为{tsl.functionBlockId}:{tsl.properties.identifier}

  • 查看设备属性上报的日志。

  • 在控制台查看物模型的属性定义。

5094

服务在物模型中不存在。

物模型中未定义服务,或服务入参与定义不符。

重要

如果是自定义物模型模块中的服务,需拼接自定义模块标识符,格式为{tsl.functionBlockId}:{tsl.service.identifier}

  • 查看设备属性上报的日志。

  • 在控制台查看物模型的服务定义。

5096

事件在物模型中不存在。

物模型中未定义事件,或事件入参与定义不符。

重要

如果是自定义物模型模块中的事件,需拼接自定义模块标识符,格式为{tsl.functionBlockId}:{tsl.event.identifier}

  • 查看设备属性上报的日志。

  • 在控制台查看物模型的事件定义。

系统异常错误码

5159

获取TSL中属性信息时报错。

系统异常。

可以通过提交工单排查。

5160

获取TSL中事件信息时报错。

5161

获取TSL中服务信息时报错。

6661

查询租户信息时异常。

6205

下行服务调用异常。

26015

脚本解析处理异常。

上报属性和上报事件失败错误码如下表。

属性上报、事件上报时会通过物模型描述TSL校验,校验属性是否符合TSL中属性的定义,事件的传入参数是否符合TSL中事件的定义。

错误码

含义

原因

排查

通用错误码

6106

上报的属性数据过多。

设备一次上报的有效属性个数不能超过200个。

查看设备属性上报的日志,检查上报的属性个数。或者查看设备本地的日志,查看上报的数据。

6300

TSL校验时,method不存在。

TSL校验时,设备上报的Alink(标准)格式数据,或者自定义(透传)格式数据经过脚本转换后,没有Alink协议要求的method参数。

查看设备属性上报的日志,查看上报的数据。 或者查看设备的本地日志,查看上报的数据。

6320

TSL校验时,属性信息不存在。

查询设备的TSL时,没有查询到设备的属性信息。

在控制台产品详情中,查看设备所属产品的功能定义,查看属性定义是否存在。不存在时,定义相应的属性。

6367

设备上报物模型(属性、事件)时,携带的time时间戳不满足要求。

设备上报物模型(属性、事件)数据时,仅支持上报过去30天内的数据。

查看设备上报的物模型(属性、事件)数据中的time字段是否全部符合要求。

6450

Alink协议格式的数据中method不存在。

设备上报的Alink标准格式数据,或者自定义/透传格式数据经过脚本解析为Alink标准格式数据后无method。

查看设备属性上报的日志,检查设备上报的数据中是否有method参数。或者查看设备本地的日志。

6207

数据的格式错误。

下行同步调用时,或者设备上报数据时出现。

设备上报数据时,可能原因为:设备上报的Alink数据格式,或者调用脚本解析后返回的数据格式不是JSON格式。

请参见Alink协议文档,查看对应数据格式,并按格式要求上报数据。

系统异常错误码

6452

限流。

请求量过大,触发限流。

可以通过提交工单排查。

6760

租户的空间存储超出配额。

系统异常。

可以通过提交工单排查。

调用服务和设置属性的reply失败错误码如下表。

错误码

含义

原因

排查

通用错误码

460

参数错误。

请求的参数错误。

可以通过提交工单排查。

500

系统内部异常。

系统发生未知异常。

可以通过提交工单排查。

400

服务请求时报错。

调用服务时发生未知错误。

可以通过提交工单排查。

429

请求过于频繁。

请求过于频繁,触发系统限流时会报这个错。

可以通过提交工单排查。

系统异常错误码

6452

限流。

请求量过大,触发限流。

可以通过提交工单排查。

TSL公共错误码如下表。

调用服务、上报属性、和事件上报时,会通过设备的模型描述TSL校验,校验该服务的入参是否符合该服务的定义,属性是否符合属性的定义,事件的传入参数是否符合事件的定义。

错误码

含义

原因

排查

通用错误码

6321

TSL中,属性对应的标识符identifier不存在。

系统异常。

可以通过提交工单排查。

6317

TSL模型有错误。

系统异常。

可以通过提交工单排查。

6332

传入的参数不符合TSL规范。

传入参数需要符合定义好的TSL规范。

在控制台产品详情中,查看设备所属产品的功能定义。核对传入的参数。

6302

参数不存在。

TSL校验服务的入参时,服务要求的参数没有传。

在控制台产品详情中,查看设备所属产品的功能定义。服务查询调用、属性设置,查询对应服务的入参,核对传入的参数。

6306

传入的参数,不符合TSL整型数据的规范。

TSL校验时:

  • 参数类型,和TSL中定义的类型不一致。

  • 传入的参数取值范围不符合功能定义时设置的参数范围。

在控制台产品详情中,查看设备所属产品的功能定义和对应服务的入参,核对传入的参数类型。

6307

传入的参数,不符合TSL中32位浮点数据的规范。

TSL校验时:

  • 参数类型,和TSL中定义的类型不一致。

  • 传入的参数取值范围不符合功能定义时设置的参数范围。

在控制台产品详情中,查看设备所属产品的功能定义和对应服务的入参,核对传入的参数类型和参数的取值范围。

6322

传入的参数,不符合TSL中64位浮点数据的规范。

TSL校验时:

  • 参数类型,和TSL中定义的类型不一致。

  • 传入的参数取值范围不符合功能定义时设置的参数范围。

在控制台产品详情中,查看设备所属产品的功能定义和对应服务的入参,核对传入的参数类型和参数的取值范围。

6308

传入的参数,不符合TSL中布尔类型数据的规范。

TSL校验时:

  • 参数类型,和TSL中定义的类型不一致。

  • 传入的参数取值范围不符合功能定义时设置的参数范围。

在控制台产品详情中,查看设备所属产品的功能定义和对应服务的入参,核对传入的参数类型。

6309

传入的参数,不符合TSL中枚举类型数据的规范。

TSL校验时,参数类型和TSL中定义的类型不一致。

在控制台中产品详情中查看设备所属产品的功能定义,对应服务的入参,核对传入的参数类型。

6310

传入的参数,不符合TSL中字符类型数据的规范。

TSL校验时:

  • 参数类型,和TSL中定义的类型不一致。

  • 传入的字符类型的参数长度超过限制。

在控制台中产品详情中查看设备所属产品的功能定义,对应服务的入参,核对传入的参数类型。

6311

传入的参数,不符合TSL中日期类型数据的规范。

TSL校验时:

  • 传入的参数类型,需要和TSL中定义的类型完全一致。

  • 传入的日期类型判断不是UTC时间戳的字符格式时会报错。

在控制台中产品详情中查看设备所属产品的功能定义,对应服务的入参,核对传入的参数类型。

6312

传入的参数,不符合TSL中结构体类型数据的规范。

TSL校验时:

  • 传入的参数类型,需要和TSL中定义的类型完全一致。

  • 结构体类型中参数的个数和TSL中定义不一致时会报这个错。

在控制台产品详情中查看设备所属产品的功能定义,对应服务的入参,核对传入的参数类型。

6304

校验的参数,在TSL结构体中不存在。

TSL校验时,传入的参数在结构体中不存在。

在控制台产品详情中查看设备所属产品的功能定义,对应服务的入参,核对传入的参数类型。

6324

校验参数时,数组类型的参数不符合规范。

TSL校验时:

  • 传入的数组类型的参数不符合TSL定义时,会报这个错。

  • 数组中参数个数超过了TSL中定义的最大个数。

  • 在控制台产品详情中,查看设备所属产品的功能定义,检查对应数组的定义。

  • 查看设备上报的日志,检查设备上报的数据中数组内元素的个数。

6328

校验参数时,传入的参数不是数组类型。

TSL校验时,传入的参数如果不是数组类型,会报这个错。

在控制台中产品详情中查看设备所属产品的功能定义,查看对应服务的入参,查询类型为数组的参数,然后检查传入的对应参数是否是数组类型。

6325

校验参数时,传入的数组类型参数中的元素类型,目前不支持该类型。

TSL校验参数时报错,数组中元素的类型目前只支持整型、32位浮点类型、64位浮点类型、字符串类型、结构体类型。

检查传入的数组元素类型是否是目前支持的类型。

系统异常错误码

6318

TSL解析时系统异常。

系统异常。

可以通过提交工单排查。

6329

校验参数时,TSL中数组规范解析出错。

6323

TSL中参数规范格式错误。

6316

TSL中解析参数报错。

6314

TSL不支持的数据类型。

6301

通过TSL校验参数格式时报错。

数据解析错误码

26010

请求过于频繁被限流。

请求过于频繁。

可以通过提交工单排查。

26001

脚本内容为空。

执行脚本时获取脚本内容,不存在。

在控制台查询产品的脚本是否存在。如果存在,则是否正常保存。应是正式的脚本,不是草稿。

26002

脚本执行时异常。

脚本执行正常,但脚本编写有问题,如脚本中语法错误。

在控制台使用相同的参数去执行脚本,查看具体的错误信息,修改脚本。

重要

物联网平台控制台只提供了脚本的基础运行环境,并不会对脚本进行详细的校验。建议在本地详细验证脚本后,再保存该脚本

26003

脚本执行超时。

脚本内容逻辑太复杂,执行时间超出限制(3秒)。

在控制台查询脚本的内容,检查编写逻辑,例如是否存在无限循环。建议在本地正常执行脚本后,再保存该脚本。

26006

脚本执行时必要的方法不存在。

脚本执行正常,脚本内容有误。脚本编写要求有protocolToRawDatarawDataToProtocol这两个服务,如果执行时不存在,会报错。

在控制台查询脚本的内容,查看protocolToRawDatarawDataToProtocol服务是否存在。

26007

脚本执行时返回的结果格式不正确。

脚本执行正常,但返回的结果不符合格式要求。 脚本编写要求有protocolToRawDatarawDataToProtocol这两个服务。 protocolToRawData返回byte[]数组,rawDataToProtocol要求返回JSON对象。 如果脚本返回的结果不符合这两种格式,返回时会报这个错。 如设备上报数据后,会返回结果给设备。返回的结果也会经过脚本进行解析,如果对于返回结果不做处理,可能会返回不符合要求的类型。

在控制台查看脚本,获取脚本内容。按照输入参数,在本地执行脚本并查看返回结果的格式是否符合要求。

订阅、取消订阅Topic错误码

错误码

含义

原因

排查

9200

设备未激活。

设备没有在物联网平台激活。新设备注册后,需要设备成功接入物联网平台,并进行数据上报才会激活设备。

在控制台,查看设备状态。

500

系统内部异常。

系统发生未知异常。

可以通过提交工单排查。

403

请求被禁止。

欠费或Topic鉴权失败。

可以通过提交工单排查。

拓扑关系错误码

错误码

含义

原因

排查

5005

查询产品信息失败。

产品不存在。

在控制台的设备管理 > 产品页面,查询产品信息,确认ProductKey是否存在。

远程配置错误码

错误码

含义

原因

排查

6710

远程配置文件中没有内容,需要在控制台编辑内容并保存后,重新获取。

控制台的远程配置内容未保存。

刷新控制台的监控运维 > 远程配置页面。

您需在配置模板下,保存已编辑的内容。

6713

远程配置开关未打开。

控制台的监控运维 > 远程配置页面,远程配置开关未打开。

在控制台的监控运维 > 远程配置页面,查看远程配置开关状态。

设备任务错误码

错误码

含义

原因

排查

71035

获取任务信息的请求参数中,任务ID不是自定义任务ID,或任务下作业已处于最终状态。

设备任务通信协议的Topic:/sys/${productKey}/${deviceName}/thing/job/notify/sys/${productKey}/${deviceName}/thing/job/get/sys/${productKey}/${deviceName}/thing/job/update,只支持自定义类型的任务。

在控制台的设备管理 > 任务页面,进入任务详情页面,查看任务类型和任务状态。

71019

设备任务不存在。

设备任务下关联的作业不存在。

在控制台的设备管理 > 任务页面,进入任务详情页面的作业概览页签,查看作业是否存在。

安全隧道与远程登录错误码

错误码

含义

原因

排查

78114

安全隧道的访问端或设备端建连认证失败。

与安全隧道建连认证的Token校验失败。

检查安全隧道建连认证的Token,确认是已添加安全隧道的Token。具体信息,请参见创建安全隧道

78115

安全隧道内会话(Session)创建失败。

可能原因:

  • 创建Session时,对应的业务类型service_type校验失败。

  • 设备端响应超时。

  • 设备端拒绝创建会话。

根据日志报错信息确定原因后,进行排查:

  • 使用合法的service_type,详细信息,请参见通信数据格式说明

  • 检查设备端的会话逻辑,确认设备具备会话能力。

78116

远程登录设备失败。

输入的远程登录用户名或密码错误。

检查并确认输入的用户名和密码是否正确。

设备文件上传错误码

错误码

含义

原因

排查

78123

设备请求上传的同名文件已存在。

可能原因:

  • 设备请求上传的文件名称与已完成上传的文件名称重复。

  • 设备端配置的同名文件处理策略不支持上传同名文件。

请确认设备端配置:

  • 设备请求上传的文件名称是否设置重复。

  • 配置的同名文件处理策略是否为overwrite

详细信息 ,请参见上传文件

78129

设备上传至物联网平台存储空间的文件数量超出限制。

一个设备下,物联网平台存储空间可存储的文件数量不能超过1,000个。

设备上传至物联网平台存储空间的文件数量已超过1,000个。

请确认设备已上传至物联网平台存储空间的文件数量是否超过限制。

时序数据存储错误码

错误码

含义

原因

排查

6363

时序数据存储空间的容量不足。

实例的时序数据存储空间规格不足。

查看实例下时序数据存储空间可用资源。具体操作,请参见查看实例的可用资源

6364

时序数据存储的读取IOPS不足。

实例的时序数据存储IOPS规格不足。

查看实例下时序数据存储IOPS可用资源。具体操作,请参见查看实例的可用资源

6365

时序数据存储的写入IOPS不足。

实例的时序数据存储IOPS规格不足。

6366

查询的时序数据的时间范围,超出了时序数据的存储时效范围。

要查询的数据已经过期并被清理了。

查看实例时序数据的存储时效范围。具体操作,请参见管理时序存储配置

6367

设备上报时序数据时,携带的time时间戳不满足要求。

时序数据的详细说明,请参见时序数据存储概述

设备上报时序数据时,仅支持上报过去30天内的数据。

查看设备上报时序数据中的time字段是否全部符合要求。

云端API错误码

调用云端API的相关错误码,请参见错误码