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.
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.
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 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 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 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é 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.
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 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, 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 destination.
-
DataSync ignore un objet de votre source qui utilise une classe de stockage d'archivage 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 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, 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é, 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 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, tels que TransferDuration etVerifyDuration, 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 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" }] } - 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.txtraison d'un problème d' AWS KMS autorisation. (Si une erreur de ce type s'affiche, consultezAccès aux compartiments S3 à l'aide du chiffrement côté serveur.){ "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" }] }
Limites
-
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.
