Inspect errors for Amazon IoT SiteWise - Amazon IoT SiteWise
Inspect error details (console)Inspect error details (Amazon CLI)
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Inspect errors for Amazon IoT SiteWise

Inspect error details (console)

Error details in the Amazon IoT SiteWise console:

  1. Navigate to the Amazon IoT SiteWise console.

  2. See the Jobs progress table in Amazon IoT SiteWise console for a list of bulk operation jobs.

  3. Select a job to view the job details.

  4. If a job's status is COMPLETED or ERROR, the Total resources count equals the sum of the detailed counts (Succeeded, Failed, and Skipped).

  5. If a job's status is ERROR, check the Job failures table for details about the specific errors and failures.

  6. The Job failures table displays the content from the job report. The Resource type field indicates the location of the error or failures, such as the following:

    • For example, a validation error in the Bulk operations template in the Resource type field indicates that the import template and metadata schema file format don't match. See Amazon IoT SiteWise metadata transfer job schema for more information.

    • A failed Asset in the Resource type field indicates that the asset is not created because of a conflict with another asset. See Common errors for information on Amazon IoT SiteWise resource errors and conflicts.

Inspect error details (Amazon CLI)

To handle and diagnose errors produced during a transfer job, see the following procedure about using the GetMetadataTransferJob API action:

  1. After creating and running a transfer job, call GetMetadataTransferJob:

    aws iottwinmaker get-metadata-transfer-job \
        --metadata-transfer-job-id your_metadata_transfer_job_id \
        --region us-east-1

  2. Once you see the state of the job turn to COMPLETED, you can start verifying the results of the job.

  3. When you call GetMetadataTransferJob, it returns an object called MetadataTransferJobProgress.

    The MetadataTransferJobProgress object contains the following parameters:

    • failedCount: Indicates the count of assets that failed during the transfer process.

    • skippedCount: Indicates the count of assets that were skipped during the transfer process.

    • succeededCount: Indicates the count of assets that succeeded during the transfer process.

    • totalCount: Indicates the total count of assets involved in the transfer process.

  4. Additionally, the API call returns an element reportUrl, which contains a presigned URL. If your transfer job has any issues that you need to investigate further, visit this url.