全部產品
Search
文件中心

IoT Platform:雲端作業記錄

更新時間:Jul 13, 2024

物聯網平台控制台提供雲端作業記錄,包含物聯網平台、裝置、您的應用程式三者之間的互動通訊記錄。通過日誌記錄的訊息內容、業務類型、操作類型和狀態代碼等資訊,可以瞭解裝置狀態、通訊情況,並定位操作失敗的原因,協助您監控和管理裝置,進行故障排查。本文介紹如何查看雲端作業記錄,以及相關錯誤碼和排錯方法。

日誌業務類型說明

上行訊息的日誌業務類型如下圖所示。

上行訊息日誌

  1. 物聯網平台接收裝置上報資料,並列印裝置到物聯網平台的訊息日誌,包含訊息的Topic。

  2. 對於資料處理的不同業務模組,分別列印各模組的日誌。

  3. 如果訊息通過雲產品流轉和服務端訂閱(AMQP、MNS服務端訂閱),對外發送給客戶,將列印規則引擎(雲產品流轉)、服務端訂閱模組的日誌。

下行訊息的日誌業務類型如下圖所示。

下行訊息日誌

  1. 使用者通過API調用產生訊息,列印API調用日誌,包含API名稱。

  2. 對於資料處理的不同業務模組,分別列印各模組的日誌。

  3. 如果有訊息發送到裝置側,物聯網平台列印雲端到裝置的訊息日誌,包含訊息的Topic。

查詢雲端作業記錄

  1. 登入物聯網平台控制台

  2. 執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。

  3. 在左側導覽列,選擇監控營運 > Log Service,進入雲端作業記錄頁簽。

  4. 選擇產品,輸入搜尋條件,然後單擊搜尋表徵圖。

    支援的搜尋條件如下表。

    重要

    如果輸入的搜尋條件(如裝置名稱、內容關鍵字等),包含以下特殊字元, '";=()[]{}?@&<>/:\n\t\r,輸入內容會被拆分為多個詞,從而導致查詢日誌失敗,頁面會出現報錯提示:日誌查詢,查詢參數異常

    搜尋條件

    說明

    DeviceName

    輸入裝置名稱。根據裝置名稱,搜尋該裝置的相關日誌。

    TraceId

    輸入追蹤ID,搜尋串聯模組日誌。

    內容關鍵字

    輸入日誌內容的任意關鍵字搜尋日誌。

    MessageID

    訊息ID,物聯網平台為訊息產生的唯一識別碼。

    僅上、下行訊息分析支援根據MessageID搜尋日誌。

    狀態

    查詢某種結果狀態的日誌。可選擇:

    • 全部狀態

    • 成功:狀態代碼為200。

    • 失敗:其他狀態代碼。

    業務類型

    選擇要查詢日誌所屬業務類型。

    時間範圍

    選擇要查詢日誌的時間範圍。

日誌欄位說明

日誌中包含的欄位說明如下表。

參數

含義

備忘

時間

日誌列印時間。

無。

TraceId

追蹤ID,可用於搜尋串聯模組。

無。

MessageID

訊息ID。

無。

DeviceName

裝置名稱。

無。

業務類型

預設顯示所有業務類型的日誌,您可以僅查詢某一業務類型的日誌。

日誌轉儲到Log Service中後,各業務類型對應的英文欄位如下:

  • OTA升級OTA

  • 資料解析ScriptParsing

  • 物模型(物模型資料校正、物模型服務調用、物模型訊息):ThingModel

  • 時序資料存放區HotDataStorage

  • 遠程配置RemoteConfig

  • 拓撲關係ThingTopo

  • 裝置行為device

  • 裝置到雲訊息uplink

  • 雲到裝置訊息downlink

  • API調用ApiService

  • 服務端訂閱ServiceSubscribe

  • 裝置影子DeviceShadow

  • 規則引擎(雲產品流轉):RuleEngine

  • 訂閱(訂閱Topic):subscribe

  • 取消訂閱(取消訂閱Topic):unsubscribe

  • 裝置檔案上傳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:裝置下線。

業務二級區分符。

內容

日誌內容可能包含的參數:

  • TraceId:追蹤ID,可用於搜尋串聯模組。

  • Message:失敗原因。失敗日誌中包含該欄位。

  • Params:請求參數。部分日誌內容中包含。

  • ResultData:結果資料。有執行結果資料,則在日誌中列印出來;沒有,則日誌中不包含該欄位。

透傳/自訂資料格式產品下的物模型資料解析日誌,除了展示日誌的內容之外,還會顯示裝置上報的未經處理資料的16進位字串格式內容。

狀態

結果碼。200表示成功,其他表示失敗。

API調用產生的錯誤碼請參見錯誤碼,其他錯誤碼請參見下文。

無。

裝置行為錯誤碼

裝置行為主要有裝置上線(online)和裝置下線(offline)的日誌。

錯誤碼

含義

原因

排查

200

裝置上線、主動下線成功。

  • 下線:裝置主動中斷連線。

  • 上線:裝置正常串連。

可在控制台,裝置的裝置詳情頁,查看裝置的最後上線時間目前狀態,確認裝置狀態。

1910

MQTT心跳逾時,下線異常。

裝置會定期向物聯網平台發送心跳包,進行探活。發送的時間間隔由裝置定義,需要小於雲端設定的保活時間(裝置接入時設定的保活時間)。如果在保活時間內,物聯網平台沒有收到裝置發送的心跳包資訊,物聯網平台會中斷連線,裝置端需要進行重連。

裝置端設定保活時間,請參見保活參數說明。

檢查MQTT心跳保活時間是否超出設定。

1911

裝置跟雲端之間TCP串連斷開,導致裝置離線。

  • 裝置端防火牆或NAT Gateway檢測到TCP串連不活躍,會主動斷開TCP串連。

  • 公網的網路環境複雜,TCP會偶現斷連。若裝置端配置了重連,且對業務無影響,可忽略該錯誤碼。

可嘗試更換網路環境,或檢查防火牆、網關設定,例如關閉防火牆,然後進行驗證。

說明

若頻繁出現TCP斷連,可通過TCPDUMP擷取裝置異常斷連時的抓包檔案,然後提交工單排查。

1913

子裝置離線。

網關裝置離線,導致子裝置被動離線。

根據Log Service,查詢網關裝置離線原因。

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

遠程配置開關未開啟。

控制台的監控營運 > 遠程配置頁面,遠程配置開關未開啟。

在控制台的監控營運 > 遠程配置頁面,查看遠程配置開關狀態。

裝置檔案上傳錯誤碼

錯誤碼

含義

原因

排查

78123

裝置請求上傳的同名檔案已存在。

可能原因:

  • 裝置請求上傳的檔案名稱與已完成上傳的檔案名稱重複。

  • 裝置端配置的同名檔案處理策略不支援上傳同名檔案。

請確認裝置端配置:

  • 裝置請求上傳的檔案名稱是否設定重複。

  • 配置的同名檔案處理策略是否為overwrite

詳細資料 ,請參見上傳檔案

78129

裝置上傳至物聯網平台儲存空間的檔案數量超出限制。

一個裝置下,物聯網平台儲存空間可儲存的檔案數量不能超過1,000個。

裝置上傳至物聯網平台儲存空間的檔案數量已超過1,000個。

請確認裝置已上傳至物聯網平台儲存空間的檔案數量是否超過限制。

雲端API錯誤碼

調用雲端API的相關錯誤碼,請參見錯誤碼