Seguimiento del progreso de los trabajos

Revise el progreso y los detalles de los trabajos (consola)

Consulte Importación de metadatos (consola) o Exportación de metadatos (consola) para iniciar un trabajo masivo.

Descripción general del progreso del trabajo en la AWS IoT SiteWise consola:

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, elija Operaciones masivas Nueva.

3. La tabla de progreso de los trabajos de la AWS IoT SiteWise consola muestra la lista de trabajos de operaciones masivas.

4. La columna Tipo de trabajo describe si se trata de un trabajo de exportación o de importación. Las columnas Fecha de importación muestran la fecha en que se inició el trabajo.

5. La columna Estado muestra el estado del trabajo. Puede seleccionar un trabajo para ver sus detalles.

6. El trabajo seleccionado muestra Correcto si se ha realizado correctamente o una lista de errores si ha fallado. También se muestra una descripción del error con cada tipo de recurso.

Descripción general de los detalles del trabajo en la AWS IoT SiteWise consola:

La tabla de progreso de los trabajos de la AWS IoT SiteWise consola muestra la lista de trabajos de operaciones masivas.

1. Elija un trabajo para ver más detalles.

2. Para un trabajo de importación, el Data source ARN representa la ubicación en Amazon S3 del archivo de importación.

3. Para un trabajo de exportación, el Data destination ARN representa la ubicación del archivo en Amazon S3 tras la exportación.

4. Status y Status reason proporcionan detalles adicionales sobre el trabajo actual. Consulte Seguimiento del progreso de los trabajos y gestión de errores para obtener más detalles.

5. Queued position representa la posición del trabajo en la cola de procesos. Los trabajos se procesan uno a uno. Una posición en cola igual a 1 indica que el trabajo se procesará a continuación.

6. La página de detalles de los trabajos también muestra los recuentos de progreso de los trabajos.

   1. Los tipos de recuento de progreso de los trabajo son:

      1. Total resources: indica el recuento total de activos en el proceso de transferencia.

      2. Succeeded: indica el recuento de activos transferidos correctamente durante el proceso.

      3. Failed: indica el recuento de activos que han fallado durante el proceso.

      4. Skipped: indica el recuento de activos que se han omitido durante el proceso.

7. Un estado de trabajo de PENDING o VALIDATING muestra todos los recuentos de progreso de los trabajos como –. Esto indica que se están evaluando los recuentos de progreso de los trabajos.

8. Un estado de trabajo de RUNNING muestra el recuento de Total resources, el trabajo enviado para su procesamiento. Los recuentos detallados (Succeeded, Failed y Skipped) se aplican a los recursos procesados. La suma de los recuentos detallados es menor que el recuento de Total resources hasta que el estado del trabajo es COMPLETED o ERROR.

9. Si el estado de un trabajo es COMPLETED o ERROR, el recuento de Total resources es igual a la suma de los recuentos detallados (Succeeded, Failed y Skipped).

10. Si el estado de un trabajo es ERROR, consulte la tabla Errores de trabajo para obtener detalles sobre errores y fallos específicos. Consulte Inspección de detalles de errores (consola) para obtener más detalles.

Revise el progreso y los detalles de los trabajos (AWS CLI)

Tras iniciar una operación masiva, puede comprobar o actualizar su estado mediante las siguientes acciones de la API:

• Para recuperar información sobre un trabajo específico, usa la acción de la GetMetadataTransferJobAPI.

  Recupere información con la API GetMetadataTransferJob:

  1. Cree y ejecute un trabajo de transferencia. Llame a la API GetMetadataTransferJob.

     ejemplo AWS CLI comando:

     
     aws iottwinmaker get-metadata-transfer-job \ 
             --metadata-transfer-job-id your_metadata_transfer_job_id \
             --region your_region                           
     

  2. La API GetMetadataTransferJob devuelve un objeto MetadataTransferJobProgress con los siguientes parámetros:

     • succeededCount: indica el recuento de activos transferidos correctamente durante el proceso.

     • failedCount: indica el recuento de activos que han fallado durante el proceso.

     • skippedCount: indica el recuento de activos que se han omitido durante el proceso.

     • totalCount: indica el recuento total de activos en el proceso de transferencia.

     Estos parámetros indican el estado del progreso del trabajo. Si el estado es RUNNING, ayudan a hacer un seguimiento de la cantidad de recursos que aún no se han procesado.

     Si encuentra errores de validación del esquema o si failedCount es mayor o igual que 1, el estado de progreso de los trabajos pasa a ser ERROR. En el bucket de Amazon S3 se incluye un informe de error completo del trabajo. Consulte Inspeccione los errores para AWS IoT SiteWise para obtener más detalles.

• Para enumerar los trabajos actuales, usa la acción ListMetadataTransferJobsde la API.

  Use un archivo JSON para filtrar los trabajos devueltos en función de su estado actual. Consulte el procedimiento siguiente:

  1. Para especificar los filtros que quieres usar, crea un archivo JSON AWS CLI de entrada. Quieres usar:

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

     Para obtener una lista de state valores válidos, consulta la Guía ListMetadataTransferJobsFilterde referencia de la AWS IoT TwinMaker API.

  2. Usa el archivo JSON como argumento en el siguiente comando de AWS CLI ejemplo:

     
     aws iottwinmaker list-metadata-transfer-job --region your_region \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     

• Para cancelar un trabajo, usa la acción de la CancelMetadataTransferJobAPI. Esta API cancela el trabajo de transferencia de metadatos específico sin que ello afecte a los recursos ya exportados o importados:

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