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á. # Monitorando suas AWS DataSync transferências O monitoramento é importante para manter a confiabilidade e o desempenho das atividades de transferência do AWS DataSync . Recomendamos que você colete dados de monitoramento para que possa depurar mais facilmente erros, caso ocorram. Antes de começar a monitorar DataSync, no entanto, crie um plano de monitoramento que inclua respostas às seguintes perguntas: + Quais são seus objetivos de monitoramento? + Quais recursos você vai monitorar? + Com que frequência você vai monitorar esses recursos? + Quais ferramentas de monitoramento você usará? + Quem realizará o monitoramento das tarefas? + Quem deve ser notificado quando algo der errado? AWS fornece vários serviços e ferramentas para monitoramento DataSync. Você pode configurar algumas dessas para fazer o monitoramento em seu lugar; algumas delas exigem intervenção manual. Recomendamos que as tarefas de monitoramento sejam automatizadas ao máximo possível. **Topics** + [Como entender os contadores de desempenho de transferência de dados](transfer-performance-counters.md) + [Como monitorar transferências de dados com métricas do Amazon CloudWatch](monitor-datasync.md) + [Como monitorar as transferências de dados com relatórios de tarefas](task-reports.md) + [Monitoramento de transferências de dados com o Amazon CloudWatch Logs](configure-logging.md) + [Registrando chamadas de AWS DataSync API com AWS CloudTrail](logging-using-cloudtrail.md) + [Monitorando eventos usando a Amazon EventBridge](events.md) + [Monitoramento AWS DataSync com ferramentas manuais](monitoring-task-manually.md) # Como entender os contadores de desempenho de transferência de dados Quando você [inicia uma tarefa](run-task.md), AWS DataSync fornece contadores para ajudar a monitorar o desempenho e o progresso da transferência de dados. Use as informações a seguir para entender o que cada contador representa. Você pode ver esses contadores no DataSync console ou em uma [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)resposta. Alguns contadores não estão disponíveis em todos os [modos de tarefa](choosing-task-mode.md). | Console | `DescribeTaskExecution` | Suporte ao modo de tarefa | Description | | --- | --- | --- | --- | | – | `BytesWritten` | Avançado, Básico | O número de bytes lógicos que DataSync realmente gravam no local de destino. | | **Throughput total** | – | Avançado, Básico | A taxa na qual DataSync grava bytes lógicos no local de destino. Se você estiver usando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), a forma como você calcula esse contador depende do seu modo de tarefa: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) | | Dados transferidos | `BytesTransferred` | Avançado, Básico | O número de bytes DataSync enviados para a rede antes da compactação (se a compactação for possível). Para saber o número de bytes transferidos pela rede, consulte o contador de taxa de **transferência de rede** (no console) ou `BytesCompressed` (in [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)). | | **Excluído do destino** | `FilesDeleted` | Básico | O número de arquivos, objetos e diretórios que DataSync realmente são excluídos em seu local de destino. Se você não configurar a tarefa para excluir dados no destino que não estão na origem: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) | | **Excluído do destino** | `FilesDeleted`, `FoldersDeleted` | Avançado | O número de arquivos ou objetos e diretórios que DataSync realmente são excluídos em seu local de destino. Se você não configurar a tarefa para excluir dados no destino que não estão na origem: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) | | – | `EstimatedBytesToTransfer` | Avançado, Básico | O número de bytes lógicos que DataSync esperam gravar no local de destino. | | – | `EstimatedFilesToDelete` | Básico | O número de arquivos, objetos e diretórios que você DataSync espera excluir no local de destino. Se você não [configurar sua tarefa](configure-metadata.md#task-option-file-object-handling) para excluir os dados no destino que não estão na origem, o valor sempre será `0`. | | – | `EstimatedFilesToDelete`, `EstimatedFoldersToDelete` | Avançado | O número de arquivos, objetos e diretórios que você DataSync espera excluir no local de destino. Se você não [configurar sua tarefa](configure-metadata.md#task-option-file-object-handling) para excluir os dados no destino que não estão na origem, o valor sempre será `0`. | | – | `EstimatedFilesToTransfer` | Básico | O número de arquivos, objetos e diretórios que DataSync esperam ser transferidos pela rede. Esse valor é calculado enquanto DataSync [prepara](run-task.md#understand-task-execution-statuses) a transferência. A forma como isso é calculado depende principalmente do [modo de transferência](configure-metadata.md#task-option-transfer-mode) que você está usando: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) | | – | `EstimatedFilesToTransfer`, `EstimatedFoldersToTransfer` | Avançado | O número de arquivos ou objetos e diretórios que DataSync esperam ser transferidos pela rede. Esse valor é calculado enquanto DataSync [prepara](run-task.md#understand-task-execution-statuses) a transferência. A forma como isso é calculado depende principalmente do [modo de transferência](configure-metadata.md#task-option-transfer-mode) que você está usando: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) | | **Throughput de arquivo** | – | Avançado, Básico | A taxa na qual DataSync transfere arquivos, objetos e diretórios pela rede. Se você estiver usando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), a forma como você calcula esse contador depende do seu modo de tarefa: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) | | – | `FilesFailed`, `FoldersFailed` | Avançado | O número de arquivos, objetos e diretórios que DataSync falham na preparação, transferência, verificação e exclusão durante a execução da tarefa. Se houver falhas, você poderá vê-las ao lado dos contadores **Preparado**, **Transferido**, **Ignorado** e **Excluído do console de destino**, respectivamente. | | **Listado na fonte** | `FilesListed.AtSource`, `FoldersListed.AtSource` | Avançado | O número de arquivos ou objetos e diretórios DataSync encontrados no local de origem. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) | | – | `FilesListed.AtDestinationForDelete`, `FoldersListed.AtDestinationForDelete` | Avançado | O número de arquivos ou objetos e diretórios DataSync encontrados no local de destino. Este contador só se aplicará se você configurar a tarefa para [excluir dados no destino que não estejam na origem](configure-metadata.md#task-option-file-object-handling). | | **Taxa de transferência da rede** \$1 | `BytesCompressed` | Avançado, Básico | O número de bytes físicos que são DataSync transferidos pela rede após a compactação (se a compactação for possível). Esse número geralmente é menor que **os dados transferidos** (no console) ou `BytesTransferred` (em [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)), a menos que os dados não sejam compactáveis. \$1 No modo Avançado, a taxa de **transferência da rede** não é exibida no console. | | **Porcentagem compactada** | – | Avançado, Básico | A porcentagem de dados de transferência que DataSync foram compactados antes de serem enviados pela rede. Se você estiver usando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), você pode calcular esse contador com`1 - BytesCompressed / BytesWritten`. | | **Preparado** | `FilesPrepared`, `FoldersPrepared` | Avançado | O número de arquivos, objetos e diretórios que DataSync tentarão ser transferidos após comparar seus locais de origem e destino. No console, esse contador também pode mostrar o número de objetos que DataSync pulam durante a preparação. Para obter mais informações, consulte [Como DataSync prepara sua transferência de dados](how-datasync-transfer-works.md#how-datasync-prepares). Esse contador não é aplicável se você configurar a tarefa para [transferir todos os dados](configure-metadata.md#task-option-transfer-mode). Nesse cenário, DataSync copia tudo da origem ao destino sem comparar as diferenças entre os locais. | | **Taxa de processamento** | – | Avançado, Básico | A taxa na qual DataSync lê arquivos, objetos e diretórios no local de origem. A taxa de processamento é baseada em várias [CloudWatch métricas](monitor-datasync.md#accessing-metrics). As métricas exatas dependem do modo de tarefa que você está usando. **Modo Avançado**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) **Modo Básico:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/transfer-performance-counters.html) | | **Restante** | – | Básico | O número restante de arquivos, objetos e diretórios que DataSync esperam ser transferidos pela rede. Se você estiver usando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), você pode calcular esse contador `FilesTransferred` subtraindo de. `EstimatedFilesToTransfer` | | **Ignorado**\$1 | `FilesSkipped` | Básico | O número de arquivos, objetos e diretórios que são DataSync ignorados durante a transferência. | | – | `FilesSkipped`, `FoldersSkipped` | Avançado | O número de arquivos, objetos e diretórios que são DataSync ignorados durante a transferência. Os itens **ignorados** são incluídos no contador **preparado** ao [transferir somente os dados que foram alterados ou no](configure-metadata.md#task-option-transfer-mode) contador **transferido** ao [transferir](configure-metadata.md#task-option-transfer-mode) todos os dados. | | **Transferido** | `FilesTransferred` | Básico | O número de arquivos, objetos e diretórios que são DataSync transferidos pela rede. Esse valor é atualizado periodicamente durante a fase de execução da tarefa, quando algo é lido na fonte e enviado pela rede. Se DataSync não conseguir transferir algo, esse valor pode ser menor que `EstimatedFilesToTransfer` ou`EstimatedFoldersToTransfer`. Em alguns casos, esse valor também pode ser maior que `EstimatedFilesToTransfer` ou`EstimatedFoldersToTransfer`. Esse contador é específico da implementação para alguns tipos de local e, portanto, não o use como uma indicação exata do que está sendo transferido ou para monitorar a execução da tarefa. | | **Transferido** | `FilesTransferred`, `FoldersTransferred` | Avançado | O número de arquivos ou objetos e diretórios que são DataSync transferidos pela rede. Esse valor é atualizado periodicamente durante a fase de execução da tarefa, quando algo é lido na fonte e enviado pela rede. Se DataSync não conseguir transferir algo, esse valor pode ser menor que `EstimatedFilesToTransfer` ou`EstimatedFoldersToTransfer`. Em alguns casos, esse valor também pode ser maior que `EstimatedFilesToTransfer` ou`EstimatedFoldersToTransfer`. Esse contador é específico da implementação para alguns tipos de local e, portanto, não o use como uma indicação exata do que está sendo transferido ou para monitorar a execução da tarefa. | | **Verificado** | `FilesVerified` | Básico | O número de arquivos, objetos e diretórios que são DataSync verificados durante a transferência. Quando você configura sua tarefa para [verificar somente os dados transferidos](configure-data-verification-options.md), DataSync não verifica diretórios em algumas situações nem arquivos ou objetos que falham na transferência. | | **Verificado** | `FilesVerified`, `FoldersVerified` | Avançado | O número de arquivos ou objetos e diretórios que são DataSync verificados durante a transferência. | # Como monitorar transferências de dados com métricas do Amazon CloudWatch O Amazon CloudWatch fornece métricas para monitorar o desempenho da transferência do DataSync e solucionar problemas da tarefa de transferência. Você pode monitorar o desempenho da transferência do AWS DataSync usando as métricas do Amazon CloudWatch. As métricas do DataSync são enviadas automaticamente ao CloudWatch em intervalos de cinco minutos (independentemente de como você [configura a criação de logs).](configure-logging.md) As métricas são mantidas durante um período de 15 meses. Para ver as métricas do CloudWatch para o DataSync, você pode usar as seguintes ferramentas: + O console do CloudWatch + A CLI do CloudWatch + A API do CloudWatch + O console do DataSync (na página de detalhes da execução da tarefa) Para obter mais informações, consulte o [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html). ## Métricas do CloudWatch para DataSync As métricas do DataSync usam o namespace `aws/datasync` e fornecem métricas para as seguintes dimensões: + **AgentId**: o ID exclusivo do atendente (se a tarefa usar um atendente). + **TaskId**: o ID exclusivo da tarefa. Ele segue o formato `task-01234567890abcdef`. O namespace `aws/datasync` inclui as métricas a seguir. Algumas métricas não estão disponíveis em todos os [modos de tarefa](choosing-task-mode.md). | métrica do cloudwatch | Suporte ao modo de tarefa | Descrição | | --- | --- | --- | | `BytesCompressed` | Básico | O número de bytes físicos que o DataSync transfere pela rede após a compactação (se a compactação for possível). Tipicamente, esse número é menor do que `BytesTransferred`, a menos que os dados não sejam compactáveis. Unidade: bytes | | `BytesPreparedDestination` | Básico | O número total de bytes lógicos que o DataSync prepara no local de destino. Unidade: bytes | | `BytesPreparedSource` | Básico | O número total de bytes lógicos que o DataSync prepara no local de origem. Unidade: bytes | | `BytesTransferred` | Básico | O número de bytes que o DataSync envia para a rede antes da compactação (se a compactação for possível). Para saber o número de bytes transferidos pela rede, consulte a métrica `BytesCompressed`. Unidade: bytes | | `BytesVerifiedDestination` | Básico | O número de bytes lógicos que o DataSync verifica no local de destino. Unidade: bytes | | `BytesVerifiedSource` | Básico | O número de bytes lógicos que o DataSync verifica no local de origem. Unidades: bytes | | `BytesWritten` | Avançado, Básico | O número de bytes lógicos que o DataSync grava no local de destino. Unidade: bytes | | `FilesDeleted` | Avançado, Básico | O número de arquivos, objetos e diretórios que o DataSync exclui no local de destino. Se você não [configurar sua tarefa](configure-metadata.md#task-option-file-object-handling) para excluir os dados no destino que não estão na origem, o valor sempre será `0`. Unidade: Contagem | | `FilesListedSource` | Avançado | O número de objetos que o DataSync encontra no local de origem. Unidade: Contagem | | `FilesPrepared` | Avançado | O número de objetos que o DataSync tentará transferir depois de comparar os locais de origem e destino. Para obter mais informações, consulte [Como DataSync prepara sua transferência de dados](how-datasync-transfer-works.md#how-datasync-prepares). Essa métrica não é aplicável se você configurar a tarefa para [transferir todos os dados](configure-metadata.md#task-option-transfer-mode). Nesse cenário, o DataSync copia tudo da origem para o destino sem comparar diferenças entre os locais. Unidade: Contagem | | `FilesPreparedDestination` | Básico | O número de arquivos, objetos e diretórios que o DataSync prepara no local de destino. Unidade: Contagem | | `FilesPreparedSource` | Básico | O número de arquivos, objetos e diretórios que o DataSync prepara no local de origem. Unidade: Contagem | | `FilesSkipped` | Básico | O número de arquivos, objetos e diretórios que o DataSync ignora durante a transferência. Unidade: Contagem | | `FilesTransferred` | Avançado, Básico | O número de arquivos, objetos e diretórios que o DataSync transfere pela rede. Esse valor é atualizado periodicamente durante a fase de [execução da tarefa](run-task.md#understand-task-execution-statuses), quando algo é lido na fonte e enviado pela rede. Esse valor pode ser menor do que `EstimatedFilesToTransfer` em uma resposta a [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html) se houver falha em alguma transferência do DataSync. Em alguns casos, esse valor também pode ser maior que `EstimatedFilesToTransfer`. Essa métrica é específica da implementação para alguns tipos de local e, portanto, não a use como uma indicação exata do que foi transferido nem para monitorar a execução da tarefa. Unidade: Contagem | | `FilesVerified` | Avançado | O número de objetos que o DataSync de fato verifica durante a transferência. Unidade: Contagem | | `FilesVerifiedDestination` | Básico | O número de arquivos, objetos e diretórios que o DataSync verifica no local de destino. Unidade: Contagem | | `FilesVerifiedSource` | Básico | O número total de arquivos, objetos e diretórios que o DataSync verifica no local de origem. Unidade: Contagem | # Como monitorar as transferências de dados com relatórios de tarefas Os *relatórios de tarefa* fornecem informações detalhadas sobre o que o AWS DataSync tenta transferir, ignorar, verificar e excluir durante a execução de uma tarefa. Para obter mais informações, consulte [Como DataSync transfere arquivos, objetos e diretórios](how-datasync-transfer-works.md#transferring-files). Os relatórios de tarefa são gerados em formato JSON. Você pode personalizar o nível de detalhes dos relatórios: + [Os relatórios de tarefas somente resumidos](#task-report-types-summary) fornecem os detalhes necessários sobre a execução da tarefa, como quantos arquivos foram transferidos e se DataSync foi possível verificar a integridade dos dados desses arquivos. + Os [relatórios de tarefas padrão](#task-report-types-standard) incluem um resumo e relatórios detalhados que listam cada arquivo, objeto ou pasta que DataSync tenta transferir, ignorar, verificar e excluir. Com um relatório de tarefa padrão, você também pode especificar o [nível do relatório](#task-report-level) para mostrar somente os erros da execução da tarefa ou seus sucessos e erros. ## Casos de uso Aqui estão algumas situações em que relatórios de tarefa podem ajudar você a monitorar e auditar as transferências de dados: + Ao migrar milhões de arquivos, identifique rapidamente os arquivos DataSync com problemas de transferência. + Verifique chain-of-custody os processos dos seus arquivos. ## Relatórios de tarefas somente resumidos Um relatório que é apenas um resumo da execução de uma tarefa inclui os seguintes detalhes: + O Conta da AWS que executou a execução da tarefa + Os locais de origem e de destino + O número total de arquivos, objetos e pastas que foram ignorados, transferidos, verificados e excluídos + O total de bytes (lógicos e físicos) que foram transferidos + Se a execução da tarefa foi concluída, cancelada ou encontrou algum erro + Os horários de início e término (incluindo o tempo total da transferência) + As configurações da tarefa (como limites de largura de banda, verificação da integridade dos dados e outras opções para sua DataSync transferência) ## Relatórios de tarefas padrão Um relatório de tarefas padrão inclui um [resumo](#task-report-types-summary) da execução da tarefa, além de relatórios detalhados sobre quais DataSync tentativas transferir, ignorar, verificar e excluir. **Topics** + [Nível do relatório](#task-report-level) + [Relatórios de transferidos](#task-report-types-transferred) + [Relatórios de ignorados](#task-report-types-skipped) + [Relatórios verificados](#task-report-types-verified) + [Relatório de excluídos](#task-report-types-deleted) ### Nível do relatório Com os relatórios de tarefas padrão, você pode escolher um dos seguintes níveis de relatório: + Somente erros + Sucessos e erros (essencialmente uma lista de tudo o que aconteceu durante a execução da tarefa) Por exemplo, talvez você queira ver quais arquivos DataSync foram ignorados com sucesso durante a transferência e quais não foram. Os arquivos que DataSync foram ignorados com sucesso podem ser aqueles que você deseja DataSync excluir propositalmente porque eles já existem no seu local de destino. No entanto, um erro ignorado, por exemplo, pode indicar que DataSync ele não tem as permissões corretas para ler um arquivo. ### Relatórios de transferidos Uma lista de arquivos, objetos e diretórios que DataSync tentaram ser transferidos durante a execução da tarefa. Um relatório de transferidos inclui os seguintes detalhes: + Os caminhos para os dados transferidos + O que foi transferido (conteúdo, metadados ou ambos) + Os metadados, que incluem o tipo de dados, o tamanho do conteúdo (somente objetos e arquivos) e muito mais + A hora em que um item foi transferido + A versão do objeto (se o destino for um bucket do Amazon S3 com versionamento habilitado) + Se algo foi sobrescrito no destino + Se um item foi transferido com sucesso **nota** Ao mover dados entre buckets do S3, o prefixo que você especifica no seu [local de origem](create-s3-location.md) pode aparecer no seu relatório (ou nos CloudWatch registros da Amazon), mesmo que esse prefixo não exista como um objeto no seu local de destino. (No DataSync console, você também pode notar que esse prefixo aparece como dados ignorados ou verificados.) ### Relatórios de ignorados Uma lista de arquivos, objetos e diretórios DataSync encontrados no local de origem, mas que não tentaram transferir. Os motivos pelos quais DataSync os dados são ignorados podem depender de vários fatores, como a forma como você configura suas tarefas e as permissões do sistema de armazenamento. Veja alguns exemplos: + Existe um arquivo nos locais de origem e de destino. O arquivo na origem não foi modificado desde a execução anterior da tarefa. Como você está [transferindo apenas dados que foram alterados](configure-metadata.md#task-option-transfer-mode), DataSync não transfere esse arquivo na próxima vez que executar sua tarefa. + Um objeto que existe nos dois locais muda na origem. Ao executar sua tarefa, DataSync ignora esse objeto em seu destino porque sua tarefa não [sobrescreve os dados no](configure-metadata.md#task-option-file-object-handling) destino. + DataSync ignora um objeto em sua fonte que está usando uma [classe de armazenamento de arquivamento](create-s3-location.md#using-storage-classes) e não é restaurado. Você deve restaurar um objeto arquivado DataSync para poder lê-lo. + DataSync ignora um arquivo, objeto ou diretório em seu local de origem porque não consegue lê-lo. Se isso acontecer e não for esperado, verifique as permissões de acesso do seu armazenamento e certifique-se de que ele DataSync possa ler o que foi ignorado. Um relatório de ignorados inclui os seguintes detalhes: + Os caminhos para dados ignorados + A hora em que um item foi ignorado + O motivo pelo qual foi ignorado + Se um item foi ignorado com sucesso **nota** Os relatórios de ignorados podem ser grandes quando incluem sucessos e erros, você configura a tarefa para [transferir apenas os dados que foram alterados](configure-metadata.md) e os dados de origem já existem no destino. ### Relatórios verificados Uma lista de arquivos, objetos e diretórios que DataSync tentaram verificar a integridade durante a execução da tarefa. Um de verificados inclui os seguintes detalhes: + Os caminhos para dados verificados + A hora em que um item foi verificado + O motivo da falha na verificação (se for o caso) + As SHA256 somas de verificação de origem e destino (somente arquivos) + Se um item foi verificado com sucesso Observe o seguinte sobre relatórios verificados: + Quando você configura sua tarefa para [verificar somente os dados transferidos](configure-data-verification-options.md), DataSync não verifica diretórios em algumas situações nem arquivos ou objetos que falham na transferência. Em ambos os casos, DataSync não inclui dados não verificados neste relatório. + Se você estiver usando o [modo Avançado](choosing-task-mode.md), a verificação poderá demorar mais que o normal se você estiver transferindo objetos grandes. ### Relatório de excluídos Uma lista de arquivos, diretórios e objetos que foram excluídos durante a execução da tarefa. DataSync gera esse relatório somente se você [configurar sua tarefa](configure-metadata.md) para excluir dados no local de destino que não esteja na origem. Um relatório de dados excluídos inclui os seguintes detalhes: + Os caminhos para dados excluídos + Se um item foi excluído com sucesso + A hora em que um item foi excluído ## Exemplos de relatórios de tarefa Você define o nível de detalhe em seu relatório de tarefas. Aqui estão alguns exemplos de relatórios de dados transferidos com a seguinte configuração: + **Tipo de relatório**: padrão + **Nível do relatório**: sucessos e erros **nota** Os relatórios usam o padrão ISO-8601 para o formato de carimbo de data/hora. Os horários estão em UTC e medidos em nanossegundos. Esse comportamento difere de como algumas outras métricas do relatório de tarefas são medidas. Por exemplo, [detalhes da execução da tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskExecutionResultDetail.html), como `TransferDuration` e `VerifyDuration`, são medidos em milissegundos. Os relatórios de tarefas do modo Avançado usam um esquema um pouco diferente dos relatórios de tarefas do modo Básico. Os exemplos a seguir podem ajudar a entender o que você pode esperar dos relatórios, dependendo do [modo de tarefa](choosing-task-mode.md) usado. **Exemplo de relatórios de dados transferidos com status de sucesso** Os relatórios a seguir mostram transferências bem-sucedidas para um objeto chamado `object1.txt`. ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "object1.txt", "SourceMetadata": { "Type": "Object", "ContentSize": 6, "LastModified": "2024-10-04T14:40:55Z", "SystemMetadata": { "ContentType": "binary/octet-stream", "ETag": "\"9b2d7e1f8054c3a2041905d0378e6f14\"", "ServerSideEncryption": "AES256" }, "UserMetadata": {}, "Tags": [] }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2024-10-04T14:48:39.748862183Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "SUCCESS" }] } ``` ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "/object1.txt", "SrcMetadata": { "Type": "Regular", "ContentSize": 6, "Mtime": "2022-01-07T16:59:26.136114671Z", "Atime": "2022-01-07T16:59:26.136114671Z", "Uid": 0, "Gid": 0, "Mode": "0644" }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2022-01-07T16:59:45.747270957Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "SUCCESS" }] } ``` **Exemplo de relatórios de dados transferidos com status de erro** Os relatórios a seguir fornecem exemplos de quando não é DataSync possível transferir um objeto chamado`object1.txt`. Esse relatório mostra que não DataSync consigo acessar um objeto chamado `object1.txt` devido a um problema de AWS KMS permissões. (Se receber um erro como esse, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption).) ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "object1.txt", "SourceMetadata": { "Type": "Object", "ContentSize": 6, "LastModified": "2022-10-07T20:48:32Z", "SystemMetadata": { "ContentType": "binary/octet-stream", "ETag": "\"3a7c0b2f1d9e5c4a6f8b2e0d1c9f7a3b2\"", "ServerSideEncryption": "AES256" }, "UserMetadata": {}, "Tags": [] }, "Overwrite": "False", "TransferTimestamp": "2022-10-09T16:05:11.134040717Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "FAILED", "ErrorCode": "AccessDenied", "ErrorDetail": "User: arn:aws:sts::111222333444:assumed-role/AWSDataSyncS3Bucket/AwsSync-loc-0b3017fc4ba4a2d8d is not authorized to perform: kms:GenerateDataKey on resource: arn:aws:kms:us-east-1:111222333444:key/1111aaaa-22bb-33cc-44d-5555eeee6666 because no identity-based policy allows the kms:GenerateDataKey action" }] } ``` Esse relatório mostra que um objeto denominado `object1.txt` não foi transferido devido a um problema de permissões do bucket do S3. (Se receber um erro como esse, consulte [Fornecendo DataSync acesso aos buckets do S3](create-s3-location.md#create-s3-location-access).) ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "/object1.txt", "SrcMetadata": { "Type": "Regular", "ContentSize": 6, "Mtime": "2022-01-07T16:59:26.136114671Z", "Atime": "2022-01-07T16:59:26.136114671Z", "Uid": 0, "Gid": 0, "Mode": "0644" }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2022-01-07T16:59:45.747270957Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "FAILED", "FailureReason": "S3 Get Object Failed", "FailureCode": 40974 }] } ``` ## Limitações + Os relatórios de tarefas individuais não podem exceder 5 MB. Se você estiver copiando um grande número de arquivos, seu relatório de tarefas poderá ser dividido em vários relatórios. + Há situações em que criar relatórios de tarefa pode afetar a performance da transferência de dados. Por exemplo, isso pode ser percebido quando a conexão de rede tem alta latência e os arquivos sendo transferidos são pequenos ou você só está copiando alterações de metadados. # Criando seus relatórios de DataSync tarefas AWS DataSync os relatórios de tarefas podem ser apenas um resumo da execução da tarefa ou um conjunto de relatórios detalhados sobre quais DataSync tentativas transferir, ignorar, verificar e excluir. ## Pré-requisitos Antes de poder criar um relatório de tarefas, é necessário fazer o seguinte. **Topics** + [Criar um bucket do S3 para os relatórios de tarefa](#setting-up-task-report-create-bucket) + [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access) ### Criar um bucket do S3 para os relatórios de tarefa Se você ainda não tiver um, [crie um bucket do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) para DataSync fazer o upload do seu relatório de tarefas. Os relatórios são armazenados na classe de armazenamento S3 Standard. Recomendamos o seguinte para esse bucket: + Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefa se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. + Para evitar uma configuração complexa de permissões de acesso, verifique se o bucket do relatório de tarefas está na mesma Conta da AWS região da tarefa DataSync de transferência. ### Permita DataSync o upload de relatórios de tarefas para seu bucket do S3 Você deve configurar uma função AWS Identity and Access Management (IAM) que permita DataSync fazer o upload de um relatório de tarefas para seu bucket do S3. No DataSync console, você pode criar uma função do IAM que, na maioria dos casos, inclui automaticamente as permissões para carregar um relatório de tarefas no seu bucket. Lembre-se de que essa função gerada automaticamente pode não atender às suas necessidades do ponto de vista de privilégios mínimos. Essa função também não funcionará se seu bucket for criptografado com uma chave gerenciada pelo cliente AWS Key Management Service (AWS KMS) (SSE-KMS). Nesses casos, você pode criar a função manualmente, desde que ela faça pelo menos o seguinte: + [Prevenção do problema de adjunto confuso](https://docs.aws.amazon.com/datasync/latest/userguide/cross-service-confused-deputy-prevention.html) na entidade confiável da função. O exemplo completo a seguir mostra como você pode usar as chaves de contexto de condição `aws:SourceAccount` global `aws:SourceArn` e as chaves de contexto para evitar o problema confuso do substituto com DataSync. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "123456789012" }, "ArnLike": { "aws:SourceArn": "arn:aws:datasync:us-east-1:123456789012:*" } } } ] } ``` ------ + Permite DataSync fazer o upload de um relatório de tarefas para seu bucket do S3. O exemplo a seguir faz isso incluindo a ação `s3:PutObject` somente para um prefixo específico (`reports/`) em seu bucket. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Action": [ "s3:PutObject" ], "Effect": "Allow", "Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*" }] } ``` ------ + Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a [política da chave](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). ## Criar um relatório de tarefas somente resumido Você pode configurar um relatório de tarefas que inclua um [resumo somente](task-reports.md#task-report-types-summary) ao criar sua DataSync tarefa, iniciá-la ou atualizá-la. As etapas a seguir mostram como configurar um relatório de tarefas somente resumido ao criar uma tarefa. ### Usando o DataSync console 1. Abra o AWS DataSync console em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. No painel de navegação esquerdo, expanda **Transferência de dados**, escolha **Tarefas** e, em seguida, escolha **Criar tarefa**. 1. Configure os locais de origem e destino da sua tarefa. Para obter mais informações, consulte [Para onde posso transferir meus dados AWS DataSync?](working-with-locations.md). 1. Role para baixo até a seção **Relatório de tarefa**. Em **Tipo de relatório**, escolha **Resumo somente**. 1. Para o **bucket do S3 para relatórios**, escolha um bucket do S3 no qual você deseja DataSync fazer o upload do seu relatório de tarefas. **dica** Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefa se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. 1. Em **Pasta**, insira um prefixo para usar no seu relatório de tarefas ao DataSync carregar o relatório no seu bucket do S3 (por exemplo,). **reports/** Certifique-se de incluir o caractere delimitador apropriado no final do prefixo. Esse caractere geralmente é uma barra para frente (`/`). Para obter mais informações, consulte [Organizando objetos usando prefixos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) no *Guia de usuário do Amazon S3*. 1. Em **Perfil do IAM**, siga um destes procedimentos: + Escolha **Autogenerate** para criar DataSync automaticamente uma função do IAM com as permissões necessárias para acessar o bucket do S3. Se uma função do IAM foi criada DataSync anteriormente para esse bucket do S3, essa função é escolhida por padrão. + Escolha um perfil do IAM personalizado que você criou. Em alguns casos, talvez seja necessário criar o perfil por conta própria. Para obter mais informações, consulte [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access). **Importante** Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a política da chave deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). 1. Conclua a criação da tarefa e, em seguida, [inicie a tarefa](run-task.md) para começar a transferir seus dados. Quando sua transferência estiver concluída, você poderá [visualizar seu relatório de tarefa](task-report-viewing.md). ### Usando o AWS CLI 1. Copie o seguinte comando `create-task` AWS Command Line Interface (AWS CLI): ``` aws datasync create-task \ --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \ --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \ --task-report-config '{ "Destination":{ "S3":{ "Subdirectory":"reports/", "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket", "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role" } }, "OutputType":"SUMMARY_ONLY" }' ``` 1. Para o parâmetro `--source-location-arn`, especifique o nome do recurso da Amazon (ARN) do local de origem na transferência. `us-east-1`Substitua pelo apropriado Região da AWS, `123456789012` substitua pelo Conta da AWS número apropriado e `12345678abcdefgh` substitua pelo ID do local de origem apropriado. 1. No parâmetro `--destination-location-arn`, especifique o ARN do local de destino em sua transferência. `us-east-1`Substitua pelo apropriado Região da AWS, `123456789012` substitua pelo Conta da AWS número apropriado e `abcdefgh12345678` substitua pelo ID do local de destino apropriado. 1. No parâmetro `--task-report-config` faça o seguinte: + `Subdirectory`— `reports/` Substitua pelo prefixo no bucket do S3 em que você deseja DataSync fazer o upload dos relatórios de tarefas. Certifique-se de incluir o caractere delimitador apropriado no final do prefixo. Esse caractere geralmente é uma barra para frente (`/`). Para obter mais informações, consulte [Organizando objetos usando prefixos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) no *Guia de usuário do Amazon S3*. + `S3BucketArn`: especifique o ARN do bucket do S3 no qual deseja fazer upload do relatório de tarefa. **dica** Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefas se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. + `BucketAccessRoleArn`— Especifique a função do IAM que permite DataSync fazer o upload de um relatório de tarefas para seu bucket do S3. Para obter mais informações, consulte [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access). **Importante** Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a política da chave deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). + `OutputType`: especifique `SUMMARY_ONLY`. Para obter mais informações, consulte [Relatórios de tarefas somente resumidos](task-reports.md#task-report-types-summary). 1. Execute o comando `create-task` para criar sua tarefa. Você recebe uma resposta como a seguinte, que mostra o ARN da tarefa que você criou. Você precisará desse ARN para executar o comando `start-task-execution`. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Copie o seguinte comando `start-task-execution`: ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Para o parâmetro `--task-arn`, especifique o ARN da tarefa que você está iniciando. Use o ARN que você recebeu ao executar o comando `create-task`. 1. Execute o comando `start-task-execution`. Quando sua transferência estiver concluída, você poderá [visualizar seu relatório de tarefa](task-report-viewing.md). ## Criar um relatório de tarefas padrão Você pode configurar um [relatório de tarefas padrão](task-reports.md#task-report-types-standard) ao criar sua DataSync tarefa, iniciá-la ou atualizá-la. As etapas a seguir mostram como configurar um relatório de tarefas padrão ao criar uma tarefa. ### Usando o DataSync console 1. Abra o AWS DataSync console em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. No painel de navegação esquerdo, expanda **Transferência de dados**, escolha **Tarefas** e, em seguida, escolha **Criar tarefa**. 1. Configure os locais de origem e destino da sua tarefa. Para obter mais informações, consulte [Para onde posso transferir meus dados AWS DataSync?](working-with-locations.md). 1. Role para baixo até a seção **Relatório de tarefa**. Em **Relatório de tarefa**, escolha **Relatório padrão**. 1. Em **Nível de relatório**, escolha uma das seguintes opções: + **Somente erros** — Seu relatório de tarefas inclui apenas problemas com o que você DataSync tentou transferir, ignorar, verificar e excluir. + **Sucessos e erros** — Seu relatório de tarefas inclui o que foi transferido, ignorado, verificado e excluído DataSync com sucesso e o que não foi. + **Personalizado**: permite que você escolha se deseja ver somente erros ou sucessos e erros em aspectos específicos do seu relatório de tarefas. Por exemplo, você pode escolher **Sucessos e erros** para a lista de arquivos transferidos, mas **Somente erros** para o restante do relatório. 1. Se você estiver transferindo para um bucket do S3 que usa controle de versão de objetos, mantenha a opção ** Incluir versões de objetos do Amazon S3** selecionada se quiser que seu relatório inclua a nova versão para cada objeto transferido. 1. Para o **bucket do S3 para relatórios**, escolha um bucket do S3 no qual você deseja DataSync fazer o upload do seu relatório de tarefas. **dica** Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefa se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. 1. Em **Pasta**, insira um prefixo para usar no seu relatório de tarefas ao DataSync carregar o relatório no seu bucket do S3 (por exemplo,). **reports/** Certifique-se de incluir o caractere delimitador apropriado no final do prefixo. Esse caractere geralmente é uma barra para frente (`/`). Para obter mais informações, consulte [Organizando objetos usando prefixos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) no *Guia de usuário do Amazon S3*. 1. Em **Perfil do IAM**, siga um destes procedimentos: + Escolha **Autogenerate** para criar DataSync automaticamente uma função do IAM com as permissões necessárias para acessar o bucket do S3. Se uma função do IAM foi criada DataSync anteriormente para esse bucket do S3, essa função é escolhida por padrão. + Escolha um perfil do IAM personalizado que você criou. Em alguns casos, talvez seja necessário criar o perfil por conta própria. Para obter mais informações, consulte [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access). **Importante** Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a política da chave deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). 1. Conclua a criação da tarefa e [inicie a tarefa](run-task.md) para começar a transferir seus dados. Quando sua transferência estiver concluída, você poderá [visualizar seu relatório de tarefa](task-report-viewing.md). ### Usando o AWS CLI 1. Copie o seguinte comando `create-task`: ``` aws datasync create-task \ --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \ --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \ --task-report-config '{ "Destination":{ "S3":{ "Subdirectory":"reports/", "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket", "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role" } }, "OutputType":"STANDARD", "ReportLevel":"level-of-detail", "ObjectVersionIds":"include-or-not" }' ``` 1. Para o parâmetro `--source-location-arn`, especifique o ARN do local de origem na transferência. `us-east-1`Substitua pelo apropriado Região da AWS, `123456789012` substitua pelo Conta da AWS número apropriado e `12345678abcdefgh` substitua pelo ID do local de origem apropriado. 1. No parâmetro `--destination-location-arn`, especifique o ARN do local de destino em sua transferência. `us-east-1`Substitua pelo apropriado Região da AWS, `123456789012` substitua pelo Conta da AWS número apropriado e `abcdefgh12345678` substitua pelo ID do local de destino apropriado. 1. No parâmetro `--task-report-config` faça o seguinte: + `Subdirectory`— `reports/` Substitua pelo prefixo no bucket do S3 em que você deseja DataSync fazer o upload dos relatórios de tarefas. Certifique-se de incluir o caractere delimitador apropriado no final do prefixo. Esse caractere geralmente é uma barra para frente (`/`). Para obter mais informações, consulte [Organizando objetos usando prefixos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) no *Guia de usuário do Amazon S3*. + `S3BucketArn`: especifique o ARN do bucket do S3 no qual deseja fazer upload do relatório de tarefa. **dica** Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefas se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. + `BucketAccessRoleArn`— Especifique a função do IAM que permite DataSync fazer o upload de um relatório de tarefas para seu bucket do S3. Para obter mais informações, consulte [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access). **Importante** Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a política da chave deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). + `OutputType`: especifique o relatório `STANDARD`. Para obter mais informações sobre tipos de dados, consulte [Relatórios de tarefas padrão](task-reports.md#task-report-types-standard)Tipos de relatórios de tarefas. + (Opcional) `ReportLevel`: especifique se você deseja `ERRORS_ONLY` (o padrão) ou `SUCCESSES_AND_ERRORS` em seu relatório. + (Opcional) `ObjectVersionIds`: se você estiver fazendo uma transferência para um bucket do S3 que usa controle de versionamento de objetos, especifique `NONE` se não deseja incluir a nova versão de cada objeto transferido no relatório. Essa opção é definida como `INCLUDE` por padrão. + (Opcional) `Overrides`: personalize o `ReportLevel` de um aspecto específico do seu relatório. Por exemplo, talvez você queira ver `SUCCESSES_AND_ERRORS` a lista do que é DataSync excluído em seu local de destino, mas quer ver todo `ERRORS_ONLY` o resto. Neste exemplo, você adicionaria a seguinte opção `Overrides` ao parâmetro `--task-report-config`: ``` "Overrides":{ "Deleted":{ "ReportLevel":"SUCCESSES_AND_ERRORS" } } ``` Se você não usar `Overrides`, todo o relatório usará o `ReportLevel` que você especificar. 1. Execute o comando `create-task` para criar sua tarefa. Você recebe uma resposta como a seguinte, que mostra o ARN da tarefa que você criou. Você precisará desse ARN para executar o comando `start-task-execution`. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Copie o seguinte comando `start-task-execution`: ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Para o parâmetro `--task-arn`, especifique o ARN da tarefa que você está executando. Use o ARN que você recebeu ao executar o comando `create-task`. 1. Execute o comando `start-task-execution`. Quando sua transferência estiver concluída, você poderá [visualizar seu relatório de tarefa](task-report-viewing.md). # Visualizando seus relatórios de DataSync tarefas DataSync cria relatórios de tarefas para cada execução de tarefa. Quando a execução é concluída, você pode encontrar os relatórios de tarefa relacionados no bucket do S3. Os relatórios de tarefas são organizados sob prefixos que incluem suas tarefas e suas execuções. IDs Para ajudar a localizar relatórios de tarefas em seu bucket do S3, use estes exemplos: + **Relatório de tarefas somente resumido**: `reports-prefix/Summary-Reports/task-id-folder/task-execution-id-folder` + **Relatório de tarefas padrão**: `reports-prefix/Detailed-Reports/task-id-folder/task-execution-id-folder` Como os relatórios de tarefa são no formato JSON, você tem várias opções para visualizá-los: + Visualize um relatório usando o [Amazon S3 Select](https://docs.aws.amazon.com/AmazonS3/latest/userguide/selecting-content-from-objects.html). + Visualize relatórios usando AWS serviços como AWS Glue Amazon Athena e Amazon Quick. Para obter mais informações sobre visualização de relatórios de tarefa, consulte o [Blog sobre armazenamento da AWS](https://aws.amazon.com/blogs/storage/derive-insights-from-aws-datasync-task-reports-using-aws-glue-amazon-athena-and-amazon-quicksight/). # Monitoramento de transferências de dados com o Amazon CloudWatch Logs Você pode monitorar sua AWS DataSync transferência usando o CloudWatch Logs. Recomendamos configurar uma tarefa para pelo menos registrar em log informações básicas (como erros de transferência). ## DataSync Permitindo o upload de registros para um grupo de CloudWatch registros Para [configurar o registro](#configure-logging-for-task) para sua DataSync tarefa, você precisa de um grupo de CloudWatch registros que DataSync tenha permissão para enviar registros para. Você configura esse acesso por meio de uma função AWS Identity and Access Management (IAM). A forma como isso funciona especificamente depende do [modo de tarefa](choosing-task-mode.md). ------ #### [ Enhanced mode ] Com o modo Avançado, envia DataSync automaticamente os registros de tarefas para um grupo de registros chamado`/aws/datasync`. Se esse grupo de registros não existir no seu Região da AWS, DataSync crie o grupo de registros em seu nome usando uma [função vinculada ao serviço](https://docs.aws.amazon.com/datasync/latest/userguide/using-service-linked-roles-service-action-2.html) do IAM ao criar sua tarefa. ------ #### [ Basic mode ] Há algumas maneiras de configurar um grupo de CloudWatch registros para uma DataSync tarefa usando o modo Básico. No console, você pode criar automaticamente uma função do IAM que, na maioria dos casos, inclui as permissões DataSync necessárias para carregar registros. Lembre-se de que essa função gerada automaticamente pode não atender às suas necessidades do ponto de vista de privilégios mínimos. Se você quiser usar um grupo de CloudWatch registros existente ou estiver criando suas tarefas programaticamente, você mesmo deverá criar a função do IAM. O exemplo a seguir é uma política do IAM que concede essas permissões. **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "DataSyncLogsToCloudWatchLogs", "Effect": "Allow", "Action": [ "logs:PutLogEvents", "logs:CreateLogStream" ], "Principal": { "Service": "datasync.amazonaws.com" }, "Condition": { "ArnLike": { "aws:SourceArn": [ "arn:aws:datasync:us-east-1:444455556666:task/*" ] }, "StringEquals": { "aws:SourceAccount": "444455556666" } }, "Resource": "arn:aws:logs:us-east-1:444455556666:log-group:*:*" } ] } ``` A política usa `Condition` declarações para ajudar a garantir que somente DataSync as tarefas da conta especificada tenham acesso ao grupo de CloudWatch registros especificado. Recomendamos usar as chaves de contexto de condição global [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) e [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) nessas declarações `Condition` para se proteger contra o confuso problema do substituto. Para obter mais informações, consulte [Prevenção contra o ataque do “substituto confuso” em todos os serviços](cross-service-confused-deputy-prevention.md). Para especificar a DataSync tarefa ou tarefas, *`region`* substitua pelo código da região Região da AWS onde as tarefas estão localizadas (por exemplo,`us-west-2`) e *`account-id`* substitua pela Conta da AWS ID da conta que contém as tarefas. Para especificar o grupo de CloudWatch registros, substitua os mesmos valores. Você também pode modificar a instrução `Resource` para atingir grupos de logs específicos. Para obter mais informações sobre usar `SourceArn` e `SourceAccount`, consulte [Chaves de condição global](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) no *Guia do usuário do IAM*. Para aplicar a política, salve essa instrução de política em um arquivo no computador local. Em seguida, execute o AWS CLI comando a seguir para aplicar a política de recursos. Para usar esse exemplo de comando, substitua `full-path-to-policy-file` pelo caminho do arquivo que contém a instrução da política. ``` aws logs put-resource-policy --policy-name trust-datasync --policy-document file://full-path-to-policy-file ``` **nota** Execute esse comando usando o mesmo Conta da AWS e Região da AWS onde você ativou seu DataSync agente. Para obter mais informações, consulte o [https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html). ------ ## Configurando o registro para sua tarefa DataSync Recomendamos que você configure pelo menos algum nível de registro para sua DataSync tarefa. **Antes de começar** DataSync precisa de permissão para carregar registros em um grupo de CloudWatch registros. Para obter mais informações, consulte [DataSync Permitindo o upload de registros para um grupo de CloudWatch registros](#cloudwatchlogs). ### Usando o DataSync console As instruções a seguir descrevem como configurar o CloudWatch registro ao criar uma tarefa. Você também pode configurar a criação de logs ao editar uma tarefa. 1. Abra o AWS DataSync console em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. No painel de navegação esquerdo, expanda **Transferência de dados**, escolha **Tarefas** e, em seguida, escolha **Criar tarefa**. 1. Configure os locais de origem e destino da sua tarefa. Para obter mais informações, consulte [Para onde posso transferir meus dados AWS DataSync?](working-with-locations.md). 1. Na página **Definir configurações**, escolha um [modo de tarefa](choosing-task-mode.md) e quaisquer outras opções. Talvez você esteja interessado em algumas das seguintes opções: + Especifique quais dados transferir usando um [manifesto](transferring-with-manifest.md) ou [filtros](filtering.md). + Configure como [lidar com metadados de arquivos](configure-metadata.md) e [verificar a integridade dos dados](configure-data-verification-options.md). 1. Em **Eventos de log**, selecione uma das seguintes opções: + **Registrar em log informações básicas como erros de transferência**: publicar logs apenas com informações básicas (tais como erros de transferência). + **Registre todos os objetos e arquivos transferidos** — publique registros de todos os arquivos ou objetos DataSync transferidos e realize verificações de integridade de dados. + **Não gerar logs** 1. Siga um destes procedimentos, dependendo do modo de tarefa que você está usando para criar ou especificar um grupo de CloudWatch registros: ------ #### [ Enhanced mode ] Quando você escolhe **Criar tarefa**, usa (ou cria) DataSync automaticamente um grupo de registros chamado`/aws/datasync`. ------ #### [ Basic mode ] Para **grupo de CloudWatch registros**, especifique um grupo de registros que DataSync tenha permissão para fazer upload de registros fazendo o seguinte: + Escolha **Geração automática** para criar automaticamente um grupo de registros que permita DataSync fazer upload de registros para ele. + Escolha um grupo de logs existente na sua Região da AWS atual. Se você escolher um grupo de registros existente, verifique se ele [DataSync tem permissão](#cloudwatchlogs) para fazer upload de registros para esse grupo de registros. ------ 1. Escolha **Criar tarefa**. Você está pronto para [iniciar a tarefa](run-task.md). ### Usando o AWS CLI 1. Copie o seguinte comando `create-task`: ``` aws datasync create-task \ --source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \ --destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \ --task-mode "ENHANCED-or-BASIC" \ --name "task-name" \ --options '{"LogLevel": "log-level"}' \ --cloudwatch-log-group-arn "arn:aws:logs:us-east-1:account-id:log-group:log-group-name:*" ``` 1. Em `--source-location-arn`, especifique o nome do recurso da Amazon (ARN) do local de origem na transferência. 1. Em `--destination-location-arn`, especifique o ARN do local de destino. Se você estiver transferindo entre Regiões da AWS nossas contas, verifique se o ARN inclui a outra ID de região ou conta. 1. Para `--task-mode`, especifique `ENHANCED` ou `BASIC`. 1. (Recomendado) Em `--name`, especifique um nome para a tarefa de que você possa se lembrar. 1. Para `LogLevel`, especifique uma das seguintes opções: + `BASIC`: publica logs apenas com informações básicas (como erros de transferência). + `TRANSFER`— publique registros de todos os arquivos ou objetos que DataSync transferem e realizam verificações de integridade de dados. + `NONE`: não gerar logs. 1. Para -`-cloudwatch-log-group-arn`, especifique o ARN de um grupo de CloudWatch registros. **Importante** Se o `--task-mode` for `ENHANCED`, você não precisa especificar essa opção. Para obter mais informações, consulte [DataSync Permitindo o upload de registros para um grupo de CloudWatch registros](#cloudwatchlogs). 1. Execute o comando `create-task`. Se o comando for bem-sucedido, você receberá uma resposta que mostra o ARN da tarefa que você criou. Por exemplo: ``` { "TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026" } ``` Você está pronto para [iniciar a tarefa](run-task.md). ### Usando a DataSync API Você pode configurar o CloudWatch registro para sua tarefa usando o `CloudWatchLogGroupArn` parâmetro com qualquer uma das seguintes operações: + [https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html) + [https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html) ## Visualizando registros de DataSync tarefas Ao [iniciar sua tarefa](run-task.md), você pode visualizar os registros da execução da tarefa usando o CloudWatch console ou AWS CLI (entre outras opções). Para obter mais informações, consulte o [https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html). DataSync fornece registros estruturados em JSON para tarefas do modo Avançado. As tarefas do modo Básico têm logs não estruturados. Os exemplos a seguir mostram como os erros de verificação são exibidos nos logs do modo Avançado, em comparação com o Básico. ------ #### [ Enhanced mode log example ] ``` { "Action": "VERIFY", "Source": { "LocationId": "loc-abcdef01234567890", "RelativePath": "directory1/directory2/file1.txt" }, "Destination": { "LocationId": "loc-05ab2fdc272204a5f", "RelativePath": "directory1/directory2/file1.txt", "Metadata": { "Type": "Object", "ContentSize": 66060288, "LastModified": "2024-10-03T20:46:58Z", "S3": { "SystemMetadata": { "ContentType": "binary/octet-stream", "ETag": "\"1234abcd5678efgh9012ijkl3456mnop\"", "ServerSideEncryption": "AES256" }, "UserMetadata": { "file-mtime": "1602647222/222919600" }, "Tags": {} } } }, "ErrorCode": "FileNotAtSource", "ErrorDetail": "Verification failed due to file being present at the destination but not at the source" } ``` ------ #### [ Basic mode log example ] ``` [NOTICE] Verification failed > /directory1/directory2/file1.txt [NOTICE] /directory1/directory2/file1.txt dstMeta: type=R mode=0755 uid=65534 gid=65534 size=8972938 atime=1728657659/0 mtime=1728657659/0 extAttrsHash=0 [NOTICE] dstHash: f9c2cca900301d38b0930367d8d587153154af467da0fdcf1bebc0848ec72c0d ``` ------ # Registrando chamadas de AWS DataSync API com AWS CloudTrail AWS DataSync é integrado com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, uma função ou um AWS service (Serviço da AWS) usuário DataSync. CloudTrail captura todas as chamadas de API DataSync como eventos. As chamadas capturadas incluem chamadas do DataSync console e chamadas de código para operações de DataSync API. Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para. AWS DataSync Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no **Histórico de eventos**. Usando as informações coletadas por CloudTrail, você pode determinar a solicitação que foi feita AWS DataSync, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais. Para saber mais sobre isso CloudTrail, consulte o [Guia AWS CloudTrail do usuário](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Trabalhando com DataSync informações em CloudTrail CloudTrail é ativado no seu Conta da AWS quando você cria a conta. Quando a atividade ocorre em AWS DataSync, essa atividade é registrada em um CloudTrail evento junto com outros AWS service (Serviço da AWS) eventos no **histórico de eventos**. Você pode visualizar, pesquisar e baixar eventos recentes no seu Conta da AWS. Para obter mais informações, consulte [Visualização de eventos com histórico de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Para obter um registro contínuo de eventos na sua Conta da AWS, incluindo eventos para o AWS DataSync, crie uma trilha. Uma *trilha* permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as Regiões da AWS. A trilha registra eventos de todos Regiões da AWS na mesma AWS partição e entrega os arquivos de log ao bucket do Amazon S3 que você especificar. Além disso, você pode configurar outros Serviços da AWS para analisar e agir com base nos dados do evento coletados nos CloudTrail registros. Para saber mais, consulte: + [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail serviços e integrações suportados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configurando notificações do Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html) + [Recebendo arquivos de CloudTrail log de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [Recebendo arquivos de CloudTrail log de várias contas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Todas as DataSync ações são registradas por CloudTrail. (Para obter mais informações, consulte a [referência DataSync da API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html).) Por exemplo, chamadas para as `ListLocations` operações `CreateAgent``CreateTask`, e geram entradas nos arquivos de CloudTrail log. Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar o seguinte: + Se a solicitação foi feita com credenciais raiz ou AWS Identity and Access Management (IAM). + Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado. + Se a solicitação foi feita por outro AWS service (Serviço da AWS). Para obter mais informações, consulte o [CloudTrailuserIdentityelemento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) no *Guia AWS CloudTrail do usuário.* ## Entendendo as entradas do arquivo de DataSync log Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3 que você especificar. CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros da solicitação e assim por diante. CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das chamadas públicas de API, portanto, eles não aparecem em nenhuma ordem específica. O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a `CreateTask` operação. ``` { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "1234567890abcdef0", "arn": "arn:aws:iam::123456789012:user/user1", "accountId": "123456789012", "accessKeyId": "access key", "userName": "user1", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-12-13T14:56:46Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2018-12-13T14:57:02Z", "eventSource": "datasync.amazonaws.com", "eventName": "CreateTask", "awsRegion": "ap-southeast-1", "sourceIPAddress": "192.0.2.1", "userAgent": "signin.amazonaws.com", "requestParameters": { "cloudWatchLogGroupArn": "arn:aws:logs:ap-southeast-1:123456789012:log-group:MyLogGroup", "name": "MyTask-NTIzMzY1", "tags": [], "destinationLocationArn": "arn:aws:datasync:ap-southeast-1:123456789012:location/loc-abcdef01234567890", "options": { "bytesPerSecond": -1, "verifyMode": "POINT_IN_TIME_CONSISTENT", "uid": "INT_VALUE", "posixPermissions": "PRESERVE", "mtime": "PRESERVE", "gid": "INT_VALUE", "preserveDevices": "NONE", "preserveDeletedFiles": "REMOVE", "atime": "BEST_EFFORT" }, "sourceLocationArn": "arn:aws:datasync:ap-southeast-1:123456789012:location/loc-021345abcdef6789" }, "responseElements": { "taskArn": "arn:aws:datasync:ap-southeast-1:123456789012:task/task-1234567890abcdef0" }, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "eventType": "AwsApiCall", "recipientAccountId": "123456789012" } ``` # Monitorando eventos usando a Amazon EventBridge EventBridge Os eventos da Amazon descrevem mudanças nos DataSync recursos. Você pode configurar regras para corresponder a eventos e roteá-los para um ou mais streams ou funções de destino. Os eventos são emitidos com base no melhor esforço. ## DataSync eventos de transferência Os seguintes EventBridge eventos estão disponíveis para DataSync transferências. | **Agent state changes** | | --- | | Evento | Descrição | | On-line | O agente está configurado corretamente e disponível para uso. Esse é o status normal de execução de um agente. | | Off-line | O agente esteve fora de contato com o DataSync serviço por cinco minutos ou mais. Isso pode acontecer por alguns motivos. Para obter mais informações, consulte [O que eu faço se meu agente estiver off-line?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline). | | **Location state changes** | | --- | | Evento | Descrição | | Adicionando | DataSync está adicionando um local. | | Available (Disponível) | O local foi criado e está disponível para uso. | | **Task state changes** | | --- | | Evento | Descrição | | Available (Disponível) | A tarefa foi criada e está pronta para ser iniciada. | | Em execução | A tarefa está em andamento e funcionando corretamente. | | Unavailable (Indisponível) | A tarefa não está configurada corretamente e não pode ser usada. Talvez você veja esse evento quando um agente associado à tarefa ficar off-line. | | Enfileirado | Outra tarefa é executar e usar o mesmo agente. DataSync executa tarefas em série (primeiro a entrar, primeiro a sair). | | **Task execution state changes** | | --- | | Evento | Descrição | | Enfileiramento | Outra execução de tarefa é executar e usar o mesmo DataSync agente. Para obter mais informações, consulte [Como saber quando a tarefa está na fila](run-task.md#queue-task-execution). | | Launching | DataSync está inicializando a execução da tarefa. Esse status geralmente desaparece rapidamente, mas pode levar até alguns minutos. | | Preparação | DataSync está determinando quais dados transferir. Essa etapa pode levar apenas alguns minutos ou algumas horas, dependendo do número de arquivos, objetos ou diretórios nos dois locais e de como você configura a tarefa. A preparação também pode não ser aplicável à tarefa. Para obter mais informações, consulte [Como DataSync prepara sua transferência de dados](how-datasync-transfer-works.md#how-datasync-prepares). | | Em transferência | DataSync está realizando a transferência de dados real. | | Verificando | DataSync está realizando uma verificação da integridade dos dados no final da transferência. | | Bem-sucedida | A execução da tarefa foi bem-sucedida. | | Cancelando | A execução da tarefa está em processo de ser cancelada. | | Erro | Houve falha na execução da tarefa. | # Monitoramento AWS DataSync com ferramentas manuais Você pode acompanhar suas AWS DataSync transferências pelo console ou pela linha de comando. ## Monitorando sua transferência usando o DataSync console Você pode monitorar sua DataSync transferência usando o console, que fornece métricas em tempo real, como dados transferidos, taxa de transferência de dados e arquivos e compactação de dados. **Para monitorar sua transferência usando o DataSync console** 1. Depois de [iniciar sua DataSync tarefa](run-task.md#starting-task), escolha **Ver detalhes da execução**. 1. Veja métricas sobre a sua transferência. ## Monitorando sua transferência usando o AWS CLI Você pode monitorar sua DataSync transferência usando o AWS Command Line Interface (AWS CLI). Copie o seguinte comando `describe-task-execution`: Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações. ``` aws datasync describe-task-execution \ --task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task-execution-id' ``` Esse comando retornará informações sobre a execução da tarefa, semelhantes às mostradas a seguir. ``` { "BytesCompressed": 3500, "BytesTransferred": 5000, "BytesWritten": 5000, "EstimatedBytesToTransfer": 5000, "EstimatedFilesToDelete": 10, "EstimatedFilesToTransfer": 100, "FilesDeleted": 10, "FilesSkipped": 0, "FilesTransferred": 100, "FilesVerified": 100, "Result": { "ErrorCode": "??????", "ErrorDetail": "??????", "PrepareDuration": 100, "PrepareStatus": "SUCCESS", "TransferDuration": 60, "TransferStatus": "AVAILABLE", "VerifyDuration": 30, "VerifyStatus": "SUCCESS" }, "StartTime": 1532660733.39, "Status": "SUCCESS", "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": "1000", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role", "S3BucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/*", "Subdirectory": "reports" } }, "ObjectVersionIds": "INCLUDE", "OutputType": "STANDARD", "Overrides": { "Deleted": { "ReportLevel": "ERRORS_ONLY" }, "Skipped": { "ReportLevel": "SUCCESSES_AND_ERRORS" }, "Transferred": { "ReportLevel": "ERRORS_ONLY" }, "Verified": { "ReportLevel": "ERRORS_ONLY" } }, "ReportLevel": "ERRORS_ONLY" } } ``` + Se a execução da tarefa for bem-sucedida, o valor de **Status** será alterado para **SUCCESS (Êxito)**. Para obter informações sobre o significado dos elementos de resposta, consulte [DescribeTaskExecution](API_DescribeTaskExecution.md). + Se ocorrer uma falha na execução da tarefa, o resultado envia os códigos de erros que podem ajudar a solucionar os problemas. Para obter informações sobre os códigos de erro, consulte [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md). ## Monitorando sua transferência usando o utilitário `watch` Para monitorar o andamento da execução da tarefa em tempo real na linha de comando, você pode usar o utilitário `watch` do padrão do Unix. Os valores da duração da execução da tarefa são medidos em milissegundos. O `watch` utilitário não reconhece o DataSync alias. O exemplo a seguir mostra como invocar a CLI diretamente. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações. ``` # pass '-n 1' to update every second and '-d' to highlight differences $ watch -n 1 -d \ "aws datasync describe-task-execution --task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task execution-id'" ```