Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Überwachen Sie Ihre Datenübertragungen mit Aufgabenberichten *Aufgabenberichte* enthalten detaillierte Informationen darüber, welche AWS DataSync Versuche während der Ausführung einer Aufgabe übertragen, übersprungen, überprüft und gelöscht werden. Weitere Informationen finden Sie unter [Wie werden Dateien, Objekte und Verzeichnisse DataSync übertragen](how-datasync-transfer-works.md#transferring-files). Aufgabenberichte werden im JSON-Format generiert. Sie können den Detaillierungsgrad Ihrer Berichte anpassen: + [Aufgabenberichte, die nur zusammenfassend](#task-report-types-summary) sind, enthalten die erforderlichen Informationen zur Ausführung Ihrer Aufgabe, z. B. wie viele Dateien übertragen wurden und ob die Datenintegrität dieser Dateien überprüft werden DataSync konnte. + [Standardmäßige Aufgabenberichte](#task-report-types-standard) enthalten eine Zusammenfassung sowie detaillierte Berichte, in denen alle Dateien, Objekte oder Ordner aufgeführt sind, DataSync die übertragen, übersprungen, überprüft und gelöscht werden sollen. Bei einem Standardaufgabenbericht können Sie auch die [Berichtsebene](#task-report-level) so festlegen, dass nur die Fehler oder die Erfolge und Fehler der Aufgabenausführung angezeigt werden. ## Anwendungsfälle Im Folgenden finden Sie einige Situationen, in denen Aufgabenberichte Ihnen helfen können, Ihre Datenübertragungen zu überwachen und zu prüfen: + Identifizieren Sie bei der Migration von Millionen von Dateien schnell Dateien, bei denen DataSync Probleme bei der Übertragung auftreten. + Überprüfen Sie chain-of-custody die Prozesse für Ihre Dateien. ## Aufgabenberichte nur zusammenfassend Ein Bericht, der nur eine Zusammenfassung der Ausführung einer Aufgabe darstellt, enthält die folgenden Details: + AWS-Konto Derjenige, der die Aufgabenausführung ausgeführt hat + Die Quell- und Zielorte + Die Gesamtzahl der Dateien, Objekte und Ordner, die übersprungen, übertragen, verifiziert und gelöscht wurden + Die Gesamtzahl der übertragenen Byte (logisch und physisch) + Wenn die Ausführung der Aufgabe abgeschlossen oder abgebrochen wurde oder ein Fehler aufgetreten ist + Die Start- und Endzeit (einschließlich der Gesamtzeit der Übertragung) + Die Einstellungen der Aufgabe (wie Bandbreitenbeschränkungen, Überprüfung der Datenintegrität und andere Optionen für Ihre DataSync Übertragung) ## Standardberichte für Aufgaben Ein Standard-Aufgabenbericht enthält eine [Zusammenfassung](#task-report-types-summary) Ihrer Aufgabenausführung sowie detaillierte Berichte darüber, welche DataSync Versuche zu übertragen, zu überspringen, zu überprüfen und zu löschen sind. **Topics** + [Berichtsebene](#task-report-level) + [Übertragene Berichte](#task-report-types-transferred) + [Übersprungene Berichte](#task-report-types-skipped) + [Verifizierte Berichte](#task-report-types-verified) + [Gelöschte Berichte](#task-report-types-deleted) ### Berichtsebene Bei Standardaufgabenberichten können Sie eine der folgenden Berichtsebenen wählen: + Nur Fehler + Erfolge und Fehler (im Wesentlichen eine Liste von allem, was während der Ausführung Ihrer Aufgabe passiert ist) Möglicherweise möchten Sie beispielsweise sehen, welche Dateien während Ihrer Übertragung erfolgreich DataSync übersprungen wurden und welche nicht. Dateien, die erfolgreich DataSync übersprungen wurden, könnten Dateien sein, die Sie bewusst ausschließen DataSync möchten, weil sie bereits an Ihrem Zielort vorhanden sind. Ein übersprungener Fehler kann jedoch beispielsweise darauf hinweisen, dass Sie DataSync nicht über die erforderlichen Berechtigungen zum Lesen einer Datei verfügen. ### Übertragene Berichte Eine Liste von Dateien, Objekten und Verzeichnissen, die während der Ausführung Ihrer Aufgabe DataSync versucht haben, zu übertragen. Ein übertragener Bericht enthält die folgenden Details: + Die Pfade für die übertragenen Daten + Was wurde übertragen (Inhalt, Metadaten oder beides) + Die Metadaten, zu denen der Datentyp, die Inhaltsgröße (nur Objekte und Dateien) und mehr gehören + Der Zeitpunkt, zu dem ein Element übertragen wurde + Die Objektversion (wenn das Ziel ein Amazon S3 S3-Bucket ist, für den Versionierung aktiviert ist) + Wenn im Ziel etwas überschrieben wurde + Ob ein Artikel erfolgreich übertragen wurde **Anmerkung** Wenn Sie Daten zwischen S3-Buckets verschieben, kann das Präfix, das Sie an Ihrem [Quellstandort](create-s3-location.md) angeben, in Ihrem Bericht (oder in CloudWatch Amazon-Protokollen) angezeigt werden, auch wenn dieses Präfix nicht als Objekt an Ihrem Zielort existiert. (In der DataSync Konsole stellen Sie möglicherweise auch fest, dass dieses Präfix als übersprungene oder verifizierte Daten angezeigt wird.) ### Übersprungene Berichte Eine Liste von Dateien, Objekten und Verzeichnissen, die in Ihrem Quellverzeichnis DataSync gefunden wurden, aber nicht versucht wurde, sie zu übertragen. Warum Daten DataSync übersprungen werden, kann von verschiedenen Faktoren abhängen, z. B. davon, wie Sie Ihre Aufgabe konfigurieren und welche Speichersystemberechtigungen Sie haben. Hier sind einige Beispiele: + Es gibt eine Datei, die an Ihren Quell- und Zielorten vorhanden ist. Die Datei in der Quelle wurde seit der letzten Ausführung der Aufgabe nicht geändert. Da Sie [nur Daten übertragen, die sich geändert haben](configure-metadata.md#task-option-transfer-mode), wird diese Datei DataSync nicht übertragen, wenn Sie Ihre Aufgabe das nächste Mal ausführen. + Ein Objekt, das an beiden Speicherorten vorhanden ist, ändert sich in Ihrer Quelle. Wenn Sie Ihre Aufgabe ausführen, wird dieses Objekt in Ihrem Ziel DataSync übersprungen, da Ihre Aufgabe keine [Daten im Ziel überschreibt](configure-metadata.md#task-option-file-object-handling). + DataSync überspringt ein Objekt in Ihrer Quelle, das eine [Archivspeicherklasse](create-s3-location.md#using-storage-classes) verwendet und nicht wiederhergestellt wird. Sie müssen ein archiviertes Objekt wiederherstellen, um DataSync es lesen zu können. + DataSync überspringt eine Datei, ein Objekt oder ein Verzeichnis an Ihrem Quellspeicherort, weil es nicht gelesen werden kann. Wenn dies passiert und nicht zu erwarten ist, überprüfen Sie die Zugriffsberechtigungen Ihres Speichers und stellen Sie sicher, dass gelesen DataSync werden kann, was übersprungen wurde. Ein übersprungener Bericht enthält die folgenden Details: + Die Pfade für übersprungene Daten + Der Zeitpunkt, zu dem ein Element übersprungen wurde + Der Grund, warum es übersprungen wurde + Ob ein Artikel erfolgreich übersprungen wurde **Anmerkung** Übersprungene Berichte können umfangreich sein, wenn sie Erfolge und Fehler enthalten, Sie Ihre Aufgabe so konfigurieren, [dass nur die Daten übertragen werden, die sich geändert haben](configure-metadata.md), und Quelldaten bereits im Ziel vorhanden sind. ### Verifizierte Berichte Eine Liste von Dateien, Objekten und Verzeichnissen, die während der Ausführung Ihrer Aufgabe DataSync versucht haben, deren Integrität zu überprüfen. Ein Bericht mit verifizierten Daten enthält die folgenden Details: + Die Pfade für verifizierte Daten + Der Zeitpunkt, zu dem ein Artikel verifiziert wurde + Der Grund für den Bestätigungsfehler (falls vorhanden) + Die Quell- und SHA256 Zielprüfsummen (nur Dateien) + Ob ein Artikel erfolgreich verifiziert wurde Beachten Sie Folgendes zu verifizierten Berichten: + Wenn Sie Ihre Aufgabe so konfigurieren, dass [nur übertragene Daten überprüft](configure-data-verification-options.md) werden, DataSync werden in manchen Situationen Verzeichnisse oder Dateien oder Objekte, deren Übertragung fehlschlägt, nicht überprüft. In beiden Fällen enthält dieser Bericht DataSync keine unbestätigten Daten. + Wenn Sie den [erweiterten Modus](choosing-task-mode.md) verwenden, kann die Überprüfung länger als gewöhnlich dauern, wenn Sie große Objekte übertragen. ### Gelöschte Berichte Eine Liste von Dateien, Verzeichnissen und Objekten, die während der Ausführung Ihrer Aufgabe gelöscht wurden. DataSync generiert diesen Bericht nur, wenn Sie [Ihre Aufgabe so konfigurieren](configure-metadata.md), dass Daten am Zielort gelöscht werden, die sich nicht in der Quelle befinden. Ein Bericht über gelöschte Daten enthält die folgenden Details: + Die Pfade für gelöschte Daten + Ob ein Element erfolgreich gelöscht wurde + Der Zeitpunkt, zu dem ein Element gelöscht wurde ## Beispiele für Aufgabenberichte Der Detaillierungsgrad Ihres Aufgabenberichts liegt bei Ihnen. Hier sind einige Beispiele für Berichte über übertragene Daten mit der folgenden Konfiguration: + **Berichtstyp** — Standard + **Berichtsebene** — Erfolge und Fehler **Anmerkung** Berichte verwenden den ISO-8601-Standard für das Zeitstempelformat. Die Zeiten sind in UTC angegeben und werden in Nanosekunden gemessen. Dieses Verhalten unterscheidet sich von der Art und Weise, wie einige andere Messwerte für Aufgabenberichte gemessen werden. Beispielsweise werden [Details zur Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskExecutionResultDetail.html), wie `TransferDuration` und`VerifyDuration`, in Millisekunden gemessen. Aufgabenberichte im erweiterten Modus verwenden ein etwas anderes Schema als Aufgabenberichte im Basismodus. Anhand der folgenden Beispiele können Sie herausfinden, was Sie je nach verwendetem [Aufgabenmodus](choosing-task-mode.md) von Ihren Berichten erwarten können. **Beispiel für übertragene Datenberichte mit Erfolgsstatus** Die folgenden Berichte zeigen erfolgreiche Übertragungen für ein Objekt mit dem Namen`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" }] } ``` **Beispiel für übertragene Datenberichte mit Fehlerstatus** Die folgenden Berichte enthalten Beispiele dafür, wann ein benanntes Objekt nicht übertragen werden DataSync kann`object1.txt`. Dieser Bericht zeigt, dass `object1.txt` aufgrund eines AWS KMS Berechtigungsproblems nicht auf ein Objekt mit dem Namen zugegriffen werden DataSync kann. (Wenn Sie eine solche Fehlermeldung erhalten, finden Sie weitere Informationen unter[Zugriff auf S3-Buckets mithilfe serverseitiger Verschlüsselung](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" }] } ``` Dieser Bericht zeigt, dass ein Objekt mit dem Namen aufgrund eines S3-Bucket-Berechtigungsproblems `object1.txt` nicht übertragen wurde. (Wenn Sie eine solche Fehlermeldung erhalten, finden Sie weitere Informationen unter[Bereitstellung des DataSync Zugriffs auf S3-Buckets](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 }] } ``` ## Einschränkungen + Einzelne Aufgabenberichte dürfen 5 MB nicht überschreiten. Wenn Sie eine große Anzahl von Dateien kopieren, ist Ihr Aufgabenbericht möglicherweise in mehrere Berichte aufgeteilt. + Es gibt Situationen, in denen das Erstellen von Aufgabenberichten die Leistung Ihrer Datenübertragung beeinträchtigen kann. Möglicherweise stellen Sie dies fest, wenn Ihre Netzwerkverbindung eine hohe Latenz aufweist und die Dateien, die Sie übertragen, klein sind oder Sie nur Metadatenänderungen kopieren. # Erstellen Sie Ihre DataSync Aufgabenberichte AWS DataSync Aufgabenberichte können nur eine Zusammenfassung Ihrer Aufgabenausführung oder eine Reihe detaillierter Berichte darüber sein, welche DataSync Versuche zu übertragen, zu überspringen, zu überprüfen und zu löschen sind. ## Voraussetzungen Bevor Sie einen Aufgabenbericht erstellen können, müssen Sie wie folgt vorgehen. **Topics** + [Erstellen Sie einen S3-Bucket für Ihre Aufgabenberichte](#setting-up-task-report-create-bucket) + [Erlauben DataSync Sie das Hochladen von Aufgabenberichten in Ihren S3-Bucket](#task-report-access) ### Erstellen Sie einen S3-Bucket für Ihre Aufgabenberichte Falls Sie noch keinen haben, [erstellen Sie einen S3-Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html), in den Sie Ihren Aufgabenbericht hochladen DataSync können. Berichte werden in der Speicherklasse S3 Standard gespeichert. Wir empfehlen Folgendes für diesen Bucket: + Wenn Sie planen, Daten in einen S3-Bucket zu übertragen, verwenden Sie nicht denselben Bucket für Ihren Aufgabenbericht, wenn Sie [die Option **Gelöschte Dateien behalten** deaktivieren](configure-metadata.md). Andernfalls DataSync werden bei jeder Ausführung einer Aufgabe alle vorherigen Aufgabenberichte gelöscht, da diese Berichte an Ihrem Quellspeicherort nicht vorhanden sind. + Um eine komplexe Einrichtung von Zugriffsberechtigungen zu vermeiden, stellen Sie sicher, dass sich Ihr Aufgabenbericht-Bucket in derselben AWS-Konto Region wie Ihre DataSync Übertragungsaufgabe befindet. ### Erlauben DataSync Sie das Hochladen von Aufgabenberichten in Ihren S3-Bucket Sie müssen eine AWS Identity and Access Management (IAM-) Rolle konfigurieren, die es ermöglicht DataSync , einen Aufgabenbericht in Ihren S3-Bucket hochzuladen. In der DataSync Konsole können Sie eine IAM-Rolle erstellen, die in den meisten Fällen automatisch die Berechtigungen zum Hochladen eines Aufgabenberichts in Ihren Bucket beinhaltet. Denken Sie daran, dass diese automatisch generierte Rolle unter dem Gesichtspunkt der geringsten Rechte möglicherweise nicht Ihren Anforderungen entspricht. Diese Rolle funktioniert auch nicht, wenn Ihr Bucket mit einem vom Kunden verwalteten AWS Key Management Service (AWS KMS) Schlüssel (SSE-KMS) verschlüsselt ist. In diesen Fällen können Sie die Rolle manuell erstellen, sofern die Rolle mindestens die folgenden Funktionen erfüllt: + [Beugt dem dienstübergreifenden Problem des verwirrten Stellvertreters](https://docs.aws.amazon.com/datasync/latest/userguide/cross-service-confused-deputy-prevention.html) in der vertrauenswürdigen Entität der Rolle vor. Das folgende vollständige Beispiel zeigt, wie Sie die Kontextschlüssel `aws:SourceArn` und die `aws:SourceAccount` globale Bedingung verwenden können, um das Problem mit DataSync dem verwirrten Stellvertreter zu verhindern. ------ #### [ 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:*" } } } ] } ``` ------ + Ermöglicht DataSync das Hochladen eines Aufgabenberichts in Ihren S3-Bucket. Das folgende Beispiel tut dies, indem die `s3:PutObject` Aktion nur für ein bestimmtes Präfix (`reports/`) in Ihren Bucket aufgenommen wird. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Action": [ "s3:PutObject" ], "Effect": "Allow", "Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*" }] } ``` ------ + Wenn Ihr S3-Bucket mit einem vom Kunden verwalteten SSE-KMS-Schlüssel verschlüsselt ist, muss die [Richtlinie des Schlüssels](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) die IAM-Rolle enthalten, die für den Zugriff auf den Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugriff auf S3-Buckets mithilfe serverseitiger Verschlüsselung](create-s3-location.md#create-s3-location-encryption). ## Einen nur zusammenfassenden Aufgabenbericht erstellen Sie können einen Aufgabenbericht konfigurieren, der [nur dann eine Zusammenfassung](task-reports.md#task-report-types-summary) enthält, wenn Sie Ihre DataSync Aufgabe erstellen, Ihre Aufgabe starten oder Ihre Aufgabe aktualisieren. Die folgenden Schritte zeigen, wie Sie beim Erstellen einer Aufgabe einen nur zusammenfassenden Aufgabenbericht konfigurieren. ### Verwenden der DataSync Konsole 1. Öffnen Sie die AWS DataSync Konsole unter [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. Erweitern Sie im linken Navigationsbereich die Option **Datenübertragung**, wählen Sie dann **Aufgaben** und anschließend **Aufgabe erstellen** aus. 1. Konfigurieren Sie die Quell- und Zielorte Ihrer Aufgabe. Weitere Informationen finden Sie unter [Mit wem kann ich meine Daten übertragen AWS DataSync?](working-with-locations.md). 1. Scrollen Sie nach unten zum Abschnitt **Aufgabenbericht**. Wählen Sie als **Berichtstyp** die Option **Nur Zusammenfassung** aus. 1. Wählen Sie für den **S3-Bucket für Berichte** einen S3-Bucket aus, in DataSync den Sie Ihren Aufgabenbericht hochladen möchten. **Tipp** Wenn Sie planen, Daten in einen S3-Bucket zu übertragen, verwenden Sie nicht denselben Bucket für Ihren Aufgabenbericht, wenn Sie [die Option **Gelöschte Dateien behalten** deaktivieren](configure-metadata.md). Andernfalls DataSync werden bei jeder Ausführung einer Aufgabe alle vorherigen Aufgabenberichte gelöscht, da diese Berichte an Ihrem Quellspeicherort nicht vorhanden sind. 1. Geben Sie **unter Ordner** ein Präfix ein, das für Ihren Aufgabenbericht verwendet werden soll, wenn der Bericht in Ihren S3-Bucket DataSync hochgeladen wird (z. B.**reports/**). Achten Sie darauf, das entsprechende Trennzeichen am Ende Ihres Präfixes einzufügen. Dieses Zeichen ist normalerweise ein Schrägstrich (). `/` Weitere Informationen finden Sie unter [Objekte mithilfe von Präfixen organisieren](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) im *Amazon S3 S3-Benutzerhandbuch*. 1. Führen Sie für **IAM role (IAM-Rolle)** einen der folgenden Schritte aus: + Wählen Sie **Autogenerate**, damit DataSync automatisch eine IAM-Rolle mit den Berechtigungen erstellt wird, die für den Zugriff auf den S3-Bucket erforderlich sind. Wenn Sie DataSync zuvor eine IAM-Rolle für diesen S3-Bucket erstellt haben, wird diese Rolle standardmäßig ausgewählt. + Wählen Sie eine benutzerdefinierte IAM-Rolle aus, die Sie erstellt haben. In einigen Fällen müssen Sie die Rolle möglicherweise selbst erstellen. Weitere Informationen finden Sie unter [Erlauben DataSync Sie das Hochladen von Aufgabenberichten in Ihren S3-Bucket](#task-report-access). **Wichtig** Wenn Ihr S3-Bucket mit einem vom Kunden verwalteten SSE-KMS-Schlüssel verschlüsselt ist, muss die Richtlinie des Schlüssels die IAM-Rolle enthalten, die für den Zugriff auf den Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugriff auf S3-Buckets mithilfe serverseitiger Verschlüsselung](create-s3-location.md#create-s3-location-encryption). 1. Beenden Sie die Erstellung Ihrer Aufgabe und [starten Sie dann die Aufgabe, um mit der](run-task.md) Übertragung Ihrer Daten zu beginnen. Wenn Ihre Übertragung abgeschlossen ist, können Sie [Ihren Aufgabenbericht einsehen](task-report-viewing.md). ### Mit dem AWS CLI 1. Kopieren Sie den folgenden Befehl `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. Geben Sie für den `--source-location-arn` Parameter den Amazon-Ressourcennamen (ARN) des Quellstandorts in Ihrer Übertragung an. `us-east-1`Ersetzen Sie durch die entsprechende Nummer AWS-Region, `123456789012` ersetzen Sie sie durch die entsprechende AWS-Konto Nummer und `12345678abcdefgh` ersetzen Sie sie durch die entsprechende Quellstandort-ID. 1. Geben Sie für den `--destination-location-arn` Parameter den ARN des Zielorts in Ihrer Übertragung an. `us-east-1`Ersetzen Sie durch die entsprechende Nummer AWS-Region, `123456789012` ersetzen Sie sie durch die entsprechende AWS-Konto Nummer und `abcdefgh12345678` ersetzen Sie sie durch die entsprechende Zielstandort-ID. 1. Gehen Sie für den `--task-report-config` Parameter wie folgt vor: + `Subdirectory`— `reports/` Ersetzen Sie es durch das Präfix in Ihrem S3-Bucket, in DataSync den Sie Ihre Aufgabenberichte hochladen möchten. Achten Sie darauf, das entsprechende Trennzeichen am Ende Ihres Präfixes einzufügen. Dieses Zeichen ist normalerweise ein Schrägstrich (). `/` Weitere Informationen finden Sie unter [Objekte mithilfe von Präfixen organisieren](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) im *Amazon S3 S3-Benutzerhandbuch*. + `S3BucketArn`— Geben Sie den ARN des S3-Buckets an, in den Sie Ihren Aufgabenbericht hochladen möchten. **Tipp** Wenn Sie planen, Daten in einen S3-Bucket zu übertragen, verwenden Sie nicht denselben Bucket für Ihren Aufgabenbericht, wenn Sie [die Option **Gelöschte Dateien behalten** deaktivieren](configure-metadata.md). Andernfalls DataSync werden bei jeder Ausführung einer Aufgabe alle vorherigen Aufgabenberichte gelöscht, da diese Berichte an Ihrem Quellspeicherort nicht vorhanden sind. + `BucketAccessRoleArn`— Geben Sie die IAM-Rolle DataSync an, mit der Sie einen Aufgabenbericht in Ihren S3-Bucket hochladen können. Weitere Informationen finden Sie unter [Erlauben DataSync Sie das Hochladen von Aufgabenberichten in Ihren S3-Bucket](#task-report-access). **Wichtig** Wenn Ihr S3-Bucket mit einem vom Kunden verwalteten SSE-KMS-Schlüssel verschlüsselt ist, muss die Richtlinie des Schlüssels die IAM-Rolle enthalten, die für den Zugriff auf den Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugriff auf S3-Buckets mithilfe serverseitiger Verschlüsselung](create-s3-location.md#create-s3-location-encryption). + `OutputType`— Geben Sie an. `SUMMARY_ONLY` Weitere Informationen finden Sie unter [Aufgabenberichte nur zusammenfassend](task-reports.md#task-report-types-summary). 1. Führen Sie den `create-task` Befehl aus, um Ihre Aufgabe zu erstellen. Sie erhalten eine Antwort wie die folgende, die Ihnen den ARN der Aufgabe zeigt, die Sie erstellt haben. Sie benötigen diesen ARN, um den `start-task-execution` Befehl auszuführen. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Kopieren Sie den folgenden `start-task-execution` Befehl. ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Geben Sie für den `--task-arn` Parameter den ARN der Aufgabe an, die Sie starten. Verwenden Sie den ARN, den Sie beim Ausführen des `create-task` Befehls erhalten haben. 1. Führen Sie den Befehl `start-task-execution` aus. Wenn Ihre Übertragung abgeschlossen ist, können Sie [Ihren Aufgabenbericht einsehen](task-report-viewing.md). ## Einen Standard-Aufgabenbericht erstellen Sie können einen [Standard-Aufgabenbericht](task-reports.md#task-report-types-standard) konfigurieren, wenn Sie Ihre DataSync Aufgabe erstellen, Ihre Aufgabe starten oder Ihre Aufgabe aktualisieren. Die folgenden Schritte zeigen, wie Sie beim Erstellen einer Aufgabe einen Standard-Aufgabenbericht konfigurieren. ### Verwenden der DataSync Konsole 1. Öffnen Sie die AWS DataSync Konsole unter [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. Erweitern Sie im linken Navigationsbereich die Option **Datenübertragung**, wählen Sie dann **Aufgaben** und anschließend **Aufgabe erstellen** aus. 1. Konfigurieren Sie die Quell- und Zielorte Ihrer Aufgabe. Weitere Informationen finden Sie unter [Mit wem kann ich meine Daten übertragen AWS DataSync?](working-with-locations.md). 1. Scrollen Sie nach unten zum Abschnitt **Aufgabenbericht**. Wählen Sie als **Berichtstyp** die Option **Standardbericht** aus. 1. Wählen Sie für **Berichtsebene** eine der folgenden Optionen aus: + **Nur Fehler** — Ihr Aufgabenbericht enthält nur Probleme mit dem, was DataSync übertragen, übersprungen, verifiziert und gelöscht werden sollte. + **Erfolge und Fehler** — Ihr Aufgabenbericht beinhaltet, was DataSync erfolgreich übertragen, übersprungen, verifiziert und gelöscht wurde und was nicht. + **Benutzerdefiniert** — Hier können Sie wählen, ob Sie nur Fehler oder Erfolge und Fehler für bestimmte Aspekte Ihres Aufgabenberichts sehen möchten. Sie können beispielsweise **Erfolge und Fehler** für die Liste der übertragenen Dateien auswählen, aber **nur Fehler** für den Rest des Berichts. 1. Wenn Sie in einen S3-Bucket übertragen, der Objektversionierung verwendet, lassen Sie die Option **Amazon S3 S3-Objektversionen einbeziehen** aktiviert, wenn Ihr Bericht die neue Version für jedes übertragene Objekt enthalten soll. 1. Wählen Sie für den **S3-Bucket für Berichte** einen S3-Bucket aus, in den Sie Ihren Aufgabenbericht hochladen DataSync möchten. **Tipp** Wenn Sie planen, Daten in einen S3-Bucket zu übertragen, verwenden Sie nicht denselben Bucket für Ihren Aufgabenbericht, wenn Sie [die Option **Gelöschte Dateien behalten** deaktivieren](configure-metadata.md). Andernfalls DataSync werden bei jeder Ausführung einer Aufgabe alle vorherigen Aufgabenberichte gelöscht, da diese Berichte an Ihrem Quellspeicherort nicht vorhanden sind. 1. Geben Sie **unter Ordner** ein Präfix ein, das für Ihren Aufgabenbericht verwendet werden soll, wenn der Bericht in Ihren S3-Bucket DataSync hochgeladen wird (z. B.**reports/**). Achten Sie darauf, das entsprechende Trennzeichen am Ende Ihres Präfixes einzufügen. Dieses Zeichen ist normalerweise ein Schrägstrich (). `/` Weitere Informationen finden Sie unter [Objekte mithilfe von Präfixen organisieren](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) im *Amazon S3 S3-Benutzerhandbuch*. 1. Führen Sie für **IAM role (IAM-Rolle)** einen der folgenden Schritte aus: + Wählen Sie **Autogenerate**, damit DataSync automatisch eine IAM-Rolle mit den Berechtigungen erstellt wird, die für den Zugriff auf den S3-Bucket erforderlich sind. Wenn Sie DataSync zuvor eine IAM-Rolle für diesen S3-Bucket erstellt haben, wird diese Rolle standardmäßig ausgewählt. + Wählen Sie eine benutzerdefinierte IAM-Rolle aus, die Sie erstellt haben. In einigen Fällen müssen Sie die Rolle möglicherweise selbst erstellen. Weitere Informationen finden Sie unter [Erlauben DataSync Sie das Hochladen von Aufgabenberichten in Ihren S3-Bucket](#task-report-access). **Wichtig** Wenn Ihr S3-Bucket mit einem vom Kunden verwalteten SSE-KMS-Schlüssel verschlüsselt ist, muss die Richtlinie des Schlüssels die IAM-Rolle enthalten, die für den Zugriff auf den Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugriff auf S3-Buckets mithilfe serverseitiger Verschlüsselung](create-s3-location.md#create-s3-location-encryption). 1. Beenden Sie die Erstellung Ihrer Aufgabe und [starten Sie die Aufgabe, um mit der](run-task.md) Übertragung Ihrer Daten zu beginnen. Wenn Ihre Übertragung abgeschlossen ist, können Sie [Ihren Aufgabenbericht einsehen](task-report-viewing.md). ### Mit dem AWS CLI 1. Kopieren Sie den folgenden `create-task` Befehl: ``` 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. Geben Sie für den `--source-location-arn` Parameter den ARN des Quellspeicherorts in Ihrer Übertragung an. `us-east-1`Ersetzen Sie durch die entsprechende Nummer AWS-Region, `123456789012` ersetzen Sie sie durch die entsprechende AWS-Konto Nummer und `12345678abcdefgh` ersetzen Sie sie durch die entsprechende Quellstandort-ID. 1. Geben Sie für den `--destination-location-arn` Parameter den ARN des Zielorts in Ihrer Übertragung an. `us-east-1`Ersetzen Sie durch die entsprechende Nummer AWS-Region, `123456789012` ersetzen Sie sie durch die entsprechende AWS-Konto Nummer und `abcdefgh12345678` ersetzen Sie sie durch die entsprechende Zielstandort-ID. 1. Gehen Sie für den `--task-report-config` Parameter wie folgt vor: + `Subdirectory`— `reports/` Ersetzen Sie es durch das Präfix in Ihrem S3-Bucket, in DataSync den Sie Ihre Aufgabenberichte hochladen möchten. Achten Sie darauf, das entsprechende Trennzeichen am Ende Ihres Präfixes einzufügen. Dieses Zeichen ist normalerweise ein Schrägstrich (). `/` Weitere Informationen finden Sie unter [Objekte mithilfe von Präfixen organisieren](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) im *Amazon S3 S3-Benutzerhandbuch*. + `S3BucketArn`— Geben Sie den ARN des S3-Buckets an, in den Sie Ihren Aufgabenbericht hochladen möchten. **Tipp** Wenn Sie planen, Daten in einen S3-Bucket zu übertragen, verwenden Sie nicht denselben Bucket für Ihren Aufgabenbericht, wenn Sie [die Option **Gelöschte Dateien behalten** deaktivieren](configure-metadata.md). Andernfalls DataSync werden bei jeder Ausführung einer Aufgabe alle vorherigen Aufgabenberichte gelöscht, da diese Berichte an Ihrem Quellspeicherort nicht vorhanden sind. + `BucketAccessRoleArn`— Geben Sie die IAM-Rolle DataSync an, mit der Sie einen Aufgabenbericht in Ihren S3-Bucket hochladen können. Weitere Informationen finden Sie unter [Erlauben DataSync Sie das Hochladen von Aufgabenberichten in Ihren S3-Bucket](#task-report-access). **Wichtig** Wenn Ihr S3-Bucket mit einem vom Kunden verwalteten SSE-KMS-Schlüssel verschlüsselt ist, muss die Richtlinie des Schlüssels die IAM-Rolle enthalten, die für den Zugriff auf den Bucket DataSync verwendet wird. Weitere Informationen finden Sie unter [Zugriff auf S3-Buckets mithilfe serverseitiger Verschlüsselung](create-s3-location.md#create-s3-location-encryption). + `OutputType`— Geben Sie den Bericht an. `STANDARD` Weitere Informationen finden Sie unter [Standardberichte für Aufgaben](task-reports.md#task-report-types-standard) Typen von Aufgabenberichten. + (Optional) `ReportLevel` — Geben Sie an, ob Sie `ERRORS_ONLY` dies möchten (Standard) oder `SUCCESSES_AND_ERRORS` in Ihrem Bericht. + (Optional) `ObjectVersionIds` — Wenn Sie zu einem S3-Bucket wechseln, der Objektversionierung verwendet, geben Sie an, `NONE` ob Sie nicht die neue Version für jedes übertragene Objekt in den Bericht aufnehmen möchten. Diese Option wird standardmäßig auf `INCLUDE` festgelegt. + (Optional) `Overrides` — Passen Sie einen bestimmten Aspekt Ihres Berichts an. `ReportLevel` Vielleicht möchten Sie `SUCCESSES_AND_ERRORS` für die Liste der DataSync gelöschten Dateien an Ihrem Zielort suchen, aber Sie möchten `ERRORS_ONLY` für alles andere. In diesem Beispiel würden Sie dem `--task-report-config` Parameter die folgende `Overrides` Option hinzufügen: ``` "Overrides":{ "Deleted":{ "ReportLevel":"SUCCESSES_AND_ERRORS" } } ``` Wenn Sie es nicht verwenden`Overrides`, verwendet Ihr gesamter Bericht `ReportLevel` das, was Sie angeben. 1. Führen Sie den `create-task` Befehl aus, um Ihre Aufgabe zu erstellen. Sie erhalten eine Antwort wie die folgende, die Ihnen den ARN der Aufgabe zeigt, die Sie erstellt haben. Sie benötigen diesen ARN, um den `start-task-execution` Befehl auszuführen. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Kopieren Sie den folgenden `start-task-execution` Befehl. ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Geben Sie für den `--task-arn` Parameter den ARN der Aufgabe an, die Sie gerade ausführen. Verwenden Sie den ARN, den Sie beim Ausführen des `create-task` Befehls erhalten haben. 1. Führen Sie den Befehl `start-task-execution` aus. Wenn Ihre Übertragung abgeschlossen ist, können Sie [Ihren Aufgabenbericht einsehen](task-report-viewing.md). # Deine DataSync Aufgabenberichte anzeigen DataSync erstellt Aufgabenberichte für jede Aufgabenausführung. Wenn Ihre Ausführung abgeschlossen ist, finden Sie die entsprechenden Aufgabenberichte in Ihrem S3-Bucket. Aufgabenberichte sind unter Präfixen organisiert, die IDs Ihre Aufgaben und deren Ausführung enthalten. Verwenden Sie diese Beispiele, um Aufgabenberichte in Ihrem S3-Bucket zu finden: + **Aufgabenbericht nur zusammenfassend** — `reports-prefix/Summary-Reports/task-id-folder/task-execution-id-folder` + **Standard-Aufgabenbericht** — `reports-prefix/Detailed-Reports/task-id-folder/task-execution-id-folder` Da Aufgabenberichte im JSON-Format vorliegen, haben Sie mehrere Möglichkeiten, Ihre Berichte anzuzeigen: + Rufen Sie einen Bericht mit [Amazon S3 Select](https://docs.aws.amazon.com/AmazonS3/latest/userguide/selecting-content-from-objects.html) auf. + Visualisieren Sie Berichte mithilfe von AWS Diensten wie AWS Glue Amazon Athena und Amazon Quick. Weitere Informationen zur Visualisierung Ihrer Aufgabenberichte finden Sie im [AWS Storage-Blog](https://aws.amazon.com/blogs/storage/derive-insights-from-aws-datasync-task-reports-using-aws-glue-amazon-athena-and-amazon-quicksight/).