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 e tratamento de erros
Um trabalho de processo em massa demora para ser processado. Cada trabalho é processado na ordem de AWS IoT SiteWise recebimento da solicitação. Ele é processado one-at-a-time para cada conta. Quando um trabalho é concluído, o próximo na fila inicia automaticamente o processamento. AWS IoT SiteWise resolve os trabalhos de forma assíncrona e atualiza o status de cada um à medida que ele progride. Cada trabalho tem um campo de status que contém o estado do recurso e uma mensagem de erro, se aplicável.
O estado pode ser um dos seguintes valores:
+ `VALIDATING`: validação do trabalho, inclusive o formato do arquivo enviado e o conteúdo.
+ `PENDING`: o trabalho está em uma fila. Você pode cancelar trabalhos nesse estado pelo console do AWS IoT SiteWise , mas todos os outros estados continuarão até o final.
+ `RUNNING`: processamento do trabalho. Ele está criando e atualizando recursos conforme definido pelo arquivo de importação ou exportando recursos com base nos filtros do trabalho de exportação escolhidos. Se cancelado, nenhum recurso importado por esse trabalho é excluído. Consulte [Revisar o progresso dos trabalhos e os detalhes (console)](review-job-progress.md#review-job-progress-console) para obter mais informações.
+ `CANCELLING`: o trabalho está sendo cancelado ativamente.
+ `ERROR`: falha no processamento de um ou mais recursos. Consulte o relatório de trabalho detalhado para ter mais informações. Consulte [Inspecionar detalhes de erros (console)](inspect-errors.md#inspect-errors-console) para obter mais informações.
+ `COMPLETED`: trabalho concluído sem erros.
+ `CANCELLED`: o trabalho foi cancelado e não está na fila. Se você cancelou um `RUNNING` trabalho, os recursos já importados por esse trabalho no momento do cancelamento não serão excluídos do AWS IoT SiteWise.
**Topics**
+ [Acompanhamento do progresso dos trabalhos](review-job-progress.md)
+ [Inspecione erros para AWS IoT SiteWise](inspect-errors.md)
# Acompanhamento do progresso dos trabalhos
## Revisar o progresso dos trabalhos e os detalhes (console)
Consulte [Importar metadados (console)](running-bulk-operations-import.md#import-metadata-console) ou [Exportar metadados (console)](running-bulk-operations-export.md#export-metadata-console) para iniciar um trabalho em massa.
**Visão geral do progresso do trabalho no AWS IoT SiteWise console:**
1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Escolha **Operações em massa > Novo** no painel de navegação.
1. A tabela de **progresso de trabalhos** no AWS IoT SiteWise console exibe a lista de trabalhos de operação em massa.
1. 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.
1. A coluna **Status** exibe o status do trabalho. É possível selecionar um trabalho para ver detalhes sobre o trabalho.
1. 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 no AWS IoT SiteWise console:**
A tabela de **progresso de trabalhos** no AWS IoT SiteWise console exibe a lista de trabalhos de operação em massa.
1. Escolha um trabalho para ver mais detalhes.
1. Para um trabalho de **importação**, o `Data source ARN` representa o local do arquivo de importação no Amazon S3.
1. Para um trabalho de **exportação**, o `Data destination ARN` representa o local do arquivo depois da exportação no Amazon S3.
1. O `Status` e o `Status reason` dão detalhes adicionais sobre o trabalho atual. Consulte [Acompanhamento do progresso dos trabalhos e tratamento de erros](jobs-progress-error-handling.md) para obter mais detalhes.
1. 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.
1. 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.
1. `Succeeded`: indica a contagem de ativos transferidos com êxito durante o processo.
1. `Failed`: indica a contagem de ativos que falharam durante o processo.
1. `Skipped`: indica a contagem de ativos que foram ignorados durante o processo.
1. 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.
1. 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`.
1. Se o status de um trabalho for `COMPLETED` ou `ERROR`, a contagem `Total resources` será igual à soma das contagens detalhadas (`Succeeded`, `Failed` e `Skipped`).
1. 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)](inspect-errors.md#inspect-errors-console) para obter mais detalhes.
## Revisar o progresso dos trabalhos e os detalhes (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](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)API.
**Recupere informações com a API `GetMetadataTransferJob`:**
1. Crie e execute um trabalho de transferência. Chame a API `GetMetadataTransferJob`.
**Example AWS CLI comando:**
```
aws iottwinmaker get-metadata-transfer-job \
--metadata-transfer-job-id your_metadata_transfer_job_id \
--region your_region
```
1. 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 erros para AWS IoT SiteWise](inspect-errors.md) para obter mais detalhes.
+ Para listar os trabalhos atuais, use a ação [ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html)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 obter uma lista de `state` valores válidos, consulte [ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)o *Guia de referência AWS IoT TwinMaker da API*.
1. Use o arquivo JSON como argumento no seguinte AWS CLI exemplo de comando:
```
aws iottwinmaker list-metadata-transfer-job --region your_region \
--cli-input-json file://ListMetadataTransferJobsExample.json
```
+ Para cancelar um trabalho, use a ação [CancelMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CancelMetadataTransferJob.html)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
```
# Inspecione erros para AWS IoT SiteWise
## Inspecionar detalhes de erros (console)
**Detalhes do erro no AWS IoT SiteWise console:**
1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Consulte a tabela de **progresso de trabalhos** em Console do AWS IoT SiteWise para obter uma lista de trabalhos de operação em massa.
1. Selecione um trabalho para exibir os detalhes do trabalho.
1. Se o status de um trabalho for `COMPLETED` ou `ERROR`, a contagem `Total resources` será igual à soma das contagens detalhadas (`Succeeded`, `Failed` e `Skipped`).
1. 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.
1. A tabela **Falhas de trabalhos** exibe o conteúdo do relatório do trabalho. O campo `Resource type` indica o local do erro ou das falhas, como o seguinte:
+ Por exemplo, um erro de validação em `Bulk operations template`, no campo `Resource type`, indica que o modelo de importação e o formato do arquivo do esquema de metadados não coincidem. Consulte [AWS IoT SiteWise esquema de trabalho de transferência de metadados](bulk-operations-schema.md) para obter mais informações.
+ Uma falha em `Asset`, no campo `Resource type`, indica que o ativo não foi criado devido a um conflito com outro ativo. Consulte [Erros comuns](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/CommonErrors.html) para obter informações sobre erros e conflitos de AWS IoT SiteWise recursos.
## Inspecionar detalhes de erros (AWS CLI)
Para tratar e diagnosticar erros produzidos durante um trabalho de transferência, consulte o seguinte procedimento sobre como usar a ação de API `GetMetadataTransferJob`:
1. Depois de criar e executar um trabalho de transferência, ligue para [GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html):
```
aws iottwinmaker get-metadata-transfer-job \
--metadata-transfer-job-id your_metadata_transfer_job_id \
--region us-east-1
```
1. Depois de ver o estado do trabalho mudar para `COMPLETED`, você poderá começar a verificar os resultados do trabalho.
1. Quando você chama `GetMetadataTransferJob`, é retornado um objeto chamado [https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html).
O MetadataTransferJobProgress objeto contém os seguintes parâmetros:
+ **failedCount**: indica a contagem de ativos que falharam durante o processo de transferência.
+ **skippedCount**: indica a contagem de ativos que foram ignorados durante o processo de transferência.
+ **succeededCount**: indica a contagem de ativos transferidos com êxito no processo de transferência.
+ **totalCount**: indica a contagem total de ativos envolvidos no processo de transferência.
1. Além disso, a chamada de API retorna um elemento `reportUrl`, que contém um URL pré-assinado. Se o trabalho de transferência tiver algum problema que você precise investigar mais detalhadamente, visite esse URL.