View a markdown version of this page

Acompanhamento do progresso dos trabalhos - AWS IoT SiteWise
Revisar o progresso dos trabalhos e os detalhes (console)Analise o progresso e os detalhes do trabalho (AWS CLI)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Acompanhamento do progresso dos trabalhos

Revisar o progresso dos trabalhos e os detalhes (console)

Consulte Importar metadados (console) ou Exportar metadados (console) para iniciar um trabalho em massa.

Visão geral do progresso do trabalho na AWS IoT SiteWise console:

  1. Navegue até o console do AWS IoT SiteWise.

  2. Escolha Operações em massa > Novo no painel de navegação.

  3. A tabela de progresso dos trabalhos no AWS IoT SiteWise console exibe a lista de trabalhos de operação em massa.

  4. A coluna Tipo de trabalho descreve se é um trabalho de exportação ou importação. As colunas Data de importação exibem a data de início do trabalho.

  5. A coluna Status exibe o status do trabalho. É possível selecionar um trabalho para ver detalhes sobre o trabalho.

  6. O trabalho selecionado mostra Êxito quando bem-sucedido, ou uma lista de falhas caso o trabalho falhe. Uma descrição do erro também é exibida com cada tipo de recurso.

Visão geral dos detalhes do trabalho na AWS IoT SiteWise console:

A tabela de progresso dos trabalhos no AWS IoT SiteWise console exibe a lista de trabalhos de operação em massa.

  1. Escolha um trabalho para ver mais detalhes.

  2. Para um trabalho de importação, o Data source ARN representa o local do arquivo de importação no Amazon S3.

  3. Para um trabalho de exportação, o Data destination ARN representa o local do arquivo depois da exportação no Amazon S3.

  4. O Status e o Status reason dão detalhes adicionais sobre o trabalho atual. Consulte Acompanhamento do progresso dos trabalhos e tratamento de erros para obter mais detalhes.

  5. A Queued position representa a posição do trabalho na fila do processo. Os trabalhos são processados um de cada vez. Uma posição 1 na fila indica que o trabalho será processado em seguida.

  6. A página de detalhes dos trabalhos também exibe as contagens de progresso dos trabalhos.

    1. Os tipos de contagem de progresso dos trabalhos são:

      1. Total resources: indica a contagem total de ativos no processo de transferência.

      2. Succeeded: indica a contagem de ativos transferidos com êxito durante o processo.

      3. Failed: indica a contagem de ativos que falharam durante o processo.

      4. Skipped: indica a contagem de ativos que foram ignorados durante o processo.

  7. Um status de trabalho de PENDING ou VALIDATING exibe todas as contagens de progresso dos trabalhos como –. Isso indica que as contagens de progresso dos trabalhos estão sendo avaliadas.

  8. Um status de trabalho de RUNNING exibe a contagem Total resources, o trabalho enviado para processamento. As contagens detalhadas (Succeeded, Failed e Skipped) se aplicam aos recursos processados. A soma das contagens detalhadas é menor do que a contagem Total resources, até que o status do trabalho seja COMPLETED ou ERROR.

  9. Se o status de um trabalho for COMPLETED ou ERROR, a contagem Total resources será igual à soma das contagens detalhadas (Succeeded, Failed e Skipped).

  10. Se o status de um trabalho for ERROR, verifique a tabela Falhas de trabalhos para conferir detalhes sobre as falhas e os erros específicos. Consulte Inspecionar detalhes de erros (console) para obter mais detalhes.

Analise o progresso e os detalhes do trabalho (AWS CLI)

Depois de iniciar uma operação em massa, você poderá verificar ou atualizar o status usando as seguintes ações de API:

  • Para recuperar informações sobre um trabalho específico, use a ação da GetMetadataTransferJob API.

    Recupere informações com a API GetMetadataTransferJob:

    1. Crie e execute um trabalho de transferência. Chame a API GetMetadataTransferJob.

      exemplo AWS CLI comando:
      
aws iottwinmaker get-metadata-transfer-job \ 
        --metadata-transfer-job-id your_metadata_transfer_job_id \
        --region your_region

    2. A API GetMetadataTransferJob retorna um objeto MetadataTransferJobProgress com os seguintes parâmetros:

      • succeededCount: indica a contagem de ativos transferidos com êxito no processo.

      • failedCount: indica a contagem de ativos que falharam durante o processo.

      • skippedCount: indica a contagem de ativos que foram ignorados durante o processo.

      • totalCount: indica a contagem total de ativos no processo de transferência.

      Esses parâmetros indicam o status de progresso dos trabalhos. Se o status for RUNNING, eles ajudarão a acompanhar o número de recursos que ainda precisam ser processados.

      Se você encontrar erros na validação do esquema, ou se failedCount for maior ou igual a 1, o estado de progresso do trabalho será alterado para ERROR. O relatório de erros completo do trabalho é colocado no bucket do Amazon S3. Consulte Inspecione os erros para AWS IoT SiteWise para obter mais detalhes.

  • Para listar os trabalhos atuais, use a ação ListMetadataTransferJobs da API.

    Use um arquivo JSON para filtrar os trabalhos retornados com base no estado atual. Consulte o seguinte procedimento:

    1. Para especificar os filtros que você deseja usar, crie um arquivo JSON AWS CLI de entrada. quero usar:

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

      Para ver uma lista de state valores válidos, consulte ListMetadataTransferJobsFilter o Guia de referência AWS IoT TwinMaker da API.

    2. Use o arquivo JSON como argumento no comando de AWS CLI exemplo a seguir:

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

  • Para cancelar um trabalho, use a ação CancelMetadataTransferJob da API. Essa API cancela o trabalho de transferência de metadados específico, sem afetar nenhum recurso já exportado ou importado:

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