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 AWS DataSync trasferimenti Il monitoraggio è importante per mantenere l'affidabilità e le prestazioni delle attività di AWS DataSync trasferimento. Ti consigliamo di raccogliere i dati di monitoraggio in modo da poter eseguire più facilmente il debug degli eventuali errori. Prima di iniziare il monitoraggio DataSync, tuttavia, crea un piano di monitoraggio che includa le risposte alle seguenti domande: + Quali sono gli obiettivi del monitoraggio? + Di quali risorse si intende eseguire il monitoraggio? + Con quale frequenza sarà eseguito il monitoraggio di queste risorse? + Quali strumenti di monitoraggio verranno utilizzati? + Chi eseguirà i processi di monitoraggio? + Chi deve ricevere una notifica quando si verifica un problema? AWS fornisce vari servizi e strumenti per il monitoraggio DataSync. Alcuni di questi possono essere configurati in modo che eseguano il monitoraggio al posto tuo, mentre altri richiedono un intervento manuale. Si consiglia di automatizzare il più possibile i processi di monitoraggio. **Topics** + [Comprensione dei contatori delle prestazioni di trasferimento dati](transfer-performance-counters.md) + [Monitoraggio dei trasferimenti di dati con i CloudWatch parametri di Amazon](monitor-datasync.md) + [Monitoraggio dei trasferimenti di dati con report sulle attività](task-reports.md) + [Monitoraggio dei trasferimenti di dati con Amazon CloudWatch Logs](configure-logging.md) + [Registrazione delle chiamate AWS DataSync API con AWS CloudTrail](logging-using-cloudtrail.md) + [Monitoraggio degli eventi tramite Amazon EventBridge](events.md) + [Monitoraggio AWS DataSync con strumenti manuali](monitoring-task-manually.md) # Comprensione dei contatori delle prestazioni di trasferimento dati Quando si [avvia un'attività](run-task.md), AWS DataSync fornisce contatori che aiutano a tenere traccia delle prestazioni e dei progressi del trasferimento dei dati. Utilizzate le seguenti informazioni per capire cosa rappresenta ogni contatore. Puoi visualizzare questi contatori nella DataSync console o in una [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)risposta. Alcuni contatori non sono disponibili in tutte le modalità di [attività](choosing-task-mode.md). | Console | `DescribeTaskExecution` | Supporto per la modalità Task | Description | | --- | --- | --- | --- | | – | `BytesWritten` | Avanzato, di base | Il numero di byte logici che vengono DataSync effettivamente scritti nella posizione di destinazione. | | **Velocità effettiva dei dati** | – | Migliorato, di base | La velocità di DataSync scrittura dei byte logici nella posizione di destinazione. Se si utilizza [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), il modo in cui si calcola questo contatore dipende dalla modalità di operazione in uso: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) | | Dati trasferiti | `BytesTransferred` | Avanzato, di base | Il numero di byte DataSync inviati alla rete prima della compressione (se la compressione è possibile). Per il numero di byte trasferiti sulla rete, consultate il contatore della velocità di **trasmissione di rete** (nella console) o `BytesCompressed` (in [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)). | | **Eliminato dalla destinazione** | `FilesDeleted` | Di base | Il numero di file, oggetti e directory DataSync effettivamente eliminati nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine](configure-metadata.md#task-option-file-object-handling): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) | | **Eliminato dalla destinazione** | `FilesDeleted`, `FoldersDeleted` | Migliorato | Il numero di file o oggetti e directory DataSync effettivamente eliminati nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine](configure-metadata.md#task-option-file-object-handling): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) | | – | `EstimatedBytesToTransfer` | Avanzato, di base | Il numero di byte logici che DataSync prevede di scrivere nella posizione di destinazione. | | – | `EstimatedFilesToDelete` | Di base | Il numero di file, oggetti e directory che DataSync prevede di eliminare nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine, il](configure-metadata.md#task-option-file-object-handling) valore è sempre. `0` | | – | `EstimatedFilesToDelete`, `EstimatedFoldersToDelete` | Migliorato | Il numero di file o oggetti e directory che DataSync prevede di eliminare nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine, il](configure-metadata.md#task-option-file-object-handling) valore è sempre. `0` | | – | `EstimatedFilesToTransfer` | Di base | Il numero di file, oggetti e directory che DataSync prevede di trasferire sulla rete. Questo valore viene calcolato durante la DataSync [preparazione del trasferimento.](run-task.md#understand-task-execution-statuses) Il modo in cui viene calcolato dipende principalmente dalla [modalità di trasferimento](configure-metadata.md#task-option-transfer-mode) utilizzata: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) | | – | `EstimatedFilesToTransfer`, `EstimatedFoldersToTransfer` | Migliorato | Il numero di file o oggetti e directory che DataSync si prevede di trasferire sulla rete. Questo valore viene calcolato durante la DataSync [preparazione del trasferimento.](run-task.md#understand-task-execution-statuses) Il modo in cui viene calcolato dipende principalmente dalla [modalità di trasferimento](configure-metadata.md#task-option-transfer-mode) utilizzata: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) | | **Velocità effettiva dei file** | – | Avanzato, di base | La velocità di DataSync trasferimento di file, oggetti e directory sulla rete. Se si utilizza [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), il modo in cui si calcola questo contatore dipende dalla modalità di operazione in uso: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) | | – | `FilesFailed`, `FoldersFailed` | Migliorata | Il numero di file o oggetti e directory che DataSync non vengono preparati, trasferiti, verificati ed eliminati durante l'esecuzione dell'attività. In caso di errori, è possibile visualizzarli accanto ai contatori della console **Preparato**, **Trasferito**, **Ignorato** ed **Eliminato dalla console di destinazione**, rispettivamente. | | **Elencato alla fonte** | `FilesListed.AtSource`, `FoldersListed.AtSource` | Migliorato | Il numero di file o oggetti e directory che DataSync si trovano nella posizione di origine. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) | | – | `FilesListed.AtDestinationForDelete`, `FoldersListed.AtDestinationForDelete` | Migliorato | Il numero di file o oggetti e directory che DataSync si trovano nella posizione di destinazione. Questo contatore è applicabile solo se si configura l'attività in modo da [eliminare i dati nella destinazione che non si trovano nell'origine](configure-metadata.md#task-option-file-object-handling). | | **Throughput di rete\$1** | `BytesCompressed` | Avanzato, di base | Il numero di byte fisici DataSync trasferiti sulla rete dopo la compressione (se la compressione è possibile). Questo numero è in genere inferiore ai **dati trasferiti** (nella console) o `BytesTransferred` (in [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)), a meno che i dati non siano comprimibili. \$1 In modalità avanzata, la **velocità effettiva di rete** non viene visualizzata nella console. | | **Percentuale di compressione** | – | Migliorato, di base | La percentuale di dati trasferiti DataSync compressi prima dell'invio in rete. Se stai usando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), puoi calcolare questo contatore con`1 - BytesCompressed / BytesWritten`. | | **Preparato** | `FilesPrepared`, `FoldersPrepared` | Migliorato | Il numero di file o oggetti e directory che DataSync tenteranno di trasferire dopo aver confrontato le posizioni di origine e di destinazione. Nella console, questo contatore può anche mostrare il numero di oggetti che vengono DataSync ignorati durante la preparazione. Per ulteriori informazioni, consulta [Come si DataSync prepara il trasferimento dei dati](how-datasync-transfer-works.md#how-datasync-prepares). Questo contatore non è applicabile se configuri l'attività per [trasferire tutti i dati](configure-metadata.md#task-option-transfer-mode). In questo scenario, DataSync copia tutto dall'origine alla destinazione senza confrontare le differenze tra le posizioni. | | **Velocità di elaborazione** | – | Migliorato, di base | La velocità di DataSync lettura di file, oggetti e directory nella posizione di origine. [La velocità di elaborazione si basa su diverse CloudWatch metriche.](monitor-datasync.md#accessing-metrics) Le metriche esatte dipendono dalla modalità di attività utilizzata. **Modalità avanzata:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) **Modalità base:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/transfer-performance-counters.html) | | **Rimanente** | – | Di base | Il numero rimanente di file, oggetti e directory che DataSync prevede di trasferire sulla rete. Se stai usando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), puoi calcolare questo contatore `FilesTransferred` sottraendo da. `EstimatedFilesToTransfer` | | **Ignorato \$1** | `FilesSkipped` | Di base | Il numero di file, oggetti e directory che vengono DataSync ignorati durante il trasferimento. | | – | `FilesSkipped`, `FoldersSkipped` | Migliorato | Il numero di file o oggetti e directory che vengono DataSync ignorati durante il trasferimento. [Gli elementi **ignorati** vengono inclusi nel contatore **Preparato** quando si [trasferiscono solo i dati modificati o nel contatore Trasferito quando si **trasferiscono**](configure-metadata.md#task-option-transfer-mode) tutti i dati.](configure-metadata.md#task-option-transfer-mode) | | **Trasferiti** | `FilesTransferred` | Di base | Il numero di file, oggetti e directory che vengono DataSync trasferiti sulla rete. Questo valore viene aggiornato periodicamente durante l'esecuzione dell'attività quando qualcosa viene letto dall'origine e inviato in rete. Se il trasferimento DataSync non riesce, questo valore può essere inferiore a `EstimatedFilesToTransfer` o`EstimatedFoldersToTransfer`. In alcuni casi, questo valore può anche essere maggiore di `EstimatedFilesToTransfer` o`EstimatedFoldersToTransfer`. Questo contatore è specifico dell'implementazione per alcuni tipi di località, quindi non utilizzarlo come indicazione esatta di ciò che viene trasferito o per monitorare l'esecuzione delle attività. | | **Trasferito** | `FilesTransferred`, `FoldersTransferred` | Migliorato | Il numero di file o oggetti e directory che vengono DataSync trasferiti sulla rete. Questo valore viene aggiornato periodicamente durante l'esecuzione dell'attività quando qualcosa viene letto dall'origine e inviato in rete. Se il trasferimento DataSync non riesce, questo valore può essere inferiore a `EstimatedFilesToTransfer` o`EstimatedFoldersToTransfer`. In alcuni casi, questo valore può anche essere maggiore di `EstimatedFilesToTransfer` o`EstimatedFoldersToTransfer`. Questo contatore è specifico dell'implementazione per alcuni tipi di località, quindi non utilizzarlo come indicazione esatta di ciò che viene trasferito o per monitorare l'esecuzione delle attività. | | **Verificato** | `FilesVerified` | Di base | Il numero di file, oggetti e directory che viene DataSync verificato durante il trasferimento. 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. | | **Verificato** | `FilesVerified`, `FoldersVerified` | Migliorato | Il numero di file o oggetti e directory che viene DataSync verificato durante il trasferimento. | # Monitoraggio dei trasferimenti di dati con i CloudWatch parametri di Amazon Amazon CloudWatch fornisce metriche per monitorare le prestazioni di DataSync trasferimento e risolvere i problemi relativi all'attività di trasferimento. Puoi monitorare le prestazioni AWS DataSync di trasferimento utilizzando i CloudWatch parametri di Amazon. DataSync i parametri vengono inviati automaticamente CloudWatch a intervalli di 5 minuti (indipendentemente da come [configuri](configure-logging.md) la registrazione). Le metriche vengono conservate per un periodo di 15 mesi. Per visualizzare le CloudWatch metriche di DataSync, puoi utilizzare i seguenti strumenti: + La console CloudWatch + La CloudWatch CLI + L' CloudWatch API + La DataSync console (nella pagina dei dettagli dell'esecuzione dell'attività) Per ulteriori informazioni, consulta la [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html). ## CloudWatch metriche per DataSync DataSync le metriche utilizzano lo spazio dei `aws/datasync` nomi e forniscono metriche per le seguenti dimensioni: + **AgentId**— L'ID univoco dell'agente (se l'attività utilizza un agente). + **TaskId**— L'ID univoco dell'attività. Presenta il formato `task-01234567890abcdef`. Lo spazio dei nomi `aws/datasync` include i parametri descritti di seguito. Alcune metriche non sono disponibili in tutte le [modalità di attività.](choosing-task-mode.md) | CloudWatch parametro | Supporto per la modalità Task | Descrizione | | --- | --- | --- | | `BytesCompressed` | Base | Il numero di byte fisici DataSync trasferiti sulla rete dopo la compressione (se la compressione è possibile). Questo numero è in genere inferiore `BytesTransferred` a quello a meno che i dati non siano comprimibili. Unità: byte | | `BytesPreparedDestination` | Base | Il numero di byte logici DataSync preparati nella posizione di destinazione. Unità: byte | | `BytesPreparedSource` | Base | Il numero di byte logici che vengono DataSync preparati nella posizione di origine. Unità: byte | | `BytesTransferred` | Base | Il numero di byte DataSync inviati alla rete prima della compressione (se la compressione è possibile). Per il numero di byte trasferiti sulla rete, consulta la `BytesCompressed` metrica. Unità: byte | | `BytesVerifiedDestination` | Base | Il numero di byte logici che viene DataSync verificato nella posizione di destinazione. Unità: byte | | `BytesVerifiedSource` | Base | Il numero di byte logici che viene DataSync verificato nella posizione di origine. Unità: byte | | `BytesWritten` | Avanzato, di base | Il numero di byte logici che vengono DataSync scritti nella posizione di destinazione. Unità: byte | | `FilesDeleted` | Avanzato, di base | Il numero di file, oggetti e directory che vengono DataSync eliminati nella posizione di destinazione. Se non configuri l'attività per [eliminare i dati nella destinazione che non si trovano nell'origine, il](configure-metadata.md#task-option-file-object-handling) valore è sempre. `0` Unità: numero | | `FilesListedSource` | Migliorato | Il numero di oggetti DataSync trovati nella posizione di origine. Unità: numero | | `FilesPrepared` | Migliorato | Il numero di oggetti che DataSync tenteranno di trasferire dopo aver confrontato le posizioni di origine e di destinazione. Per ulteriori informazioni, consulta [Come si DataSync prepara il trasferimento dei dati](how-datasync-transfer-works.md#how-datasync-prepares). Questa metrica non è applicabile se configuri l'attività per [trasferire tutti i dati](configure-metadata.md#task-option-transfer-mode). In questo scenario, DataSync copia tutto dall'origine alla destinazione senza confrontare le differenze tra le posizioni. Unità: numero | | `FilesPreparedDestination` | Base | Il numero di file, oggetti e directory che vengono DataSync preparati nella posizione di destinazione. Unità: numero | | `FilesPreparedSource` | Base | Il numero di file, oggetti e directory che vengono DataSync preparati nella posizione di origine. Unità: numero | | `FilesSkipped` | Base | Il numero di file, oggetti e directory che vengono DataSync ignorati durante il trasferimento. Unità: numero | | `FilesTransferred` | Avanzato, di base | Il numero di file, oggetti e directory che vengono DataSync trasferiti sulla rete. Questo valore viene aggiornato periodicamente durante l'[esecuzione dell'attività](run-task.md#understand-task-execution-statuses) quando qualcosa viene letto dall'origine e inviato in rete. Questo valore può essere inferiore `EstimatedFilesToTransfer` a quello di una [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)risposta se DataSync non riesce a trasferire qualcosa. In alcuni casi, questo valore può anche essere maggiore di`EstimatedFilesToTransfer`. Questa metrica è specifica dell'implementazione per alcuni tipi di località, quindi non utilizzatela come indicazione esatta di ciò che è stato trasferito o per monitorare l'esecuzione delle attività. Unità: numero | | `FilesVerified` | Migliorata | Il numero di oggetti che viene DataSync verificato durante il trasferimento. Unità: numero | | `FilesVerifiedDestination` | Base | Il numero di file, oggetti e directory che viene DataSync verificato nella posizione di destinazione. Unità: numero | | `FilesVerifiedSource` | Base | Il numero di file, oggetti e directory che viene DataSync verificato nella posizione di origine. Unità: numero | # 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/) # Monitoraggio dei trasferimenti di dati con Amazon CloudWatch Logs È possibile monitorare il AWS DataSync trasferimento utilizzando CloudWatch Logs. Si consiglia di configurare l'attività in modo da registrare almeno le informazioni di base (come gli errori di trasferimento). ## Consentire DataSync il caricamento dei log in un gruppo di CloudWatch log Per [configurare la registrazione](#configure-logging-for-task) per l' DataSyncattività, è necessario un gruppo di CloudWatch log a cui DataSync sia consentito inviare i log. È possibile configurare questo accesso tramite un ruolo AWS Identity and Access Management (IAM). Il modo in cui funziona in modo specifico dipende dalla [modalità di attività](choosing-task-mode.md). ------ #### [ Enhanced mode ] Con la modalità avanzata, invia DataSync automaticamente i registri delle attività a un gruppo di log denominato`/aws/datasync`. Se quel gruppo di log non esiste nel tuo Regione AWS, DataSync crea il gruppo di log per tuo conto utilizzando un [ruolo collegato ai servizi](https://docs.aws.amazon.com/datasync/latest/userguide/using-service-linked-roles-service-action-2.html) IAM quando crei l'attività. ------ #### [ Basic mode ] Esistono due modi per configurare un gruppo di CloudWatch log per un' DataSync attività utilizzando la modalità Basic. Nella console, puoi creare automaticamente un ruolo IAM che nella maggior parte dei casi include le autorizzazioni DataSync necessarie per caricare i log. Tieni presente che questo ruolo generato automaticamente potrebbe non soddisfare le tue esigenze dal punto di vista del privilegio minimo. Se desideri utilizzare un gruppo di CloudWatch log esistente o stai creando le tue attività a livello di codice, devi creare tu stesso il ruolo IAM. L'esempio seguente è una policy IAM che concede queste autorizzazioni. **** ``` { "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:*:*" } ] } ``` La policy utilizza `Condition` istruzioni per garantire che solo DataSync le attività dell'account specificato abbiano accesso al gruppo di CloudWatch log specificato. Si consiglia di utilizzare le chiavi di contesto [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)global condition in queste `Condition` istruzioni per evitare il confuso problema del vice. Per ulteriori informazioni, consulta [Prevenzione del problema "confused deputy" tra servizi](cross-service-confused-deputy-prevention.md). Per specificare l' DataSync attività o le attività, sostituiscile *`region`* con il codice regionale del Regione AWS luogo in cui si trovano le attività (ad esempio,`us-west-2`) e sostituiscilo *`account-id`* con l' Account AWS ID dell'account che contiene le attività. Per specificare il gruppo di CloudWatch log, sostituisci gli stessi valori. È inoltre possibile modificare l'`Resource`istruzione per indirizzarla a gruppi di log specifici. Per ulteriori informazioni sull'utilizzo di `SourceArn` and`SourceAccount`, consulta la sezione [Global condition keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) nella *IAM User Guide*. Per applicare la policy, salvare questa istruzione di policy in un file nel computer locale. Quindi esegui il AWS CLI comando seguente per applicare la politica delle risorse. Per utilizzare questo comando di esempio, sostituiscilo `full-path-to-policy-file` con il percorso del file che contiene la dichiarazione sulla politica. ``` aws logs put-resource-policy --policy-name trust-datasync --policy-document file://full-path-to-policy-file ``` **Nota** Esegui questo comando utilizzando lo stesso comando Account AWS e Regione AWS dove hai attivato il tuo DataSync agente. Per ulteriori informazioni, consulta la [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). ------ ## Configurazione della registrazione per la tua attività DataSync Ti consigliamo di configurare almeno un certo livello di registrazione per la tua attività. DataSync **Prima di iniziare** DataSync necessita dell'autorizzazione per caricare i log in un gruppo di CloudWatch log. Per ulteriori informazioni, consulta [Consentire DataSync il caricamento dei log in un gruppo di CloudWatch log](#cloudwatchlogs). ### Utilizzo della console DataSync Le seguenti istruzioni descrivono come configurare la CloudWatch registrazione durante la creazione di un'attività. È inoltre possibile configurare la registrazione quando si modifica un'attività. 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 destinazione dell'attività. Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md) 1. Nella pagina **Configura impostazioni**, scegli una [modalità di attività](choosing-task-mode.md) e qualsiasi altra opzione. Potrebbero interessarti alcune delle seguenti opzioni: + Specificate quali dati trasferire utilizzando un [manifesto](transferring-with-manifest.md) o [dei filtri](filtering.md). + Configura come [gestire i metadati dei file](configure-metadata.md) e [verificare l'integrità dei dati](configure-data-verification-options.md). 1. Per **Livello di registro**, scegli una delle seguenti opzioni: + **Registra informazioni di base come gli errori di trasferimento**: pubblica i log con solo informazioni di base (come gli errori di trasferimento). + **Registra tutti gli oggetti e i file trasferiti**: pubblica i registri di tutti i file o oggetti che DataSync trasferisce ed esegue controlli di integrità dei dati. + **Non generare registri** 1. Effettua una delle seguenti operazioni a seconda della modalità di attività che stai utilizzando per creare o specificare un gruppo di CloudWatch log: ------ #### [ Enhanced mode ] Quando scegli **Crea attività**, utilizza (o crea) DataSync automaticamente un gruppo di log denominato`/aws/datasync`. ------ #### [ Basic mode ] Per **CloudWatch il gruppo di log**, specifica un gruppo di log su cui DataSync è consentito caricare i log effettuando una delle seguenti operazioni: + Scegliete **Generazione** automatica per creare automaticamente un gruppo di log che DataSync consenta di caricarvi i log. + Scegli un gruppo di log esistente nel tuo attuale. Regione AWS Se scegli un gruppo di log esistente, assicurati che [DataSync sia autorizzato](#cloudwatchlogs) a caricare i log in quel gruppo di log. ------ 1. Scegli **Create task (Crea attività)**. Sei pronto per [iniziare la tua attività.](run-task.md) ### Usando il AWS CLI 1. Copia il seguente `create-task` comando: ``` 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. Per`--source-location-arn`, specifica l'Amazon Resource Name (ARN) della tua posizione di origine. 1. Per`--destination-location-arn`, specifica l'ARN della località di destinazione. Se effettui trasferimenti tra Regioni AWS i nostri account, assicurati che l'ARN includa l'altra regione o l'ID dell'account. 1. Per`--task-mode`, specifica `ENHANCED` o. `BASIC` 1. (Consigliato) Per`--name`, specificate un nome per l'attività che possiate ricordare. 1. Per`LogLevel`, specifica una delle seguenti opzioni: + `BASIC`— Pubblica registri con solo informazioni di base (come errori di trasferimento). + `TRANSFER`— Pubblica i registri per tutti i file o gli oggetti che DataSync trasferiscono ed eseguono controlli di integrità dei dati. + `NONE`— Non generare registri. 1. Per -`-cloudwatch-log-group-arn`, specifica l'ARN di un gruppo di CloudWatch log. **Importante** Se il tuo `--task-mode` è`ENHANCED`, non è necessario specificare questa opzione. Per ulteriori informazioni, consulta [Consentire DataSync il caricamento dei log in un gruppo di CloudWatch log](#cloudwatchlogs). 1. Esegui il comando `create-task`. Se il comando ha esito positivo, si ottiene una risposta che mostra l'ARN dell'attività creata. Esempio: ``` { "TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026" } ``` Sei pronto per [iniziare la tua attività.](run-task.md) ### Utilizzando l' DataSync API È possibile configurare CloudWatch la registrazione per l'attività utilizzando il `CloudWatchLogGroupArn` parametro con una delle seguenti operazioni: + [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) ## Visualizzazione dei registri delle DataSync attività All'[avvio dell'attività](run-task.md), è possibile visualizzare i registri di esecuzione dell'attività utilizzando la CloudWatch console o AWS CLI (tra le altre opzioni). Per ulteriori informazioni, consulta la [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 fornisce log strutturati in JSON per attività in modalità avanzata. Le attività in modalità base hanno registri non strutturati. Gli esempi seguenti mostrano come vengono visualizzati gli errori di verifica nei log in modalità Avanzata rispetto ai log in modalità Basic. ------ #### [ 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 ``` ------ # Registrazione delle chiamate AWS DataSync API con AWS CloudTrail AWS DataSync è integrato con AWS CloudTrail, un servizio che fornisce una registrazione delle azioni intraprese da un utente, un ruolo o un membro Servizio AWS . DataSync CloudTrail acquisisce tutte le chiamate API DataSync come eventi. Le chiamate acquisite includono chiamate dalla DataSync console e chiamate di codice alle operazioni DataSync API. Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per. AWS DataSync Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli **eventi**. Utilizzando le informazioni raccolte da CloudTrail, puoi determinare a quale richiesta è stata inviata AWS DataSync, l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e dettagli aggiuntivi. Per ulteriori informazioni CloudTrail, consulta la [Guida AWS CloudTrail per l'utente](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Utilizzo delle DataSync informazioni in CloudTrail CloudTrail è abilitato sul tuo Account AWS quando crei l'account. Quando si verifica un'attività in AWS DataSync, tale attività viene registrata in un CloudTrail evento insieme ad altri Servizio AWS eventi nella **Cronologia degli eventi**. Puoi visualizzare, cercare e scaricare eventi recenti in Account AWS. Per ulteriori informazioni, consulta [Visualizzazione degli eventi con la cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Per una registrazione continua degli eventi nell' Account AWS che includa gli eventi per AWS DataSync, crea un trail. Un *trail* consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando si crea un percorso nella console, questo sarà valido in tutte le Regioni AWS. Il trail registra gli eventi da tutti Regioni AWS nella stessa AWS partizione e consegna i file di log al bucket Amazon S3 specificato. Inoltre, puoi configurarne altri Servizi AWS per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei log. CloudTrail Per ulteriori informazioni, consulta gli argomenti seguenti: + [Panoramica della creazione di un percorso](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail servizi e integrazioni supportati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configurazione delle notifiche Amazon SNS per CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html) + [Ricezione di file di CloudTrail registro da più regioni](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [ricezione di file di CloudTrail registro da](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) più account Tutte DataSync le azioni vengono registrate da CloudTrail. (Per ulteriori informazioni, consulta il [riferimento all' DataSync API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html).) Ad esempio, le chiamate alle `ListLocations` operazioni `CreateAgent``CreateTask`, e generano voci nei file di CloudTrail registro. Ogni evento o voce di log contiene informazioni sull’utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue: + Se la richiesta è stata effettuata con credenziali root o AWS Identity and Access Management (IAM). + Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo o un utente federato. + Se la richiesta è stata effettuata da un altro Servizio AWS. Per ulteriori informazioni, consulta [CloudTrailuserIdentityl'elemento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) nella *Guida per l'AWS CloudTrail utente*. ## Comprendere DataSync le voci dei file di registro Un trail è una configurazione che consente la distribuzione di eventi come file di log in un bucket Amazon S3 specificato dall'utente. CloudTrail i file di registro contengono una o più voci di registro. Un evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include informazioni sull'azione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. CloudTrail i file di registro non sono una traccia ordinata delle chiamate API pubbliche, quindi non vengono visualizzati in un ordine specifico. L'esempio seguente mostra una voce di CloudTrail registro che dimostra l'`CreateTask`operazione. ``` { "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" } ``` # Monitoraggio degli eventi tramite Amazon EventBridge EventBridge Gli eventi Amazon descrivono i cambiamenti nelle DataSync risorse. Puoi configurare regole corrispondenti a questi eventi e instradarli verso una o più funzioni o flussi target. Gli eventi vengono emessi sulla base del best effort. ## DataSync eventi di trasferimento I seguenti EventBridge eventi sono disponibili per DataSync i trasferimenti. | **Agent state changes** | | --- | | Evento | Descrizione | | Online | L'agente è configurato correttamente e pronto all'uso. Questo è lo stato di funzionamento normale di un agente. | | Offline | L'agente non è in contatto con il DataSync servizio da almeno cinque minuti. Questo può succedere per diversi motivi. Per ulteriori informazioni, consulta [Cosa devo fare se il mio agente è offline?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline) | | **Location state changes** | | --- | | Evento | Descrizione | | Aggiungendo | DataSync sta aggiungendo una posizione. | | Disponibilità | La posizione è stata creata ed è disponibile per l'uso. | | **Task state changes** | | --- | | Evento | Descrizione | | Disponibilità | L'attività è stata creata ed è pronta per essere avviata. | | In esecuzione | L'operazione è in corso e funziona correttamente. | | Non disponibile | L'attività non è configurata correttamente e non può essere utilizzata. Potresti vedere questo evento quando un agente associato all'attività va offline. | | Accodati | Un'altra attività è in esecuzione e utilizza lo stesso agente. DataSync esegue le attività in serie (first in, first out). | | **Task execution state changes** | | --- | | Evento | Descrizione | | In coda | L'esecuzione di un'altra attività è in esecuzione e utilizza lo stesso DataSync agente. Per ulteriori informazioni, consulta [Sapere quando l'attività è in coda](run-task.md#queue-task-execution). | | Avvio | DataSync sta inizializzando l'esecuzione dell'attività. Questo stato in genere passa rapidamente, ma può richiedere fino a qualche minuto. | | Preparing (Preparazione) | DataSync sta determinando quali dati trasferire. Questo passaggio può richiedere alcuni minuti o alcune ore a seconda del numero di file, oggetti o directory in entrambe le posizioni e della configurazione dell'attività. Inoltre, la preparazione potrebbe non essere applicabile all'attività. Per ulteriori informazioni, consulta [Come si DataSync prepara il trasferimento dei dati](how-datasync-transfer-works.md#how-datasync-prepares). | | Trasferimento | DataSync sta effettuando il trasferimento effettivo dei dati. | | Verifica in corso | DataSync sta eseguendo un controllo dell'integrità dei dati al termine del trasferimento. | | Completato | L'esecuzione dell'operazione è riuscita. | | Annullamento in corso | L'esecuzione dell'attività è in fase di annullamento. | | Errore | L'esecuzione dell'operazione non è riuscita. | # Monitoraggio AWS DataSync con strumenti manuali Puoi tenere traccia dei tuoi AWS DataSync trasferimenti dalla console o dalla riga di comando. ## Monitoraggio del trasferimento tramite la DataSync console Puoi monitorare il DataSync trasferimento utilizzando la console, che fornisce metriche in tempo reale come il trasferimento dei dati, la velocità effettiva di dati e file e la compressione dei dati. **Per monitorare il trasferimento utilizzando la console DataSync** 1. Dopo aver [avviato l' DataSync attività](run-task.md#starting-task), scegli **Visualizza i dettagli di esecuzione**. 1. Visualizza le metriche relative al trasferimento. ## Monitoraggio del trasferimento utilizzando il AWS CLI È possibile monitorare il DataSync trasferimento utilizzando AWS Command Line Interface (AWS CLI). Copia il seguente `describe-task-execution` comando. Per utilizzare questo comando di esempio, sostituisci `user input placeholders` con le tue informazioni. ``` aws datasync describe-task-execution \ --task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task-execution-id' ``` Questo comando restituisce informazioni sull'esecuzione di un'attività simili a quelle mostrate di seguito. ``` { "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 l'esecuzione dell'attività riesce, il valore di **Status (Stato)** cambia in **SUCCESS (RIUSCITO)**. Per informazioni sul significato degli elementi di risposta, vedere[DescribeTaskExecution](API_DescribeTaskExecution.md). + Se l'esecuzione dell'attività non riesce, il risultato invia codici di errore che possono aiutarti a risolvere i problemi. Per informazioni sui codici di errore, vedere. [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) ## Monitoraggio del trasferimento tramite l'`watch`utilità Per monitorare l'avanzamento dell'attività in tempo reale dalla riga di comando, è possibile utilizzare l'`watch`utilità Unix standard. I valori della durata dell'esecuzione dell'attività vengono misurati in millisecondi. L'`watch`utilità non riconosce l'alias. DataSync L'esempio seguente mostra come richiamare direttamente la CLI. Per utilizzare questo comando di esempio, sostituisci `user input placeholders` con le tue informazioni. ``` # 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'" ```