Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Monitoraggio dei trasferimenti di dati con report sulle attività
*I report sulle attività* forniscono informazioni dettagliate su quali AWS DataSync tentativi di trasferire, ignorare, verificare ed eliminare durante l'esecuzione di un'attività. Per ulteriori informazioni, consulta [Come DataSync trasferisce file, oggetti e directory](how-datasync-transfer-works.md#transferring-files).
I report sulle attività vengono generati in formato JSON. Puoi personalizzare il livello di dettaglio nei tuoi report:
+ [I report sulle attività di solo riepilogo](#task-report-types-summary) forniscono i dettagli necessari sull'esecuzione delle attività, ad esempio il numero di file trasferiti e l' DataSync eventuale possibilità di verificare l'integrità dei dati di tali file.
+ I [report sulle attività standard](#task-report-types-standard) includono un riepilogo e report dettagliati che elencano ogni file, oggetto o cartella che DataSync tenta di trasferire, ignorare, verificare ed eliminare. Con un rapporto sulle attività standard, puoi anche specificare il [livello del rapporto](#task-report-level) in modo da mostrare solo gli errori di esecuzione dell'attività o i relativi successi ed errori.
## Casi d’uso
Ecco alcune situazioni in cui i report sulle attività possono aiutarti a monitorare e controllare i trasferimenti di dati:
+ Quando esegui la migrazione di milioni di file, identifica rapidamente i file che DataSync presentano problemi di trasferimento.
+ Verifica chain-of-custody i processi per i tuoi file.
## Riepilogano solo i rapporti sulle attività
Un rapporto che è solo un riepilogo dell'esecuzione di un'attività include i seguenti dettagli:
+ Il Account AWS che ha eseguito l'esecuzione dell'attività
+ Le posizioni di origine e destinazione
+ Il numero totale di file, oggetti e cartelle che sono stati ignorati, trasferiti, verificati ed eliminati
+ Il totale dei byte (logici e fisici) trasferiti
+ Se l'esecuzione dell'attività è stata completata, annullata o si è verificato un errore
+ L'ora di inizio e di fine (incluso il tempo totale del trasferimento)
+ Le impostazioni dell'attività (come i limiti della larghezza di banda, la verifica dell'integrità dei dati e altre opzioni per il DataSync trasferimento)
## Rapporti sulle attività standard
Un rapporto sulle attività standard include un [riepilogo](#task-report-types-summary) dell'esecuzione delle attività e rapporti dettagliati su ciò che DataSync tenta di trasferire, ignorare, verificare ed eliminare.
**Topics**
+ [Livello di rapporto](#task-report-level)
+ [Rapporti trasferiti](#task-report-types-transferred)
+ [Rapporti ignorati](#task-report-types-skipped)
+ [Rapporti verificati](#task-report-types-verified)
+ [Rapporti eliminati](#task-report-types-deleted)
### Livello di rapporto
Con i report sulle attività standard, puoi scegliere uno dei seguenti livelli di rapporto:
+ Solo errori
+ Successi ed errori (essenzialmente un elenco di tutto ciò che è accaduto durante l'esecuzione dell'attività)
Ad esempio, potresti voler vedere quali file sono DataSync stati ignorati correttamente durante il trasferimento e quali no. I file DataSync ignorati con successo potrebbero essere quelli che desideri DataSync escludere di proposito perché esistono già nella posizione di destinazione. Tuttavia, un errore ignorato, ad esempio, potrebbe indicare che DataSync non dispone delle autorizzazioni necessarie per leggere un file.
### Rapporti trasferiti
Un elenco di file, oggetti e directory che DataSync hanno tentato di trasferire durante l'esecuzione dell'attività. Un rapporto trasferito include i seguenti dettagli:
+ I percorsi per i dati trasferiti
+ Cosa è stato trasferito (contenuto, metadati o entrambi)
+ I metadati, che includono il tipo di dati, la dimensione del contenuto (solo oggetti e file) e altro
+ L'ora in cui un elemento è stato trasferito
+ La versione dell'oggetto (se la destinazione è un bucket Amazon S3 con il controllo delle versioni abilitato)
+ Se qualcosa è stato sovrascritto nella destinazione
+ Se un articolo è stato trasferito correttamente
**Nota**
Quando sposti dati tra i bucket S3, il prefisso specificato nella [posizione di origine](create-s3-location.md) può essere visualizzato nel report (o nei CloudWatch log di Amazon), anche se tale prefisso non esiste come oggetto nella posizione di destinazione. (Nella DataSync console, potresti anche notare che questo prefisso viene visualizzato come dati ignorati o verificati.)
### Rapporti ignorati
Un elenco di file, oggetti e directory che DataSync si trova nella posizione di origine ma che non è stato tentato di trasferire. I motivi per cui i DataSync dati vengono ignorati possono dipendere da diversi fattori, come la configurazione delle attività e le autorizzazioni del sistema di storage. Ecco alcuni esempi:
+ Esiste un file nelle posizioni di origine e di destinazione. Il file nell'origine non è stato modificato dall'esecuzione dell'attività precedente. Poiché stai [trasferendo solo dati che sono stati modificati](configure-metadata.md#task-option-transfer-mode), DataSync non trasferisce quel file la prossima volta che esegui l'operazione.
+ Un oggetto che esiste in entrambe le posizioni cambia nella fonte. Quando esegui l'attività, DataSync salta questo oggetto nella destinazione perché l'attività non [sovrascrive i dati nella](configure-metadata.md#task-option-file-object-handling) destinazione.
+ DataSync ignora un oggetto nell'origine che utilizza una [classe di archiviazione](create-s3-location.md#using-storage-classes) e non viene ripristinato. È necessario ripristinare un oggetto archiviato per poterlo DataSync leggere.
+ DataSync salta un file, un oggetto o una directory nella posizione di origine perché non può leggerlo. Se ciò accade e non è previsto, controlla le autorizzazioni di accesso dello spazio di archiviazione e assicurati che sia DataSync possibile leggere ciò che è stato ignorato.
Un rapporto ignorato include i seguenti dettagli:
+ I percorsi per i dati ignorati
+ L'ora in cui un elemento è stato ignorato
+ Il motivo per cui è stato ignorato
+ Se un elemento è stato ignorato con successo
**Nota**
I report ignorati possono essere di grandi dimensioni quando includono successi ed errori, se si configura l'attività in [modo da trasferire solo i dati modificati](configure-metadata.md) e i dati di origine esistono già nella destinazione.
### Rapporti verificati
Un elenco di file, oggetti e directory di cui si è DataSync tentato di verificare l'integrità durante l'esecuzione dell'attività. Un rapporto sui dati verificati include i seguenti dettagli:
+ I percorsi per i dati verificati
+ L'ora in cui un articolo è stato verificato
+ Il motivo dell'errore di verifica (se presente)
+ I SHA256 checksum di origine e destinazione (solo file)
+ Se un articolo è stato verificato con successo
Tieni presente quanto segue sui report verificati:
+ Quando configuri l'attività in modo da [verificare solo i dati trasferiti](configure-data-verification-options.md), in alcune situazioni DataSync non verifica le directory o i file o gli oggetti che non vengono trasferiti. In entrambi i casi, DataSync non include dati non verificati in questo rapporto.
+ Se utilizzi la [modalità Avanzata](choosing-task-mode.md), la verifica potrebbe richiedere più tempo del solito se trasferisci oggetti di grandi dimensioni.
### Rapporti eliminati
Un elenco di file, directory e oggetti che sono stati eliminati durante l'esecuzione dell'attività. DataSync genera questo rapporto solo se si [configura l'attività](configure-metadata.md) in modo da eliminare i dati nella posizione di destinazione che non si trova nell'origine. Un rapporto sui dati eliminati include i seguenti dettagli:
+ I percorsi per i dati eliminati
+ Se un elemento è stato eliminato con successo
+ L'ora in cui un elemento è stato eliminato
## Esempi di report sulle attività
Il livello di dettaglio del rapporto sulle attività dipende da te. Ecco alcuni esempi di report di dati trasferiti con la seguente configurazione:
+ **Tipo di rapporto**: standard
+ **Livello di rapporto**: successi ed errori
**Nota**
I report utilizzano lo standard ISO-8601 per il formato del timestamp. I tempi sono espressi in UTC e misurati in nanosecondi. Questo comportamento è diverso dal modo in cui vengono misurate altre metriche dei report sulle attività. Ad esempio, [i dettagli sull'esecuzione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskExecutionResultDetail.html), come `TransferDuration` e`VerifyDuration`, vengono misurati in millisecondi.
I report sulle attività in modalità avanzata utilizzano uno schema leggermente diverso rispetto ai report sulle attività in modalità base. Gli esempi seguenti possono aiutarti a sapere cosa aspettarti dai tuoi report a seconda della [modalità di attività](choosing-task-mode.md) utilizzata.
**Esempi di report sui dati trasferiti con stato di successo**
I seguenti report mostrano i trasferimenti riusciti per un oggetto denominato`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"
}]
}
```
**Esempi di report sui dati trasferiti con stato di errore**
I seguenti report forniscono esempi di quando non è DataSync possibile trasferire un oggetto denominato`object1.txt`.
Questo rapporto mostra che non è DataSync possibile accedere a un oggetto denominato a `object1.txt` causa di un problema di AWS KMS autorizzazioni. (Se ricevi un errore come questo, consulta[Accesso ai bucket S3 utilizzando la crittografia lato server](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"
}]
}
```
Questo rapporto mostra che un oggetto denominato `object1.txt` non è stato trasferito a causa di un problema di autorizzazioni del bucket S3. (Se ricevi un errore come questo, vedi.) [Fornire DataSync l'accesso ai bucket 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
}]
}
```
## Limitazioni
+ I report sulle attività individuali non possono superare i 5 MB. Se stai copiando un numero elevato di file, il rapporto sulle attività potrebbe essere suddiviso in più report.
+ Esistono situazioni in cui la creazione di report sulle attività può influire sulle prestazioni del trasferimento dei dati. Ad esempio, potresti notarlo quando la tua connessione di rete ha un'elevata latenza e i file che stai trasferendo sono piccoli o stai copiando solo le modifiche dei metadati.
# Creazione dei report sulle attività DataSync
AWS DataSync i report sulle attività possono essere solo un riepilogo dell'esecuzione dell'attività o una serie di report dettagliati su quali DataSync tentativi di trasferire, ignorare, verificare ed eliminare.
## Prerequisiti
Prima di poter creare un rapporto sulle attività, è necessario effettuare le seguenti operazioni.
**Topics**
+ [Crea un bucket S3 per i tuoi report sulle attività](#setting-up-task-report-create-bucket)
+ [Consenti DataSync di caricare report sulle attività nel tuo bucket S3](#task-report-access)
### Crea un bucket S3 per i tuoi report sulle attività
Se non ne hai già uno, [crea un bucket S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) in cui caricare il tuo rapporto sulle DataSync attività. I report vengono archiviati nella classe di storage S3 Standard.
Per questo bucket consigliamo quanto segue:
+ Se hai intenzione di trasferire dati in un bucket S3, non utilizzare lo stesso bucket per il report delle attività se [disabiliti l'opzione **Mantieni** i file eliminati](configure-metadata.md). Altrimenti, DataSync eliminerà tutti i report sulle attività precedenti ogni volta che esegui un'attività, poiché tali report non esistono nella posizione di origine.
+ Per evitare una configurazione complessa delle autorizzazioni di accesso, assicurati che il bucket dei report sulle attività si trovi nella stessa Account AWS area geografica dell'attività di DataSync trasferimento.
### Consenti DataSync di caricare report sulle attività nel tuo bucket S3
Devi configurare un ruolo AWS Identity and Access Management (IAM) che DataSync consenta di caricare un report sulle attività nel tuo bucket S3.
Nella DataSync console, puoi creare un ruolo IAM che nella maggior parte dei casi include automaticamente le autorizzazioni per caricare un report di attività nel tuo bucket. Tieni presente che questo ruolo generato automaticamente potrebbe non soddisfare le tue esigenze dal punto di vista del privilegio minimo. Inoltre, questo ruolo non funzionerà se il bucket è crittografato con una chiave gestita dal cliente AWS Key Management Service () (AWS KMS SSE-KMS). In questi casi, puoi creare il ruolo manualmente purché il ruolo esegua almeno le seguenti operazioni:
+ [Evita il problema del vicedirettore confuso tra servizi](https://docs.aws.amazon.com/datasync/latest/userguide/cross-service-confused-deputy-prevention.html) nell'entità fidata del ruolo.
L'esempio completo seguente mostra come utilizzare le chiavi di contesto `aws:SourceArn` e `aws:SourceAccount` global condition per evitare il problema del confuso vice con 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:*"
}
}
}
]
}
```
------
+ Consente di DataSync caricare un report sulle attività nel bucket S3.
L'esempio seguente esegue questa operazione includendo l'`s3:PutObject`azione solo per un prefisso specifico (`reports/`) nel bucket.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Action": [
"s3:PutObject"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*"
}]
}
```
------
+ Se il bucket S3 è crittografato con una chiave SSE-KMS gestita dal cliente, la [policy](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) della chiave deve includere il ruolo IAM utilizzato per accedere al bucket. DataSync
Per ulteriori informazioni, consulta [Accesso ai bucket S3 utilizzando la crittografia lato server](create-s3-location.md#create-s3-location-encryption).
## Creazione di un rapporto di attività di solo riepilogo
È possibile configurare un rapporto sulle attività che includa un [riepilogo solo](task-reports.md#task-report-types-summary) al DataSync momento della creazione, dell'avvio dell'attività o dell'aggiornamento dell'attività.
I passaggi seguenti mostrano come configurare un rapporto di attività di solo riepilogo durante la creazione di un'attività.
### Utilizzo della DataSync console
1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.
1. Configura le posizioni di origine e di destinazione dell'attività.
Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)
1. Scorri verso il basso fino alla sezione **Rapporto sulle attività**. Per **Tipo di rapporto**, scegli **Solo riepilogo**.
1. Per il **bucket S3 per i report**, scegli un bucket S3 in cui DataSync caricare il rapporto sulle attività.
**Suggerimento**
[**Se hai intenzione di trasferire dati in un bucket S3, non utilizzare lo stesso bucket per il report delle attività se disabiliti l'opzione Mantieni i file eliminati.**](configure-metadata.md) Altrimenti, DataSync eliminerà tutti i report sulle attività precedenti ogni volta che esegui un'attività, poiché tali report non esistono nella posizione di origine.
1. Per **Cartella**, inserisci un prefisso da utilizzare per il rapporto sulle attività quando DataSync carichi il rapporto nel tuo bucket S3 (ad esempio,). **reports/**
Assicurati di includere il carattere delimitatore appropriato alla fine del prefisso. Questo carattere è in genere una barra (). `/` Per ulteriori informazioni, consulta [Organizzare gli oggetti utilizzando i prefissi nella Guida](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) per l'utente di *Amazon S3*.
1. In **IAM role (Ruolo IAM)**, eseguire una delle seguenti operazioni:
+ Scegli **Autogenerate** per creare DataSync automaticamente un ruolo IAM con le autorizzazioni necessarie per accedere al bucket S3.
Se DataSync in precedenza hai creato un ruolo IAM per questo bucket S3, quel ruolo viene scelto per impostazione predefinita.
+ Scegli un ruolo IAM personalizzato che hai creato.
In alcuni casi, potresti dover creare il ruolo da solo. Per ulteriori informazioni, consulta [Consenti DataSync di caricare report sulle attività nel tuo bucket S3](#task-report-access).
**Importante**
Se il bucket S3 è crittografato con una chiave SSE-KMS gestita dal cliente, la policy della chiave deve includere il ruolo IAM DataSync utilizzato per accedere al bucket.
Per ulteriori informazioni, consulta [Accesso ai bucket S3 utilizzando la crittografia lato server](create-s3-location.md#create-s3-location-encryption).
1. Completa la creazione dell'attività, quindi [avvia l'attività per iniziare a trasferire i dati](run-task.md).
Una volta completato il trasferimento, puoi [visualizzare il rapporto sull'attività](task-report-viewing.md).
### Utilizzando il AWS CLI
1. Copiate il seguente 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. Per il `--source-location-arn` parametro, specifica l'Amazon Resource Name (ARN) della posizione di origine nel trasferimento. Sostituisci `us-east-1` con l'appropriato Regione AWS, sostituisci `123456789012` con il Account AWS numero appropriato e sostituisci `12345678abcdefgh` con l'ID della posizione di origine appropriato.
1. Per il `--destination-location-arn` parametro, specifica l'ARN della località di destinazione nel trasferimento. Sostituisci `us-east-1` con l'appropriato Regione AWS, sostituisci `123456789012` con il Account AWS numero appropriato e sostituisci `abcdefgh12345678` con l'ID della località di destinazione appropriato.
1. Per il `--task-report-config` parametro, effettuate le seguenti operazioni:
+ `Subdirectory`— Sostituisci `reports/` con il prefisso nel tuo bucket S3 il punto in cui desideri DataSync caricare i report delle attività.
Assicurati di includere il carattere delimitatore appropriato alla fine del prefisso. Questo carattere è in genere una barra (). `/` Per ulteriori informazioni, consulta [Organizzare gli oggetti utilizzando i prefissi nella Guida](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) per l'utente di *Amazon S3*.
+ `S3BucketArn`— Specificare l'ARN del bucket S3 in cui si desidera caricare il report delle attività.
**Suggerimento**
**Se hai intenzione di trasferire dati in un bucket S3, non utilizzare lo stesso bucket per il report delle attività se [disabiliti](configure-metadata.md) l'opzione Mantieni i file eliminati.** Altrimenti, DataSync eliminerà tutti i report sulle attività precedenti ogni volta che esegui un'attività, poiché tali report non esistono nella posizione di origine.
+ `BucketAccessRoleArn`— Specificate il ruolo IAM che DataSync consente di caricare un report di attività nel bucket S3.
Per ulteriori informazioni, consulta [Consenti DataSync di caricare report sulle attività nel tuo bucket S3](#task-report-access).
**Importante**
Se il bucket S3 è crittografato con una chiave SSE-KMS gestita dal cliente, la policy della chiave deve includere il ruolo IAM utilizzato per accedere al bucket. DataSync
Per ulteriori informazioni, consulta [Accesso ai bucket S3 utilizzando la crittografia lato server](create-s3-location.md#create-s3-location-encryption).
+ `OutputType``SUMMARY_ONLY`— Specificare.
Per ulteriori informazioni, consulta [Riepilogano solo i rapporti sulle attività](task-reports.md#task-report-types-summary).
1. Esegui il `create-task` comando per creare l'attività.
Riceverai una risposta come la seguente che ti mostra l'ARN dell'attività che hai creato. Avrai bisogno di questo ARN per eseguire il `start-task-execution` comando.
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}
```
1. Copia il seguente `start-task-execution` comando.
```
aws datasync-task-report start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. Per il `--task-arn` parametro, specifica l'ARN dell'attività che stai avviando. Usa l'ARN che hai ricevuto dall'esecuzione del `create-task` comando.
1. Esegui il comando `start-task-execution`.
Una volta completato il trasferimento, puoi [visualizzare il rapporto sulle attività](task-report-viewing.md).
## Creazione di un rapporto sulle attività standard
È possibile configurare un [rapporto di attività standard](task-reports.md#task-report-types-standard) quando si crea DataSync un'attività, si avvia un'attività o si aggiorna l'attività.
I passaggi seguenti mostrano come configurare un report di attività standard durante la creazione di un'attività.
### Utilizzo della DataSync console
1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.
1. Configura le posizioni di origine e di destinazione dell'attività.
Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)
1. Scorri verso il basso fino alla sezione **Rapporto sulle attività**. Per **Tipo di rapporto**, scegli **Rapporto standard**.
1. Per **Livello di rapporto**, scegli una delle seguenti opzioni:
+ **Solo errori**: il rapporto sulle attività include solo i problemi relativi a ciò che DataSync hai cercato di trasferire, ignorare, verificare ed eliminare.
+ **Successi ed errori**: il rapporto sulle attività include gli elementi trasferiti, saltati, verificati ed eliminati DataSync con successo e quelli che non sono stati trasferiti.
+ **Personalizzato**: consente di scegliere se visualizzare solo gli errori o i successi e gli errori per aspetti specifici del rapporto sulle attività.
Ad esempio, puoi scegliere **Successi ed errori** per l'elenco dei file trasferiti, ma **Errori solo** per il resto del rapporto.
1. Se stai effettuando il trasferimento in un bucket S3 che utilizza il controllo delle versioni degli oggetti, mantieni selezionata l'opzione Includi **le versioni degli oggetti di Amazon S3 se desideri che il report includa la nuova versione per ogni oggetto** trasferito.
1. Per il **bucket S3 per i report**, scegli un bucket S3 in cui caricare il report delle attività. DataSync
**Suggerimento**
[**Se hai intenzione di trasferire dati in un bucket S3, non utilizzare lo stesso bucket per il report delle attività se disabiliti l'opzione Mantieni i file eliminati.**](configure-metadata.md) Altrimenti, DataSync eliminerà tutti i report sulle attività precedenti ogni volta che esegui un'attività, poiché tali report non esistono nella posizione di origine.
1. Per **Cartella**, inserisci un prefisso da utilizzare per il rapporto sulle attività quando DataSync carichi il rapporto nel tuo bucket S3 (ad esempio,). **reports/** Assicurati di includere il carattere delimitatore appropriato alla fine del prefisso. Questo carattere è in genere una barra (). `/` Per ulteriori informazioni, consulta [Organizzare gli oggetti utilizzando i prefissi nella Guida](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) per l'utente di *Amazon S3*.
1. In **IAM role (Ruolo IAM)**, eseguire una delle seguenti operazioni:
+ Scegli **Autogenerate** per creare DataSync automaticamente un ruolo IAM con le autorizzazioni necessarie per accedere al bucket S3.
Se DataSync in precedenza hai creato un ruolo IAM per questo bucket S3, quel ruolo viene scelto per impostazione predefinita.
+ Scegli un ruolo IAM personalizzato che hai creato.
In alcuni casi, potresti dover creare il ruolo da solo. Per ulteriori informazioni, consulta [Consenti DataSync di caricare report sulle attività nel tuo bucket S3](#task-report-access).
**Importante**
Se il bucket S3 è crittografato con una chiave SSE-KMS gestita dal cliente, la policy della chiave deve includere il ruolo IAM DataSync utilizzato per accedere al bucket.
Per ulteriori informazioni, consulta [Accesso ai bucket S3 utilizzando la crittografia lato server](create-s3-location.md#create-s3-location-encryption).
1. Completa la creazione dell'attività e [avvia l'attività per iniziare a trasferire i dati.](run-task.md)
Una volta completato il trasferimento, puoi [visualizzare il rapporto sull'attività](task-report-viewing.md).
### Utilizzando il AWS CLI
1. Copia il seguente `create-task` comando:
```
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. Per il `--source-location-arn` parametro, specificate l'ARN della posizione di origine nel trasferimento. Sostituisci `us-east-1` con l'appropriato Regione AWS, sostituisci `123456789012` con il Account AWS numero appropriato e sostituisci `12345678abcdefgh` con l'ID della posizione di origine appropriato.
1. Per il `--destination-location-arn` parametro, specifica l'ARN della località di destinazione nel trasferimento. Sostituisci `us-east-1` con l'appropriato Regione AWS, sostituisci `123456789012` con il Account AWS numero appropriato e sostituisci `abcdefgh12345678` con l'ID della località di destinazione appropriato.
1. Per il `--task-report-config` parametro, effettuate le seguenti operazioni:
+ `Subdirectory`— Sostituisci `reports/` con il prefisso nel tuo bucket S3 il punto in cui desideri DataSync caricare i report delle attività. Assicurati di includere il carattere delimitatore appropriato alla fine del prefisso. Questo carattere è in genere una barra (). `/` Per ulteriori informazioni, consulta [Organizzare gli oggetti utilizzando i prefissi nella Guida](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) per l'utente di *Amazon S3*.
+ `S3BucketArn`— Specificare l'ARN del bucket S3 in cui si desidera caricare il report delle attività.
**Suggerimento**
**Se hai intenzione di trasferire dati in un bucket S3, non utilizzare lo stesso bucket per il report delle attività se [disabiliti](configure-metadata.md) l'opzione Mantieni i file eliminati.** Altrimenti, DataSync eliminerà tutti i report sulle attività precedenti ogni volta che esegui un'attività, poiché tali report non esistono nella posizione di origine.
+ `BucketAccessRoleArn`— Specificate il ruolo IAM che DataSync consente di caricare un report di attività nel bucket S3.
Per ulteriori informazioni, consulta [Consenti DataSync di caricare report sulle attività nel tuo bucket S3](#task-report-access).
**Importante**
Se il bucket S3 è crittografato con una chiave SSE-KMS gestita dal cliente, la policy della chiave deve includere il ruolo IAM utilizzato per accedere al bucket. DataSync
Per ulteriori informazioni, consulta [Accesso ai bucket S3 utilizzando la crittografia lato server](create-s3-location.md#create-s3-location-encryption).
+ `OutputType``STANDARD`— Specificare il rapporto.
Per ulteriori informazioni, vedere [Rapporti sulle attività standard](task-reports.md#task-report-types-standard) Tipi di report sulle attività.
+ (Facoltativo)`ReportLevel`: specifica se desideri `ERRORS_ONLY` (impostazione predefinita) o `SUCCESSES_AND_ERRORS` nel rapporto.
+ (Facoltativo)`ObjectVersionIds`: se stai effettuando il trasferimento in un bucket S3 che utilizza il controllo delle versioni degli oggetti, specifica `NONE` se non desideri includere la nuova versione per ogni oggetto trasferito nel rapporto.
Per impostazione predefinita, il valore dell’opzione è `INCLUDE`.
+ (Facoltativo)`Overrides`: personalizza un aspetto particolare `ReportLevel` del rapporto.
Ad esempio, potresti voler visualizzare `SUCCESSES_AND_ERRORS` l'elenco degli elementi DataSync eliminati nella località di destinazione, ma desideri visualizzare tutto `ERRORS_ONLY` il resto. In questo esempio, aggiungeresti la seguente `Overrides` opzione al `--task-report-config` parametro:
```
"Overrides":{
"Deleted":{
"ReportLevel":"SUCCESSES_AND_ERRORS"
}
}
```
Se non lo usi`Overrides`, l'intero rapporto utilizza quello `ReportLevel` che hai specificato.
1. Esegui il `create-task` comando per creare l'attività.
Riceverai una risposta come la seguente che ti mostra l'ARN dell'attività che hai creato. Avrai bisogno di questo ARN per eseguire il `start-task-execution` comando.
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}
```
1. Copia il seguente `start-task-execution` comando.
```
aws datasync-task-report start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. Per il `--task-arn` parametro, specifica l'ARN dell'attività che stai eseguendo. Usa l'ARN che hai ricevuto dall'esecuzione del `create-task` comando.
1. Esegui il comando `start-task-execution`.
Una volta completato il trasferimento, puoi [visualizzare il rapporto sulle attività](task-report-viewing.md).
# Visualizzazione dei report sulle DataSync attività
DataSync crea report sulle attività per ogni esecuzione di attività. Una volta completata l'esecuzione, puoi trovare i relativi report sulle attività nel tuo bucket S3. I report sulle attività sono organizzati in base a prefissi che includono le attività e le relative IDs esecuzioni.
Per aiutarti a localizzare i report sulle attività nel tuo bucket S3, usa questi esempi:
+ Rapporto sulle **attività, solo riepilogativo**: `reports-prefix/Summary-Reports/task-id-folder/task-execution-id-folder`
+ **Rapporto sulle attività standard** — `reports-prefix/Detailed-Reports/task-id-folder/task-execution-id-folder`
Poiché i report sulle attività sono in formato JSON, sono disponibili diverse opzioni per visualizzarli:
+ Visualizza un report utilizzando [Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/selecting-content-from-objects.html) Select.
+ Visualizza i report utilizzando AWS servizi come AWS Glue Amazon Athena e Amazon Quick. [Per ulteriori informazioni sulla visualizzazione dei report sulle attività, consulta lo Storage Blog.AWS](https://aws.amazon.com/blogs/storage/derive-insights-from-aws-datasync-task-reports-using-aws-glue-amazon-athena-and-amazon-quicksight/)