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á.
# 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/).