Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Surveillance de vos AWS DataSync transferts
La surveillance est importante pour maintenir la fiabilité et les performances de vos activités de AWS DataSync transfert. Nous vous recommandons de collecter des données de surveillance afin de pouvoir corriger plus facilement les erreurs éventuelles. Avant de commencer la surveillance DataSync, créez toutefois un plan de surveillance qui inclut les réponses aux questions suivantes :
+ Quels sont les objectifs de la surveillance ?
+ Quelles sont les ressources à surveiller ?
+ À quelle fréquence les ressources doivent-elles être surveillées ?
+ Quels outils de surveillance utiliser ?
+ Qui exécute les tâches de supervision ?
+ Qui doit être informé en cas de problème ?
AWS fournit divers services et outils de surveillance DataSync. Vous pouvez configurer certains d'entre eux pour effectuer la surveillance à votre place, mais d'autres nécessitent une intervention manuelle. Nous vous recommandons d’automatiser le plus possible les tâches de supervision.
**Topics**
+ [Comprendre les compteurs de performance du transfert de données](transfer-performance-counters.md)
+ [Surveillance des transferts de données avec Amazon CloudWatch Metrics](monitor-datasync.md)
+ [Surveillance de vos transferts de données à l'aide de rapports de tâches](task-reports.md)
+ [Surveillance des transferts de données avec Amazon CloudWatch Logs](configure-logging.md)
+ [Journalisation des appels d' AWS DataSync API avec AWS CloudTrail](logging-using-cloudtrail.md)
+ [Surveillance des événements à l'aide d'Amazon EventBridge](events.md)
+ [Surveillance AWS DataSync à l'aide d'outils manuels](monitoring-task-manually.md)
# Comprendre les compteurs de performance du transfert de données
Lorsque vous [démarrez une tâche](run-task.md), AWS DataSync fournit des compteurs pour vous aider à suivre les performances et la progression de votre transfert de données.
Utilisez les informations suivantes pour comprendre ce que représente chaque compteur. Vous pouvez consulter ces compteurs dans la DataSync console ou dans une [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)réponse. Certains compteurs ne sont pas disponibles dans tous les [modes de tâche.](choosing-task-mode.md)
| Console | `DescribeTaskExecution` | Support du mode tâche | Description |
| --- | --- | --- | --- |
| – | `BytesWritten` | Amélioré, basique | Le nombre d'octets logiques qui écrivent DataSync réellement sur l'emplacement de destination. |
| **Débit de données** | – | Amélioré, basique | Vitesse à laquelle les octets DataSync logiques sont écrits vers l'emplacement de destination. Si vous utilisez [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), la façon dont vous calculez ce compteur dépend de votre mode de tâche : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) |
| Données transférées | `BytesTransferred` | Amélioré, basique | Le nombre d'octets DataSync envoyés au réseau avant la compression (si la compression est possible). Pour connaître le nombre d'octets transférés sur le réseau, consultez le compteur de **débit réseau** (dans la console) ou `BytesCompressed` (dans [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)) le compteur. |
| **Supprimé de la destination** | `FilesDeleted` | Base | Le nombre de fichiers, d'objets et de répertoires DataSync réellement supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](configure-metadata.md#task-option-file-object-handling) : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) |
| **Supprimé de la destination** | `FilesDeleted`, `FoldersDeleted` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires DataSync réellement supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](configure-metadata.md#task-option-file-object-handling) : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `EstimatedBytesToTransfer` | Amélioré, basique | Le nombre d'octets logiques qui DataSync devraient écrire sur l'emplacement de destination. |
| – | `EstimatedFilesToDelete` | Base | Le nombre de fichiers, d'objets et de répertoires qui DataSync devraient être supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](configure-metadata.md#task-option-file-object-handling), la valeur est toujours`0`. |
| – | `EstimatedFilesToDelete`, `EstimatedFoldersToDelete` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires qui DataSync devraient être supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](configure-metadata.md#task-option-file-object-handling), la valeur est toujours`0`. |
| – | `EstimatedFilesToTransfer` | Base | Le nombre de fichiers, d'objets et de répertoires qui DataSync devraient être transférés sur le réseau. Cette valeur est calculée lors de la DataSync [préparation](run-task.md#understand-task-execution-statuses) du transfert. La façon dont cela est calculé dépend principalement du [mode de transfert](configure-metadata.md#task-option-transfer-mode) que vous utilisez : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `EstimatedFilesToTransfer`, `EstimatedFoldersToTransfer` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires qui DataSync devraient être transférés sur le réseau. Cette valeur est calculée lors de la DataSync [préparation](run-task.md#understand-task-execution-statuses) du transfert. La façon dont cela est calculé dépend principalement du [mode de transfert](configure-metadata.md#task-option-transfer-mode) que vous utilisez : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) |
| **Débit de fichiers** | – | Amélioré, basique | Vitesse à laquelle DataSync les fichiers, les objets et les répertoires sont transférés sur le réseau. Si vous utilisez [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), la façon dont vous calculez ce compteur dépend de votre mode de tâche : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `FilesFailed`, `FoldersFailed` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires dont la préparation, le transfert, la vérification et la suppression DataSync échouent au cours de l'exécution de la tâche. En cas d'échec, vous pouvez les voir à côté des compteurs **Préparé**, **Transféré**, **Ignoré** et **Supprimé de la console de destination**, respectivement. |
| **Répertorié à la source** | `FilesListed.AtSource`, `FoldersListed.AtSource` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires DataSync trouvés dans votre emplacement source. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `FilesListed.AtDestinationForDelete`, `FoldersListed.AtDestinationForDelete` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires trouvés DataSync sur votre emplacement de destination. Ce compteur n'est applicable que si vous configurez votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](configure-metadata.md#task-option-file-object-handling). |
| **Débit du réseau\$1** | `BytesCompressed` | Amélioré, basique | Nombre d'octets physiques DataSync transférés sur le réseau après compression (si la compression est possible). Ce nombre est généralement inférieur aux **données transférées** (dans la console) ou `BytesTransferred` (dans [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)), sauf si les données ne sont pas compressibles. \$1 Pour le mode amélioré, le **débit réseau** ne s'affiche pas dans la console. |
| **Pourcentage compressé** | – | Amélioré, basique | Pourcentage de données de transfert DataSync compressées avant de les envoyer sur le réseau. Si vous utilisez [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), vous pouvez calculer ce compteur avec`1 - BytesCompressed / BytesWritten`. |
| **Préparé** | `FilesPrepared`, `FoldersPrepared` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires qui DataSync tenteront d'être transférés après avoir comparé les emplacements source et de destination. Dans la console, ce compteur peut également vous indiquer le nombre d'objets DataSync ignorés lors de la préparation. Pour de plus amples informations, veuillez consulter [Comment DataSync prépare votre transfert de données](how-datasync-transfer-works.md#how-datasync-prepares). Ce compteur n'est pas applicable si vous configurez votre tâche pour [transférer toutes les données](configure-metadata.md#task-option-transfer-mode). Dans ce scénario, DataSync copie tout de la source vers la destination sans comparer les différences entre les emplacements. |
| **Taux de traitement** | – | Amélioré, basique | La vitesse à laquelle DataSync les fichiers, les objets et les répertoires sont lus dans votre emplacement source. Le taux de traitement est basé sur plusieurs [CloudWatch indicateurs](monitor-datasync.md#accessing-metrics). Les mesures exactes dépendent du mode de tâche que vous utilisez. **Mode amélioré** : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) **Mode de base :** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/datasync/latest/userguide/transfer-performance-counters.html) |
| **Restant** | – | Base | Le nombre restant de fichiers, d'objets et de répertoires qui DataSync devraient être transférés sur le réseau. Si vous utilisez [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), vous pouvez calculer ce compteur en soustrayant de. `FilesTransferred` `EstimatedFilesToTransfer` |
| **Ignoré\$1** | `FilesSkipped` | Base | Le nombre de fichiers, d'objets et de répertoires DataSync ignorés lors de votre transfert. |
| – | `FilesSkipped`, `FoldersSkipped` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires DataSync ignorés lors de votre transfert. Les éléments **ignorés** sont inclus dans le compteur **préparé** lorsque vous [transférez uniquement les données modifiées](configure-metadata.md#task-option-transfer-mode) ou dans le compteur **transféré** lorsque vous [transférez toutes les données](configure-metadata.md#task-option-transfer-mode). |
| **Transféré** | `FilesTransferred` | Base | Le nombre de fichiers, d'objets et de répertoires DataSync transférés sur le réseau. Cette valeur est mise à jour régulièrement pendant l'exécution de la tâche lorsqu'un élément est lu depuis la source et envoyé sur le réseau. En cas d' DataSync échec du transfert, cette valeur peut être inférieure à `EstimatedFilesToTransfer` ou`EstimatedFoldersToTransfer`. Dans certains cas, cette valeur peut également être supérieure à `EstimatedFilesToTransfer` ou`EstimatedFoldersToTransfer`. Ce compteur est spécifique à l'implémentation de certains types d'emplacement. Ne l'utilisez donc pas pour indiquer exactement ce qui est transféré ou pour surveiller l'exécution de vos tâches. |
| **Transféré** | `FilesTransferred`, `FoldersTransferred` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires DataSync transférés sur le réseau. Cette valeur est mise à jour régulièrement pendant l'exécution de la tâche lorsqu'un élément est lu depuis la source et envoyé sur le réseau. En cas d' DataSync échec du transfert, cette valeur peut être inférieure à `EstimatedFilesToTransfer` ou`EstimatedFoldersToTransfer`. Dans certains cas, cette valeur peut également être supérieure à `EstimatedFilesToTransfer` ou`EstimatedFoldersToTransfer`. Ce compteur est spécifique à l'implémentation de certains types d'emplacement. Ne l'utilisez donc pas pour indiquer exactement ce qui est transféré ou pour surveiller l'exécution de vos tâches. |
| **Vérifié** | `FilesVerified` | Base | Le nombre de fichiers, d'objets et de répertoires qui sont DataSync vérifiés lors de votre transfert. Lorsque vous configurez votre tâche pour [vérifier uniquement les données transférées](configure-data-verification-options.md), DataSync elle ne vérifie pas les répertoires dans certains cas, ni les fichiers ou objets dont le transfert échoue. |
| **Vérifié** | `FilesVerified`, `FoldersVerified` | Amélioré | Le nombre de fichiers ou d'objets et de répertoires qui sont DataSync vérifiés lors de votre transfert. |
# Surveillance des transferts de données avec Amazon CloudWatch Metrics
Amazon CloudWatch fournit des indicateurs pour suivre les performances des DataSync transferts et résoudre les problèmes liés à votre tâche de transfert.
Vous pouvez surveiller les performances des AWS DataSync transferts à l'aide CloudWatch des métriques Amazon. DataSync les métriques sont automatiquement envoyées CloudWatch à intervalles de 5 minutes (quelle que soit la façon dont vous [configurez la journalisation](configure-logging.md)). Les indicateurs sont conservés pendant une période de 15 mois.
Pour consulter CloudWatch les statistiques relatives à DataSync, vous pouvez utiliser les outils suivants :
+ La CloudWatch console
+ La CloudWatch CLI
+ L' CloudWatch API
+ La DataSync console (sur la page de détails de l'exécution de la tâche)
Pour plus d'informations, consultez le [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 métriques pour DataSync
DataSync les métriques utilisent l'espace de `aws/datasync` noms et fournissent des métriques pour les dimensions suivantes :
+ **AgentId**— L'identifiant unique de l'agent (si votre tâche utilise un agent).
+ **TaskId**— L'identifiant unique de la tâche. Elle prend la forme suivante : `task-01234567890abcdef`.
L’espace de noms `aws/datasync` inclut les métriques suivantes. Certains indicateurs ne sont pas disponibles dans tous les [modes de tâche](choosing-task-mode.md).
| CloudWatch métrique | Support du mode tâche | Description |
| --- | --- | --- |
| `BytesCompressed` | Base | Nombre d'octets physiques DataSync transférés sur le réseau après compression (si la compression est possible). Ce nombre est généralement inférieur à `BytesTransferred` sauf si les données ne sont pas compressibles. Unité : octets |
| `BytesPreparedDestination` | Base | Nombre d'octets logiques préparés DataSync à l'emplacement de destination. Unité : octets |
| `BytesPreparedSource` | Base | Nombre d'octets logiques préparés DataSync à l'emplacement source. Unité : octets |
| `BytesTransferred` | Base | Nombre d'octets DataSync envoyés au réseau avant la compression (si la compression est possible). Pour le nombre d'octets transférés sur le réseau, consultez la `BytesCompressed` métrique. Unité : octets |
| `BytesVerifiedDestination` | Base | Le nombre d'octets logiques qui sont DataSync vérifiés à l'emplacement de destination. Unité : octets |
| `BytesVerifiedSource` | Base | Nombre d'octets logiques qui DataSync vérifient à l'emplacement source. Unités : octets |
| `BytesWritten` | Amélioré, basique | Nombre d'octets logiques qui DataSync écrivent sur l'emplacement de destination. Unité : octets |
| `FilesDeleted` | Amélioré, basique | Le nombre de fichiers, d'objets et de répertoires DataSync supprimés dans votre emplacement de destination. Si vous ne configurez pas votre tâche pour [supprimer des données dans la destination qui ne figurent pas dans la source](configure-metadata.md#task-option-file-object-handling), la valeur est toujours`0`. Unité : nombre |
| `FilesListedSource` | Amélioré | Le nombre d'objets DataSync trouvés à votre emplacement source. Unité : nombre |
| `FilesPrepared` | Amélioré | Le nombre d'objets qui DataSync tenteront d'être transférés après avoir comparé vos emplacements source et de destination. Pour de plus amples informations, veuillez consulter [Comment DataSync prépare votre transfert de données](how-datasync-transfer-works.md#how-datasync-prepares). Cette métrique n'est pas applicable si vous configurez votre tâche pour [transférer toutes les données](configure-metadata.md#task-option-transfer-mode). Dans ce scénario, DataSync copie tout de la source vers la destination sans comparer les différences entre les emplacements. Unité : nombre |
| `FilesPreparedDestination` | Base | Nombre de fichiers, d'objets et de répertoires préparés DataSync à l'emplacement de destination. Unité : nombre |
| `FilesPreparedSource` | Base | Nombre de fichiers, d'objets et de répertoires DataSync préparés à l'emplacement source. Unité : nombre |
| `FilesSkipped` | Base | Le nombre de fichiers, d'objets et de répertoires DataSync ignorés lors de votre transfert. Unité : nombre |
| `FilesTransferred` | Amélioré, basique | Le nombre de fichiers, d'objets et de répertoires DataSync transférés sur le réseau. Cette valeur est mise à jour périodiquement pendant l'[exécution de la tâche](run-task.md#understand-task-execution-statuses) lorsqu'un élément est lu depuis la source et envoyé sur le réseau. Cette valeur peut être inférieure `EstimatedFilesToTransfer` à celle d'une [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)réponse en cas d' DataSync échec du transfert. Dans certains cas, cette valeur peut également être supérieure à`EstimatedFilesToTransfer`. Cette métrique est spécifique à l'implémentation pour certains types de sites. Ne l'utilisez donc pas comme une indication exacte de ce qui a été transféré ou pour surveiller l'exécution de vos tâches. Unité : nombre |
| `FilesVerified` | Amélioré | Le nombre d'objets qui sont DataSync vérifiés lors de votre transfert. Unité : nombre |
| `FilesVerifiedDestination` | Base | Nombre de fichiers, d'objets et de répertoires DataSync vérifiés à l'emplacement de destination. Unité : nombre |
| `FilesVerifiedSource` | Base | Nombre de fichiers, d'objets et de répertoires DataSync vérifiés à l'emplacement source. Unité : nombre |
# Surveillance de vos transferts de données à l'aide de rapports de tâches
*Les rapports de tâches* fournissent des informations détaillées sur les AWS DataSync tentatives de transfert, d'omission, de vérification et de suppression au cours de l'exécution d'une tâche. Pour de plus amples informations, veuillez consulter [Comment DataSync transférer des fichiers, des objets et des répertoires](how-datasync-transfer-works.md#transferring-files).
Les rapports de tâches sont générés au format JSON. Vous pouvez personnaliser le niveau de détail de vos rapports :
+ [Les rapports de tâches récapitulatifs](#task-report-types-summary) vous fournissent les détails nécessaires sur l'exécution de vos tâches, tels que le nombre de fichiers transférés et la DataSync possibilité de vérifier l'intégrité des données de ces fichiers.
+ Les [rapports de tâches standard](#task-report-types-standard) incluent un résumé ainsi que des rapports détaillés répertoriant chaque fichier, objet ou dossier DataSync tenté de transférer, d'ignorer, de vérifier ou de supprimer. Avec un rapport de tâches standard, vous pouvez également spécifier le [niveau du rapport](#task-report-level) pour n'afficher que les erreurs d'exécution de la tâche ou ses réussites et erreurs.
## Cas d’utilisation
Voici quelques situations dans lesquelles les rapports de tâches peuvent vous aider à surveiller et à auditer vos transferts de données :
+ Lorsque vous migrez des millions de fichiers, identifiez rapidement les fichiers DataSync présentant des problèmes de transfert.
+ Vérifiez chain-of-custody les processus relatifs à vos fichiers.
## Rapports de tâches récapitulatifs uniquement
Un rapport qui n'est qu'un résumé de l'exécution d'une tâche inclut les détails suivants :
+ Celui Compte AWS qui a exécuté l'exécution de la tâche
+ Les lieux d'origine et de destination
+ Nombre total de fichiers, d'objets et de dossiers ignorés, transférés, vérifiés et supprimés
+ Nombre total d'octets (logiques et physiques) transférés
+ Si l'exécution de la tâche a été terminée, annulée ou a rencontré une erreur
+ Les heures de début et de fin (y compris la durée totale du transfert)
+ Les paramètres de la tâche (tels que les limites de bande passante, la vérification de l'intégrité des données et les autres options de DataSync transfert)
## Rapports de tâches standard
Un rapport de tâches standard inclut un [résumé](#task-report-types-summary) de l'exécution de vos tâches ainsi que des rapports détaillés sur les DataSync tentatives de transfert, d'omission, de vérification et de suppression.
**Topics**
+ [Niveau du rapport](#task-report-level)
+ [Rapports transférés](#task-report-types-transferred)
+ [Rapports ignorés](#task-report-types-skipped)
+ [Rapports vérifiés](#task-report-types-verified)
+ [Rapports supprimés](#task-report-types-deleted)
### Niveau du rapport
Avec les rapports de tâches standard, vous pouvez choisir l'un des niveaux de rapport suivants :
+ Erreurs uniquement
+ Succès et erreurs (essentiellement une liste de tout ce qui s'est passé pendant l'exécution de votre tâche)
Par exemple, vous souhaiterez peut-être voir quels fichiers DataSync ont été ignorés avec succès lors de votre transfert et ceux qui n'ont pas été ignorés. Les fichiers qui DataSync ont été correctement ignorés peuvent être ceux que vous DataSync souhaitez délibérément exclure car ils existent déjà dans votre emplacement de destination. Cependant, une erreur ignorée, par exemple, peut indiquer que vous DataSync ne disposez pas des autorisations nécessaires pour lire un fichier.
### Rapports transférés
Liste des fichiers, objets et répertoires qui DataSync ont tenté d'être transférés lors de l'exécution de la tâche. Un rapport transféré inclut les informations suivantes :
+ Les chemins d'accès aux données transférées
+ Ce qui a été transféré (contenu, métadonnées ou les deux)
+ Les métadonnées, qui incluent le type de données, la taille du contenu (objets et fichiers uniquement), etc.
+ Heure à laquelle un article a été transféré
+ La version de l'objet (si la destination est un compartiment Amazon S3 sur lequel la gestion des versions est activée)
+ Si quelque chose a été remplacé dans la destination
+ Si un article a été transféré avec succès
**Note**
Lorsque vous déplacez des données entre des compartiments S3, le préfixe que vous spécifiez dans votre [emplacement source](create-s3-location.md) peut apparaître dans votre rapport (ou dans les CloudWatch journaux Amazon), même si ce préfixe n'existe pas en tant qu'objet dans votre emplacement de destination. (Dans la DataSync console, vous remarquerez peut-être également que ce préfixe apparaît sous forme de données ignorées ou vérifiées.)
### Rapports ignorés
Liste de fichiers, d'objets et de répertoires trouvés dans DataSync votre emplacement source mais dont le transfert n'a pas été tenté. Les raisons pour lesquelles des DataSync données sont ignorées peuvent dépendre de plusieurs facteurs, tels que la manière dont vous configurez vos tâches et les autorisations du système de stockage. Voici quelques exemples :
+ Un fichier existe dans vos emplacements source et de destination. Le fichier de la source n'a pas été modifié depuis l'exécution précédente de la tâche. Comme vous [ne transférez que des données modifiées](configure-metadata.md#task-option-transfer-mode), ce fichier DataSync ne sera pas transféré la prochaine fois que vous exécuterez votre tâche.
+ Un objet qui existe dans vos deux emplacements change dans votre source. Lorsque vous exécutez votre tâche, cet objet DataSync est ignoré dans votre destination car votre tâche ne [remplace pas les données dans la](configure-metadata.md#task-option-file-object-handling) destination.
+ DataSync ignore un objet de votre source qui utilise une [classe de stockage d'archivage](create-s3-location.md#using-storage-classes) et qui n'est pas restauré. Vous devez restaurer un objet archivé DataSync pour pouvoir le lire.
+ DataSync ignore un fichier, un objet ou un répertoire dans votre emplacement source car il ne peut pas le lire. Si cela se produit et n'est pas prévu, vérifiez les autorisations d'accès de votre espace de stockage et assurez-vous qu'il DataSync peut lire ce qui a été ignoré.
Un rapport ignoré inclut les informations suivantes :
+ Les chemins pour les données ignorées
+ Heure à laquelle un élément a été ignoré
+ La raison pour laquelle il a été ignoré
+ Si un élément a été ignoré avec succès
**Note**
Les rapports ignorés peuvent être volumineux lorsqu'ils incluent des réussites et des erreurs, que vous configurez votre tâche pour [ne transférer que les données modifiées](configure-metadata.md) et que les données sources existent déjà dans la destination.
### Rapports vérifiés
Liste des fichiers, objets et répertoires dont l'intégrité DataSync a été testée lors de l'exécution de la tâche. Un rapport de données vérifié inclut les informations suivantes :
+ Les chemins d'accès aux données vérifiées
+ Heure à laquelle un article a été vérifié
+ La raison de l'erreur de vérification (le cas échéant)
+ Les SHA256 checksums source et de destination (fichiers uniquement)
+ Si un article a été vérifié avec succès
Notez ce qui suit à propos des rapports vérifiés :
+ Lorsque vous configurez votre tâche pour [vérifier uniquement les données transférées](configure-data-verification-options.md), DataSync elle ne vérifie pas les répertoires dans certains cas, ni les fichiers ou objets dont le transfert échoue. Dans les deux cas, DataSync n'inclut pas les données non vérifiées dans ce rapport.
+ Si vous utilisez le [mode amélioré](choosing-task-mode.md), la vérification peut prendre plus de temps que d'habitude si vous transférez des objets volumineux.
### Rapports supprimés
Liste des fichiers, des répertoires et des objets qui ont été supprimés lors de l'exécution de la tâche. DataSync génère ce rapport uniquement si vous [configurez votre tâche](configure-metadata.md) pour supprimer des données dans l'emplacement de destination qui ne se trouve pas dans la source. Un rapport de données supprimé inclut les informations suivantes :
+ Les chemins pour les données supprimées
+ Si un élément a été correctement supprimé
+ Heure à laquelle un élément a été supprimé
## Exemples de rapports de tâches
Le niveau de détail de votre rapport de tâches dépend de vous. Voici quelques exemples de rapports de données transférés avec la configuration suivante :
+ **Type de rapport** — Standard
+ **Niveau du rapport** — Succès et erreurs
**Note**
Les rapports utilisent la norme ISO-8601 pour le format d'horodatage. Les temps sont exprimés en UTC et mesurés en nanosecondes. Ce comportement est différent de la façon dont certains autres indicateurs des rapports de tâches sont mesurés. Par exemple, les [détails de l'exécution des tâches](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskExecutionResultDetail.html), tels que `TransferDuration` et`VerifyDuration`, sont mesurés en millisecondes.
Les rapports de tâches en mode amélioré utilisent un schéma légèrement différent de celui des rapports de tâches en mode de base. Les exemples suivants peuvent vous aider à savoir à quoi vous attendre de vos rapports en fonction du [mode de tâche](choosing-task-mode.md) que vous utilisez.
**Exemples de rapports de données transférés avec statut de réussite**
Les rapports suivants indiquent les transferts réussis pour un objet nommé`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"
}]
}
```
**Exemples de rapports de données transférés avec statut d'erreur**
Les rapports suivants fournissent des exemples de situations dans lesquelles il est DataSync impossible de transférer un objet nommé`object1.txt`.
Ce rapport montre qu'il est DataSync impossible d'accéder à un objet nommé en `object1.txt` raison d'un problème d' AWS KMS autorisation. (Si une erreur de ce type s'affiche, consultez[Accès aux compartiments S3 à l'aide du chiffrement côté serveur](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"
}]
}
```
Ce rapport indique qu'un objet nommé `object1.txt` n'a pas été transféré en raison d'un problème d'autorisation du compartiment S3. (Si une erreur de ce type s'affiche, consultez[Fournir DataSync un accès aux compartiments 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
}]
}
```
## Limitations
+ Les rapports de tâches individuels ne peuvent pas dépasser 5 Mo. Si vous copiez un grand nombre de fichiers, votre rapport de tâches peut être divisé en plusieurs rapports.
+ Dans certains cas, la création de rapports de tâches peut affecter les performances de votre transfert de données. Par exemple, vous pouvez le remarquer lorsque votre connexion réseau présente une latence élevée et que les fichiers que vous transférez sont petits ou que vous ne copiez que les modifications de métadonnées.
# Création de vos rapports de DataSync tâches
AWS DataSync les rapports de tâches ne peuvent être qu'un résumé de l'exécution de vos tâches ou un ensemble de rapports détaillés sur les DataSync tentatives de transfert, d'omission, de vérification et de suppression.
## Conditions préalables
Avant de créer un rapport de tâches, vous devez effectuer les opérations suivantes.
**Topics**
+ [Créez un compartiment S3 pour vos rapports de tâches](#setting-up-task-report-create-bucket)
+ [DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3](#task-report-access)
### Créez un compartiment S3 pour vos rapports de tâches
Si vous n'en avez pas déjà un, [créez un compartiment S3 dans](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) lequel DataSync vous pourrez télécharger votre rapport de tâches. Les rapports sont stockés dans la classe de stockage S3 Standard.
Nous recommandons ce qui suit pour ce compartiment :
+ Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous [désactivez l'option **Conserver les fichiers supprimés**](configure-metadata.md). Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.
+ Pour éviter une configuration complexe des autorisations d'accès, assurez-vous que le compartiment de votre rapport de tâches se trouve dans la même Compte AWS région que votre tâche de DataSync transfert.
### DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3
Vous devez configurer un rôle Gestion des identités et des accès AWS (IAM) qui permet de DataSync télécharger un rapport de tâches dans votre compartiment S3.
Dans la DataSync console, vous pouvez créer un rôle IAM qui, dans la plupart des cas, inclut automatiquement les autorisations nécessaires pour télécharger un rapport de tâches dans votre compartiment. N'oubliez pas que ce rôle généré automatiquement peut ne pas répondre à vos besoins du point de vue du moindre privilège. Ce rôle ne fonctionnera pas non plus si votre compartiment est chiffré à l'aide d'une clé gérée par le client AWS Key Management Service (AWS KMS) (SSE-KMS). Dans ces cas, vous pouvez créer le rôle manuellement à condition que le rôle effectue au moins les tâches suivantes :
+ [Empêche le problème de confusion entre les services](https://docs.aws.amazon.com/datasync/latest/userguide/cross-service-confused-deputy-prevention.html) au sein de l'entité de confiance associée au rôle.
L'exemple complet suivant montre comment utiliser les touches contextuelles de condition `aws:SourceAccount` globale `aws:SourceArn` et les touches contextuelles pour éviter le problème de confusion lié aux adjoints 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:*"
}
}
}
]
}
```
------
+ Permet DataSync de télécharger un rapport de tâches dans votre compartiment S3.
Pour ce faire, l'exemple suivant inclut l'`s3:PutObject`action uniquement pour un préfixe spécifique (`reports/`) dans votre compartiment.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Action": [
"s3:PutObject"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*"
}]
}
```
------
+ Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la [politique de la clé](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.
Pour de plus amples informations, veuillez consulter [Accès aux compartiments S3 à l'aide du chiffrement côté serveur](create-s3-location.md#create-s3-location-encryption).
## Création d'un rapport de tâches récapitulatif uniquement
Vous pouvez configurer un rapport de tâche qui inclut un [résumé uniquement](task-reports.md#task-report-types-summary) lors de la création, du démarrage ou de la mise à jour de la tâche. DataSync
Les étapes suivantes montrent comment configurer un rapport de tâches récapitulatif uniquement lors de la création d'une tâche.
### Utilisation de la DataSync console
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Tâches**, puis choisissez **Créer une tâche**.
1. Configurez les emplacements source et de destination de votre tâche.
Pour de plus amples informations, consultez [Où puis-je transférer mes données AWS DataSync ?](working-with-locations.md).
1. Faites défiler la page jusqu'à la section **Rapport des tâches**. Pour **le type de rapport**, sélectionnez **Résumé uniquement**.
1. Pour le **compartiment S3 pour les rapports**, choisissez un compartiment S3 dans lequel vous DataSync souhaitez télécharger votre rapport de tâches.
**Astuce**
Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous [désactivez l'option **Conserver les fichiers supprimés**](configure-metadata.md). Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.
1. Pour **Dossier**, entrez un préfixe à utiliser pour votre rapport de tâches lors du DataSync téléchargement du rapport dans votre compartiment S3 (par exemple,**reports/**).
Assurez-vous d'inclure le caractère délimiteur approprié à la fin de votre préfixe. Ce caractère est généralement une barre oblique (`/`). Pour plus d'informations, consultez la section [Organisation des objets à l'aide de préfixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) dans le *guide de l'utilisateur Amazon S3*.
1. Pour **IAM role (Rôle IAM)**, effectuez l'une des opérations suivantes :
+ Choisissez **Autogenerate** pour créer DataSync automatiquement un rôle IAM avec les autorisations requises pour accéder au compartiment S3.
Si un rôle IAM a DataSync déjà été créé pour ce compartiment S3, ce rôle est choisi par défaut.
+ Choisissez un rôle IAM personnalisé que vous avez créé.
Dans certains cas, vous devrez peut-être créer le rôle vous-même. Pour de plus amples informations, veuillez consulter [DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3](#task-report-access).
**Important**
Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.
Pour de plus amples informations, veuillez consulter [Accès aux compartiments S3 à l'aide du chiffrement côté serveur](create-s3-location.md#create-s3-location-encryption).
1. Terminez la création de votre tâche, puis [lancez-la](run-task.md) pour commencer à transférer vos données.
Lorsque votre transfert est terminé, vous pouvez [consulter votre rapport de tâches](task-report-viewing.md).
### En utilisant le AWS CLI
1. Copiez la commande suivante `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. Pour le `--source-location-arn` paramètre, spécifiez l'Amazon Resource Name (ARN) de l'emplacement source de votre transfert. Remplacez `us-east-1` par le numéro approprié Région AWS, remplacez `123456789012` par le Compte AWS numéro approprié et remplacez `12345678abcdefgh` par l'ID d'emplacement source approprié.
1. Pour le `--destination-location-arn` paramètre, spécifiez l'ARN de l'emplacement de destination de votre transfert. Remplacez `us-east-1` par le numéro approprié Région AWS, remplacez `123456789012` par le Compte AWS numéro approprié et remplacez `abcdefgh12345678` par le numéro de localisation de destination approprié.
1. Pour le `--task-report-config` paramètre, procédez comme suit :
+ `Subdirectory`— `reports/` Remplacez-le par le préfixe de votre compartiment S3 dans lequel vous DataSync souhaitez télécharger vos rapports de tâches.
Assurez-vous d'inclure le caractère délimiteur approprié à la fin de votre préfixe. Ce caractère est généralement une barre oblique (`/`). Pour plus d'informations, consultez la section [Organisation des objets à l'aide de préfixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) dans le *guide de l'utilisateur Amazon S3*.
+ `S3BucketArn`— Spécifiez l'ARN du compartiment S3 dans lequel vous souhaitez télécharger votre rapport de tâches.
**Astuce**
Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous [désactivez l'option **Conserver les fichiers supprimés**](configure-metadata.md). Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.
+ `BucketAccessRoleArn`— Spécifiez le rôle IAM qui permet DataSync de télécharger un rapport de tâches dans votre compartiment S3.
Pour de plus amples informations, veuillez consulter [DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3](#task-report-access).
**Important**
Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.
Pour de plus amples informations, veuillez consulter [Accès aux compartiments S3 à l'aide du chiffrement côté serveur](create-s3-location.md#create-s3-location-encryption).
+ `OutputType`— Spécifiez`SUMMARY_ONLY`.
Pour de plus amples informations, veuillez consulter [Rapports de tâches récapitulatifs uniquement](task-reports.md#task-report-types-summary).
1. Exécutez la `create-task` commande pour créer votre tâche.
Vous obtenez une réponse semblable à la suivante qui indique l'ARN de la tâche que vous avez créée. Vous aurez besoin de cet ARN pour exécuter la `start-task-execution` commande.
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}
```
1. Copiez la `start-task-execution` commande suivante.
```
aws datasync-task-report start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. Pour le `--task-arn` paramètre, spécifiez l'ARN de la tâche que vous démarrez. Utilisez l'ARN que vous avez reçu lors de l'exécution de la `create-task` commande.
1. Exécutez la commande `start-task-execution`.
Lorsque votre transfert est terminé, vous pouvez [consulter votre rapport de tâches](task-report-viewing.md).
## Création d'un rapport de tâches standard
Vous pouvez configurer un [rapport de tâche standard](task-reports.md#task-report-types-standard) lors de la création, du démarrage ou de la mise à jour de la tâche. DataSync
Les étapes suivantes montrent comment configurer un rapport de tâche standard lors de la création d'une tâche.
### Utilisation de la DataSync console
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Tâches**, puis choisissez **Créer une tâche**.
1. Configurez les emplacements source et de destination de votre tâche.
Pour de plus amples informations, consultez [Où puis-je transférer mes données AWS DataSync ?](working-with-locations.md).
1. Faites défiler la page jusqu'à la section **Rapport des tâches**. Pour **Type de rapport**, choisissez **Rapport standard**.
1. Pour **le niveau du rapport**, choisissez l'une des options suivantes :
+ **Erreurs uniquement** : votre rapport de tâches inclut uniquement les problèmes liés aux DataSync tentatives de transfert, d'omission, de vérification et de suppression.
+ **Succès et erreurs** : votre rapport de tâches indique ce qui a été transféré, ignoré, vérifié et supprimé DataSync avec succès et ce qui n'a pas été le cas.
+ **Personnalisé** : vous permet de choisir si vous souhaitez voir uniquement les erreurs ou les réussites et les erreurs pour des aspects spécifiques de votre rapport de tâches.
Par exemple, vous pouvez sélectionner **Succès et erreurs** pour la liste des fichiers transférés, mais **Erreurs uniquement** pour le reste du rapport.
1. Si vous effectuez un transfert vers un compartiment S3 qui utilise la gestion des versions d'objets, maintenez l'option **Inclure les versions d'objets Amazon S3** sélectionnée si vous souhaitez que votre rapport inclue la nouvelle version pour chaque objet transféré.
1. Pour le **compartiment S3 pour les rapports**, choisissez un compartiment S3 dans lequel vous DataSync souhaitez télécharger votre rapport de tâches.
**Astuce**
Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous [désactivez l'option **Conserver les fichiers supprimés**](configure-metadata.md). Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.
1. Pour **Dossier**, entrez un préfixe à utiliser pour votre rapport de tâches lors du DataSync téléchargement du rapport dans votre compartiment S3 (par exemple,**reports/**). Assurez-vous d'inclure le caractère délimiteur approprié à la fin de votre préfixe. Ce caractère est généralement une barre oblique (`/`). Pour plus d'informations, consultez la section [Organisation des objets à l'aide de préfixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) dans le *guide de l'utilisateur Amazon S3*.
1. Pour **IAM role (Rôle IAM)**, effectuez l'une des opérations suivantes :
+ Choisissez **Autogenerate** pour créer DataSync automatiquement un rôle IAM avec les autorisations requises pour accéder au compartiment S3.
Si un rôle IAM a DataSync déjà été créé pour ce compartiment S3, ce rôle est choisi par défaut.
+ Choisissez un rôle IAM personnalisé que vous avez créé.
Dans certains cas, vous devrez peut-être créer le rôle vous-même. Pour de plus amples informations, veuillez consulter [DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3](#task-report-access).
**Important**
Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.
Pour de plus amples informations, veuillez consulter [Accès aux compartiments S3 à l'aide du chiffrement côté serveur](create-s3-location.md#create-s3-location-encryption).
1. Terminez la création de votre tâche et [lancez-la](run-task.md) pour commencer à transférer vos données.
Lorsque votre transfert est terminé, vous pouvez [consulter votre rapport de tâches](task-report-viewing.md).
### En utilisant le AWS CLI
1. Copiez la `create-task` commande suivante :
```
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. Pour le `--source-location-arn` paramètre, spécifiez l'ARN de l'emplacement source dans votre transfert. Remplacez `us-east-1` par le numéro approprié Région AWS, remplacez `123456789012` par le Compte AWS numéro approprié et remplacez `12345678abcdefgh` par l'ID d'emplacement source approprié.
1. Pour le `--destination-location-arn` paramètre, spécifiez l'ARN de l'emplacement de destination de votre transfert. Remplacez `us-east-1` par le numéro approprié Région AWS, remplacez `123456789012` par le Compte AWS numéro approprié et remplacez `abcdefgh12345678` par le numéro de localisation de destination approprié.
1. Pour le `--task-report-config` paramètre, procédez comme suit :
+ `Subdirectory`— `reports/` Remplacez-le par le préfixe de votre compartiment S3 dans lequel vous DataSync souhaitez télécharger vos rapports de tâches. Assurez-vous d'inclure le caractère délimiteur approprié à la fin de votre préfixe. Ce caractère est généralement une barre oblique (`/`). Pour plus d'informations, consultez la section [Organisation des objets à l'aide de préfixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) dans le *guide de l'utilisateur Amazon S3*.
+ `S3BucketArn`— Spécifiez l'ARN du compartiment S3 dans lequel vous souhaitez télécharger votre rapport de tâches.
**Astuce**
Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous [désactivez l'option **Conserver les fichiers supprimés**](configure-metadata.md). Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.
+ `BucketAccessRoleArn`— Spécifiez le rôle IAM qui permet DataSync de télécharger un rapport de tâches dans votre compartiment S3.
Pour de plus amples informations, veuillez consulter [DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3](#task-report-access).
**Important**
Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.
Pour de plus amples informations, veuillez consulter [Accès aux compartiments S3 à l'aide du chiffrement côté serveur](create-s3-location.md#create-s3-location-encryption).
+ `OutputType`— Spécifiez `STANDARD` le rapport.
Pour plus d'informations, consultez la section [Rapports de tâches standard](task-reports.md#task-report-types-standard) Types de rapports de tâches.
+ (Facultatif) `ReportLevel` — Spécifiez si vous le souhaitez `ERRORS_ONLY` (par défaut) ou `SUCCESSES_AND_ERRORS` dans votre rapport.
+ (Facultatif) `ObjectVersionIds` — Si vous effectuez un transfert vers un compartiment S3 qui utilise le contrôle de version des objets, spécifiez `NONE` si vous ne souhaitez pas inclure la nouvelle version pour chaque objet transféré dans le rapport.
Cette option est définie par défaut sur `INCLUDE`.
+ (Facultatif) `Overrides` — Personnalisez un aspect particulier de votre rapport. `ReportLevel`
Par exemple, vous voudrez peut-être voir `SUCCESSES_AND_ERRORS` la liste de ce qui est DataSync supprimé dans votre lieu de destination, mais vous voulez tout `ERRORS_ONLY` le reste. Dans cet exemple, vous devez ajouter l'`Overrides`option suivante au `--task-report-config` paramètre :
```
"Overrides":{
"Deleted":{
"ReportLevel":"SUCCESSES_AND_ERRORS"
}
}
```
Si vous ne l'utilisez pas`Overrides`, l'ensemble de votre rapport utilise `ReportLevel` ce que vous spécifiez.
1. Exécutez la `create-task` commande pour créer votre tâche.
Vous obtenez une réponse semblable à la suivante qui indique l'ARN de la tâche que vous avez créée. Vous aurez besoin de cet ARN pour exécuter la `start-task-execution` commande.
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}
```
1. Copiez la `start-task-execution` commande suivante.
```
aws datasync-task-report start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. Pour le `--task-arn` paramètre, spécifiez l'ARN de la tâche que vous exécutez. Utilisez l'ARN que vous avez reçu lors de l'exécution de la `create-task` commande.
1. Exécutez la commande `start-task-execution`.
Lorsque votre transfert est terminé, vous pouvez [consulter votre rapport de tâches](task-report-viewing.md).
# Afficher vos rapports DataSync de tâches
DataSync crée des rapports de tâches pour chaque exécution de tâche. Lorsque votre exécution est terminée, vous pouvez trouver les rapports de tâches correspondants dans votre compartiment S3. Les rapports de tâches sont organisés sous des préfixes qui incluent IDs les tâches et leur exécution.
Pour vous aider à localiser les rapports de tâches dans votre compartiment S3, utilisez les exemples suivants :
+ **Rapport de tâches récapitulatif uniquement** — `reports-prefix/Summary-Reports/task-id-folder/task-execution-id-folder`
+ **Rapport de tâches standard** — `reports-prefix/Detailed-Reports/task-id-folder/task-execution-id-folder`
Les rapports de tâches étant au format JSON, plusieurs options s'offrent à vous pour les consulter :
+ Consultez un rapport à l'aide d'[Amazon S3 Select](https://docs.aws.amazon.com/AmazonS3/latest/userguide/selecting-content-from-objects.html).
+ Visualisez les rapports à l'aide de AWS services tels qu' AWS Glue Amazon Athena et Amazon Quick. Pour plus d'informations sur la visualisation de vos rapports de tâches, consultez le [blog sur le AWS stockage](https://aws.amazon.com/blogs/storage/derive-insights-from-aws-datasync-task-reports-using-aws-glue-amazon-athena-and-amazon-quicksight/).
# Surveillance des transferts de données avec Amazon CloudWatch Logs
Vous pouvez surveiller votre AWS DataSync transfert à l'aide CloudWatch des journaux. Nous vous recommandons de configurer votre tâche de manière à consigner au moins les informations de base (telles que les erreurs de transfert).
## DataSync Autoriser le téléchargement de journaux dans un groupe de CloudWatch journaux
Pour [configurer la journalisation](#configure-logging-for-task) de votre DataSync tâche, vous avez besoin d'un groupe de CloudWatch journaux autorisé à envoyer des journaux. DataSync Vous configurez cet accès via un rôle Gestion des identités et des accès AWS (IAM). La manière dont cela fonctionne spécifiquement dépend de votre [mode de tâche](choosing-task-mode.md).
------
#### [ Enhanced mode ]
Avec le mode amélioré, envoie DataSync automatiquement les journaux des tâches à un groupe de journaux nommé`/aws/datasync`. Si ce groupe de journaux n'existe pas dans votre compte Région AWS, DataSync crée le groupe de journaux en votre nom en utilisant un [rôle lié à un service](https://docs.aws.amazon.com/datasync/latest/userguide/using-service-linked-roles-service-action-2.html) IAM lorsque vous créez votre tâche.
------
#### [ Basic mode ]
Le mode de base permet de configurer un groupe de CloudWatch journaux pour une DataSync tâche de plusieurs manières. Dans la console, vous pouvez créer automatiquement un rôle IAM qui inclut dans la plupart des cas les autorisations nécessaires pour DataSync télécharger des journaux. N'oubliez pas que ce rôle généré automatiquement peut ne pas répondre à vos besoins du point de vue du moindre privilège.
Si vous souhaitez utiliser un groupe de CloudWatch journaux existant ou si vous créez vos tâches par programmation, vous devez créer vous-même le rôle IAM.
L'exemple suivant est une politique IAM qui accorde ces autorisations.
****
```
{
"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 politique utilise `Condition` des instructions pour garantir que seules DataSync les tâches du compte spécifié ont accès au groupe de CloudWatch journaux spécifié. Nous recommandons d'utiliser les clés de contexte [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)et de condition [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)globale dans ces `Condition` instructions pour éviter le problème de confusion des adjoints. Pour de plus amples informations, veuillez consulter [Prévention du problème de l’adjoint confus entre services](cross-service-confused-deputy-prevention.md).
Pour spécifier la DataSync ou les tâches, *`region`* remplacez-les par le code de région correspondant à l' Région AWS emplacement des tâches (par exemple,`us-west-2`) et remplacez-le par *`account-id`* l' Compte AWS ID du compte contenant les tâches. Pour spécifier le groupe de CloudWatch journaux, remplacez les mêmes valeurs. Vous pouvez également modifier l'`Resource`instruction pour cibler des groupes de journaux spécifiques. Pour plus d'informations sur l'utilisation de `SourceArn` et`SourceAccount`, consultez la section [Clés de condition globales](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) dans le *guide de l'utilisateur IAM*.
Pour appliquer la stratégie, enregistrez cette instruction de stratégie dans un fichier sur votre ordinateur local. Exécutez ensuite la AWS CLI commande suivante pour appliquer la politique de ressources. Pour utiliser cet exemple de commande, `full-path-to-policy-file` remplacez-le par le chemin du fichier contenant votre déclaration de politique.
```
aws logs put-resource-policy --policy-name trust-datasync --policy-document file://full-path-to-policy-file
```
**Note**
Exécutez cette commande en utilisant la même commande Compte AWS et en utilisant l' Région AWS endroit où vous avez activé votre DataSync agent.
Pour plus d'informations, consultez le [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).
------
## Configuration de la journalisation pour votre DataSync tâche
Nous vous recommandons de configurer au moins un certain niveau de journalisation pour votre DataSync tâche.
**Avant de commencer**
DataSync nécessite une autorisation pour télécharger des journaux dans un groupe de CloudWatch journaux. Pour de plus amples informations, veuillez consulter [DataSync Autoriser le téléchargement de journaux dans un groupe de CloudWatch journaux](#cloudwatchlogs).
### Utilisation de la DataSync console
Les instructions suivantes décrivent comment configurer la CloudWatch journalisation lors de la création d'une tâche. Vous pouvez également configurer la journalisation lorsque vous modifiez une tâche.
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Tâches**, puis choisissez **Créer une tâche**.
1. Configurez les emplacements source et de destination de votre tâche.
Pour de plus amples informations, consultez [Où puis-je transférer mes données AWS DataSync ?](working-with-locations.md).
1. Sur la page **Configurer les paramètres**, choisissez un [mode de tâche](choosing-task-mode.md) et toute autre option.
Certaines des options suivantes pourraient vous intéresser :
+ Spécifiez les données à transférer à l'aide d'un [manifeste](transferring-with-manifest.md) ou de [filtres](filtering.md).
+ Configurez le mode de [gestion des métadonnées des fichiers](configure-metadata.md) et de [vérification de l'intégrité des données](configure-data-verification-options.md).
1. Pour le **niveau du journal**, choisissez l'une des options suivantes :
+ **Enregistrez les informations de base telles que les erreurs de transfert** : publiez des journaux contenant uniquement des informations de base (telles que les erreurs de transfert).
+ **Enregistrez tous les objets et fichiers transférés** : publiez des journaux pour tous les fichiers ou objets qui DataSync transfèrent et effectuent des contrôles d'intégrité des données.
+ **Ne générez pas de journaux**
1. Procédez de l'une des manières suivantes en fonction du mode de tâche que vous utilisez pour créer ou spécifier un groupe de CloudWatch journaux :
------
#### [ Enhanced mode ]
Lorsque vous choisissez **Créer une tâche**, utilise (ou crée) DataSync automatiquement un groupe de journaux nommé`/aws/datasync`.
------
#### [ Basic mode ]
Pour le **groupe de CloudWatch journaux**, spécifiez un groupe de journaux autorisé à télécharger des journaux en effectuant l'une des opérations suivantes : DataSync
+ Choisissez **Autogenerate** pour créer automatiquement un groupe de journaux qui permet DataSync d'y télécharger des journaux.
+ Choisissez un groupe de journaux existant dans votre groupe actuel Région AWS.
Si vous choisissez un groupe de journaux existant, assurez-vous qu'il [DataSync est autorisé](#cloudwatchlogs) à télécharger des journaux dans ce groupe de journaux.
------
1. Choisissez **Créer tâche**.
Vous êtes prêt à [commencer votre tâche](run-task.md).
### En utilisant le AWS CLI
1. Copiez la `create-task` commande suivante :
```
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. Pour`--source-location-arn`, spécifiez l'Amazon Resource Name (ARN) de votre emplacement source.
1. Pour`--destination-location-arn`, spécifiez l'ARN de votre position de destination.
Si vous transférez plusieurs Régions AWS comptes, assurez-vous que l'ARN inclut l'autre région ou l'autre identifiant de compte.
1. Pour`--task-mode`, spécifiez `ENHANCED` ou`BASIC`.
1. (Recommandé) Pour`--name`, spécifiez un nom mémorisable pour votre tâche.
1. Pour`LogLevel`, spécifiez l'une des options suivantes :
+ `BASIC`— Publiez des journaux contenant uniquement des informations de base (telles que les erreurs de transfert).
+ `TRANSFER`— Publiez des journaux pour tous les fichiers ou objets qui DataSync transfèrent et vérifient l'intégrité des données.
+ `NONE`— Ne générez pas de journaux.
1. Pour -`-cloudwatch-log-group-arn`, spécifiez l'ARN d'un groupe de CloudWatch journaux.
**Important**
Si `--task-mode` c'est le cas`ENHANCED`, il n'est pas nécessaire de spécifier cette option. Pour de plus amples informations, veuillez consulter [DataSync Autoriser le téléchargement de journaux dans un groupe de CloudWatch journaux](#cloudwatchlogs).
1. Exécutez la commande `create-task`.
Si la commande aboutit, vous obtenez une réponse indiquant l'ARN de la tâche que vous avez créée. Par exemple :
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
Vous êtes prêt à [commencer votre tâche](run-task.md).
### Utilisation de l' DataSync API
Vous pouvez configurer la CloudWatch journalisation de votre tâche en utilisant le `CloudWatchLogGroupArn` paramètre avec l'une des opérations suivantes :
+ [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)
## Afficher les journaux des DataSync tâches
Lorsque vous [démarrez votre tâche](run-task.md), vous pouvez consulter les journaux d'exécution de la tâche à l'aide de la CloudWatch console ou AWS CLI (entre autres options). Pour plus d'informations, consultez le [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 fournit des journaux structurés en JSON pour les tâches en mode amélioré. Les tâches en mode de base ont des journaux non structurés. Les exemples suivants montrent comment les erreurs de vérification s'affichent dans les journaux en mode amélioré par rapport aux journaux en mode de base.
------
#### [ 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
```
------
# Journalisation des appels d' AWS DataSync API avec AWS CloudTrail
AWS DataSync est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un Service AWS utilisateur DataSync. CloudTrail capture tous les appels d'API DataSync sous forme d'événements. Les appels capturés incluent les appels provenant de la DataSync console et les appels de code aux opérations d' DataSync API.
Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris les événements pour AWS DataSync. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans **Historique des événements**. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faite AWS DataSync, l'adresse IP à partir de laquelle la demande a été faite, qui a fait la demande, quand elle a été faite et des détails supplémentaires.
Pour en savoir plus CloudTrail, consultez le [guide de AWS CloudTrail l'utilisateur](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Utilisation des DataSync informations contenues dans CloudTrail
CloudTrail est activé sur votre compte Compte AWS lorsque vous créez le compte. Lorsqu'une activité se produit dans AWS DataSync, cette activité est enregistrée dans un CloudTrail événement avec d'autres Service AWS événements dans **l'historique des événements**. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre Compte AWS. Pour plus d'informations, consultez la section [Affichage des événements avec l'historique des CloudTrail événements](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Pour un enregistrement continu des événements dans votre Compte AWS, y compris les événements pour AWS DataSync, créez un journal d'activité. Un *suivi* permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un journal d’activité dans la console, il s’applique à toutes les régions Régions AWS. Le journal enregistre les événements provenant de tous Régions AWS les utilisateurs de la même AWS partition et transmet les fichiers journaux au compartiment Amazon S3 que vous spécifiez. En outre, vous pouvez en configurer d'autres Services AWS pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour plus d’informations, consultez les ressources suivantes :
+ [Présentation de la création d’un journal de suivi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail services et intégrations pris en charge](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configuration des notifications Amazon SNS pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Réception de fichiers CloudTrail journaux de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) et [réception de fichiers CloudTrail journaux de plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Toutes les DataSync actions sont enregistrées par CloudTrail. (Pour plus d'informations, consultez la [référence de DataSync l'API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html).)
Par exemple, les appels aux `ListLocations` opérations `CreateAgent``CreateTask`, et génèrent des entrées dans les fichiers CloudTrail journaux.
Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants :
+ Si la demande a été faite avec des informations d'identification root ou Gestion des identités et des accès AWS (IAM).
+ Si la demande a été effectuée avec les informations d’identification de sécurité temporaires d’un rôle ou d’un utilisateur fédéré.
+ Si la requête a été effectuée par un autre Service AWS.
Pour plus d'informations, voir [CloudTrailuserIdentityl'élément](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) dans le *guide de AWS CloudTrail l'utilisateur.*
## Comprendre les entrées du fichier DataSync journal
Un suivi est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics. Ils n'apparaissent donc pas dans un ordre spécifique.
L'exemple suivant montre une entrée de CloudTrail journal illustrant l'`CreateTask`opération.
```
{
"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"
}
```
# Surveillance des événements à l'aide d'Amazon EventBridge
EventBridge Les événements Amazon décrivent les modifications apportées aux DataSync ressources. Vous pouvez configurer des règles pour faire correspondre ces événements et les acheminer vers un ou plusieurs flux ou fonctions cibles. Les événements sont générés sur la base du meilleur effort.
## DataSync événements de transfert
Les EventBridge événements suivants sont disponibles pour les DataSync transferts.
| **Agent state changes** |
| --- |
| Event | Description |
| En ligne | L'agent est correctement configuré et prêt à être utilisé. Il s'agit de l'état de fonctionnement normal d'un agent. |
| Hors connexion | L'agent est hors de contact avec le DataSync service depuis cinq minutes ou plus. Cela peut se produire pour plusieurs raisons. Pour de plus amples informations, consultez [Que dois-je faire si mon agent est hors ligne ?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline). |
| **Location state changes** |
| --- |
| Event | Description |
| Ajouter | DataSync est en train d'ajouter un lieu. |
| Available | L'emplacement est créé et disponible pour être utilisé. |
| **Task state changes** |
| --- |
| Event | Description |
| Available | La tâche a été créée et est prête à démarrer. |
| En cours d’exécution | La tâche est en cours et fonctionne correctement. |
| Unavailable | La tâche n'est pas configurée correctement et ne peut pas être utilisée. Cet événement peut se produire lorsqu'un agent associé à la tâche se déconnecte. |
| En file d’attente | Une autre tâche est en cours d'exécution et utilise le même agent. DataSync exécute des tâches en série (premier entré, premier sorti). |
| **Task execution state changes** |
| --- |
| Event | Description |
| Mise en file d'attente | Une autre exécution de tâche est en cours d'exécution et utilise le même DataSync agent. Pour de plus amples informations, veuillez consulter [Savoir quand votre tâche est en file d'attente](run-task.md#queue-task-execution). |
| Lancement | DataSync initialise l'exécution de la tâche. Ce statut disparaît généralement rapidement, mais peut prendre jusqu'à quelques minutes. |
| Préparation | DataSync détermine les données à transférer. Cette étape peut prendre quelques minutes ou quelques heures selon le nombre de fichiers, d'objets ou de répertoires présents dans les deux emplacements et selon la façon dont vous configurez votre tâche. La préparation peut également ne pas s'appliquer à votre tâche. Pour de plus amples informations, veuillez consulter [Comment DataSync prépare votre transfert de données](how-datasync-transfer-works.md#how-datasync-prepares). |
| Transférer | DataSync effectue le transfert de données proprement dit. |
| Vérification | DataSync effectue une vérification de l'intégrité des données à la fin du transfert. |
| Réussite | L'exécution de la tâche a réussi. |
| Annulation | L'exécution de la tâche est en cours d'annulation. |
| Erreur | L'exécution de la tâche a échoué. |
# Surveillance AWS DataSync à l'aide d'outils manuels
Vous pouvez suivre vos AWS DataSync transferts depuis la console ou depuis la ligne de commande.
## Surveillance de votre transfert à l'aide de la DataSync console
Vous pouvez surveiller votre DataSync transfert à l'aide de la console, qui fournit des indicateurs en temps réel tels que les données transférées, le débit des données et des fichiers, et la compression des données.
**Pour surveiller votre transfert à l'aide de la DataSync console**
1. Après avoir [démarré votre DataSync tâche](run-task.md#starting-task), choisissez **Voir les détails de l'exécution**.
1. Consultez les statistiques relatives à votre transfert.
## Surveillez votre transfert à l'aide du AWS CLI
Vous pouvez contrôler votre DataSync transfert en utilisant le AWS Command Line Interface (AWS CLI).
Copiez la `describe-task-execution` commande suivante. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
aws datasync describe-task-execution \
--task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task-execution-id'
```
Cette commande renvoie des informations sur une exécution de tâche, similaires à celles indiquées ci-après.
```
{
"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"
}
}
```
+ Si l'exécution de la tâche est réussie, la valeur du **Statut** passe à **SUCCESS (RÉUSSITE)**. Pour plus d'informations sur la signification des éléments de réponse, consultez[DescribeTaskExecution](API_DescribeTaskExecution.md).
+ Si l'exécution de la tâche échoue, le résultat envoie des codes d'erreur qui peuvent vous aider à résoudre les problèmes. Pour plus d'informations sur les codes d'erreur, consultez[TaskExecutionResultDetail](API_TaskExecutionResultDetail.md).
## Surveillance de votre transfert à l'aide de l'`watch`utilitaire
Pour suivre la progression de votre tâche en temps réel à partir de la ligne de commande, vous pouvez utiliser l'`watch`utilitaire Unix standard. Les valeurs de durée d'exécution des tâches sont mesurées en millisecondes.
L'`watch`utilitaire ne reconnaît pas l' DataSync alias. L'exemple suivant montre comment invoquer directement la CLI. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
# 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'"
```