工作進度跟踪 - AWS IoT SiteWise

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

工作進度跟踪

檢閱工作進度和詳細資料 (主控台)

請參閱匯入中繼資料 (主控台)匯出中繼資料 (主控台)以開始大量工作。

AWS IoT SiteWise 主控台中的 Job 進度概觀:
  1. 導覽至 AWS IoT SiteWise 主控台

  2. 從導覽窗格中選擇 [大量作業新增]。

  3. AWS IoT SiteWise 主控台中的「工作」進度表會顯示批次處理作業工作的清單。

  4. [Job 類型] 欄描述它是匯出還是匯入工作。[匯入的日期] 欄會顯示工作的開始日期。

  5. 狀態」欄會顯示工作的狀態。您可以選取工作以查看有關工作的詳細資訊。

  6. 選取的工作會顯示成後的「成功」;如果工作失敗,則會顯示失敗的清單。每個資源類型也會顯示錯誤描述。

AWS IoT SiteWise 主控台中的 Job 詳細資料概觀:

AWS IoT SiteWise 主控台中的「工作」進度表會顯示批次處理作業工作的清單。

  1. 選擇工作以查看更多詳細資料。

  2. 對於入任務,Data source ARN代表匯入檔案的 Amazon S3 位置。

  3. 對於匯出任務,Data destination ARN代表匯出後檔案的 Amazon S3 位置。

  4. StatusStatus reason,提供目前工作的其他詳細資訊。如需詳細資訊,請參閱工作進度追蹤和錯誤處理

  5. Queued position表示工作在處理佇列中的位置。會一次處理一個工作。佇列位置為 1,表示接下來將處理工作。

  6. 工作詳細資訊頁面也會顯示工作進度計數。

    1. 工作進度計數類型為:

      1. Total resources— 表示資產在轉移過程中的總數。

      2. Succeeded— 表示在此過程中成功轉移的資產計數。

      3. Failed— 指示在處理期間計算失敗的資產。

      4. Skipped— 指示在處理期間略過的資產計數。

  7. 工作狀態為PENDINGVALIDATING,會顯示所有工作進度計為。這表示正在評估工作進度計數。

  8. 的工作狀態RUNNING會顯示Total resources計數,也就是提交進行處理的工作。詳細計數 (SucceededFailed、和Skipped) 會套用至已處理的資源。詳細計數的總和小於Total resources計數,直到工作的狀態為COMPLETEDERROR

  9. 如果工作的狀態為COMPLETEDERROR,則Total resources計數等於詳細計數 (SucceededFailed、和Skipped) 的總和。

  10. 如果 Job 的狀態為ERROR,請查看「工作失敗」表格,以取得有關特定錯誤和失敗項目的詳細資訊。如需詳細資訊,請參閱檢查錯誤詳細信息(控制台)

檢閱工作進度和詳細資料 (AWS CLI)

開始批次處理作業之後,您可以使用下列API動作來檢查或更新其狀態:

  • 若要擷取特定工作的資訊,請使用 GetMetadataTransferJobAPI動作。

    使用以下命令檢索信息 GetMetadataTransferJobAPI:
    1. 建立並執行移轉工作。呼叫 GetMetadataTransferJobAPI.

      範例 AWS CLI 命令:
      aws iottwinmaker get-metadata-transfer-job \ --metadata-transfer-job-id your_metadata_transfer_job_id \ --region your_region
    2. GetMetadataTransferJobAPI傳回具有下列參數的MetadataTransferJobProgress物件:

      • succeededCount— 表示在過程中成功轉移的資產計數。

      • failedCount— 指示在處理期間失敗的資產計數。

      • skippedCount— 指示在處理期間略過的資產計數。

      • totalCount— 表示資產在轉移過程中的總數。

      這些參數指示工作進度狀態。如果狀態為RUNNING,則可協助追蹤仍待處理的資源數量。

      如果您遇到結構描述驗證錯誤,或者大failedCount於或等於 1,工作進度狀態就會變成ERROR。該任務的完整錯誤報告已放置在您的 Amazon S3 儲存貯體中。如需詳細資訊,請參閱檢查錯誤

  • 若要列出目前的工作,請使用ListMetadataTransferJobsAPI動作。

    使用JSON檔案根據傳回的工作目前狀態篩選傳回的工作。請參閱下列程序:

    1. 要指定要使用的過濾器,請創建一個 AWS CLI 輸入JSON文件。想要使用:

      { "sourceType": "s3", "destinationType": "iottwinmaker", "filters": [{ "state": "COMPLETED" }] }

      若要取得有效state值的清單,請參閱《AWS IoT TwinMaker API參考指南》ListMetadataTransferJobsFilter中的〈〉。

    2. 在下列 AWS CLI 範例命令中使用JSON檔案作為引數:

      aws iottwinmaker list-metadata-transfer-job --region your_region \ --cli-input-json file://ListMetadataTransferJobsExample.json
  • 若要取消工作,請使用CancelMetadataTransferJobAPI動作。這會API取消特定的中繼資料傳輸工作,而不會影響任何已匯出或匯入的資源:

    aws iottwinmaker cancel-metadata-transfer-job \ --region your_region \ --metadata-transfer-job-id job-to-cancel-id