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 AWS DataSync Überweisungen
Die Überwachung ist wichtig, um die Zuverlässigkeit und Leistung Ihrer AWS DataSync Transferaktivitäten aufrechtzuerhalten. Wir empfehlen Ihnen, Überwachungsdaten zu sammeln, damit Sie etwaige Fehler leichter debuggen können. Bevor Sie mit der Überwachung beginnen DataSync, sollten Sie jedoch einen Überwachungsplan erstellen, der Antworten auf die folgenden Fragen enthält:
+ Was sind Ihre Ziele bei der Überwachung?
+ Welche Ressourcen werden überwacht?
+ Wie oft werden diese Ressourcen überwacht?
+ Welche Überwachungstools werden verwendet?
+ Wer soll die Überwachungsaufgaben ausführen?
+ Wer soll benachrichtigt werden, wenn Fehler auftreten?
AWS stellt verschiedene Dienste und Tools für die Überwachung bereit DataSync. Sie können einige davon so konfigurieren, dass sie die Überwachung für Sie übernehmen, andere erfordern jedoch manuelles Eingreifen. Wir empfehlen, dass Sie die Überwachungsaufgaben möglichst automatisieren.
**Topics**
+ [
# Leistungsindikatoren für die Datenübertragung verstehen
](transfer-performance-counters.md)
+ [
# Überwachung von Datenübertragungen mit CloudWatch Amazon-Metriken
](monitor-datasync.md)
+ [
# Überwachen Sie Ihre Datenübertragungen mit Aufgabenberichten
](task-reports.md)
+ [
# Überwachung von Datenübertragungen mit Amazon CloudWatch Logs
](configure-logging.md)
+ [
# AWS DataSync API-Aufrufe protokollieren mit AWS CloudTrail
](logging-using-cloudtrail.md)
+ [
# Überwachung von Ereignissen mithilfe von Amazon EventBridge
](events.md)
+ [
# Überwachung AWS DataSync mit manuellen Tools
](monitoring-task-manually.md)
# Leistungsindikatoren für die Datenübertragung verstehen
Wenn Sie [eine Aufgabe starten](run-task.md), werden AWS DataSync Leistungsindikatoren angezeigt, anhand derer Sie die Leistung und den Fortschritt Ihrer Datenübertragung verfolgen können.
Verwenden Sie die folgenden Informationen, um zu verstehen, wofür die einzelnen Leistungsindikatoren stehen. Sie können sich diese Leistungsindikatoren in der DataSync Konsole oder in einer [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)Antwort ansehen. Einige Leistungsindikatoren sind nicht in jedem [Aufgabenmodus](choosing-task-mode.md) verfügbar.
| Konsole | `DescribeTaskExecution` | Unterstützung für den Aufgabenmodus | Description |
| --- | --- | --- | --- |
| – | `BytesWritten` | Verbessert, Basic | Die Anzahl der logischen Byte, die DataSync tatsächlich an den Zielspeicherort schreiben. |
| **Datendurchsatz** | – | Verbessert, Einfach | Die Geschwindigkeit, mit der logische Bytes an den Zielspeicherort DataSync geschrieben werden. Wenn Sie verwenden [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), hängt die Berechnung dieses Zählers von Ihrem Aufgabenmodus ab: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) |
| Übertragene Daten | `BytesTransferred` | Verbessert, Basic | Die Anzahl der Byte, die vor der Komprimierung an das Netzwerk DataSync gesendet werden (sofern eine Komprimierung möglich ist). Die Anzahl der über das Netzwerk übertragenen Byte finden Sie im Zähler für **Netzwerkdurchsatz** (in der Konsole) oder `BytesCompressed` (im [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)). |
| **Aus dem Ziel gelöscht** | `FilesDeleted` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die an Ihrem Zielort DataSync tatsächlich gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, dass [Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden:](configure-metadata.md#task-option-file-object-handling) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) |
| **Aus dem Ziel gelöscht** | `FilesDeleted`, `FoldersDeleted` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die an Ihrem Zielort DataSync tatsächlich gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, dass [Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden:](configure-metadata.md#task-option-file-object-handling) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `EstimatedBytesToTransfer` | Verbessert, Einfach | Die Anzahl der logischen Byte, die DataSync voraussichtlich in den Zielspeicherort geschrieben werden. |
| – | `EstimatedFilesToDelete` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die DataSync voraussichtlich an Ihrem Zielort gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle](configure-metadata.md#task-option-file-object-handling) befinden, ist der Wert immer`0`. |
| – | `EstimatedFilesToDelete`, `EstimatedFoldersToDelete` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die DataSync voraussichtlich an Ihrem Zielort gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle](configure-metadata.md#task-option-file-object-handling) befinden, ist der Wert immer`0`. |
| – | `EstimatedFilesToTransfer` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die DataSync voraussichtlich über das Netzwerk übertragen werden. Dieser Wert wird während der DataSync [Vorbereitung](run-task.md#understand-task-execution-statuses) der Übertragung berechnet. Wie dieser Wert berechnet wird, hängt hauptsächlich vom verwendeten [Übertragungsmodus](configure-metadata.md#task-option-transfer-mode) ab: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `EstimatedFilesToTransfer`, `EstimatedFoldersToTransfer` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die DataSync voraussichtlich über das Netzwerk übertragen werden. Dieser Wert wird während der DataSync [Vorbereitung](run-task.md#understand-task-execution-statuses) der Übertragung berechnet. Wie dieser Wert berechnet wird, hängt hauptsächlich vom verwendeten [Übertragungsmodus](configure-metadata.md#task-option-transfer-mode) ab: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) |
| **Dateidurchsatz** | – | Verbessert, Basic | Die Geschwindigkeit, mit der Dateien, Objekte und Verzeichnisse über das Netzwerk DataSync übertragen werden. Wenn Sie verwenden [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), hängt die Berechnung dieses Zählers von Ihrem Aufgabenmodus ab: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `FilesFailed`, `FoldersFailed` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die DataSync während der Ausführung der Aufgabe nicht vorbereitet, übertragen, überprüft und gelöscht werden konnten. Falls Fehler auftreten, können Sie diese zusammen mit den Zählern „**Vorbereitet**“, „**Übertragen**“, „**Übersprungen**“ und „**Von der Zielkonsole gelöscht**“ sehen. |
| **An der Quelle aufgeführt** | `FilesListed.AtSource`, `FoldersListed.AtSource` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die an DataSync Ihrem Quellspeicherort gefunden wurden. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) |
| – | `FilesListed.AtDestinationForDelete`, `FoldersListed.AtDestinationForDelete` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die DataSync an Ihrem Zielort gefunden wurden. Dieser Zähler gilt nur, wenn Sie Ihre Aufgabe so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden](configure-metadata.md#task-option-file-object-handling). |
| **Netzwerkdurchsatz** \$1 | `BytesCompressed` | Verbessert, Basic | Die Anzahl der physischen Byte, die nach der Komprimierung über das Netzwerk DataSync übertragen werden (sofern eine Komprimierung möglich ist). Diese Zahl ist in der Regel geringer als die **übertragenen Daten** (in der Konsole) oder `BytesTransferred` (in [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)), es sei denn, die Daten sind nicht komprimierbar. \$1 Im erweiterten Modus wird der **Netzwerkdurchsatz** nicht in der Konsole angezeigt. |
| **Prozent komprimiert** | – | Verbessert, Einfach | Der Prozentsatz der Übertragungsdaten, die vor dem Senden über das Netzwerk DataSync komprimiert wurden. Wenn Sie verwenden [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), können Sie diesen Zähler mit berechnen`1 - BytesCompressed / BytesWritten`. |
| **Vorbereitet** | `FilesPrepared`, `FoldersPrepared` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die nach dem Vergleich Ihrer Quell- und Zielverzeichnisse übertragen DataSync werden sollen. In der Konsole kann Ihnen dieser Zähler auch die Anzahl der Objekte anzeigen, die bei der Vorbereitung DataSync übersprungen wurden. Weitere Informationen finden Sie unter [Wie wird Ihre Datenübertragung DataSync vorbereitet](how-datasync-transfer-works.md#how-datasync-prepares). Dieser Zähler ist nicht anwendbar, wenn Sie Ihre Aufgabe so konfigurieren, dass [alle Daten übertragen](configure-metadata.md#task-option-transfer-mode) werden. In diesem Szenario wird alles von der Quelle zum Ziel DataSync kopiert, ohne die Unterschiede zwischen den Standorten zu vergleichen. |
| **Verarbeitungsrate** | – | Verbessert, Einfach | Die Geschwindigkeit, mit der Dateien, Objekte und Verzeichnisse an Ihrem Quellspeicherort DataSync gelesen werden. Die Verarbeitungsrate basiert auf mehreren [CloudWatch Messwerten](monitor-datasync.md#accessing-metrics). Die genauen Metriken hängen vom verwendeten Aufgabenmodus ab. **Verbesserter Modus**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) **Basismodus:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/datasync/latest/userguide/transfer-performance-counters.html) |
| **Verbleibend** | – | Basic | Die verbleibende Anzahl von Dateien, Objekten und Verzeichnissen, die DataSync voraussichtlich über das Netzwerk übertragen werden. Wenn Sie verwenden [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), können Sie diesen Zähler berechnen, indem Sie von subtrahieren`FilesTransferred`. `EstimatedFilesToTransfer` |
| **\$1 Übersprungen** | `FilesSkipped` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die bei der Übertragung DataSync übersprungen werden. |
| – | `FilesSkipped`, `FoldersSkipped` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die bei der Übertragung DataSync übersprungen werden. **Übersprungene** Elemente werden in den Zähler „**Vorbereitet**“ aufgenommen, wenn [nur die Daten übertragen werden, die sich geändert haben](configure-metadata.md#task-option-transfer-mode), oder im Zähler „Übertragt“, wenn [alle](configure-metadata.md#task-option-transfer-mode) Daten **übertragen werden**. |
| **Übertragt** | `FilesTransferred` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die über das Netzwerk DataSync übertragen werden. Dieser Wert wird während der Ausführung der Aufgabe regelmäßig aktualisiert, wenn etwas aus der Quelle gelesen und über das Netzwerk gesendet wird. Wenn DataSync etwas nicht übertragen werden kann, kann dieser Wert kleiner als `EstimatedFilesToTransfer` oder sein`EstimatedFoldersToTransfer`. In einigen Fällen kann dieser Wert auch größer als `EstimatedFilesToTransfer` oder sein`EstimatedFoldersToTransfer`. Dieser Leistungsindikator ist für einige Standorttypen implementierungsspezifisch. Verwenden Sie ihn also nicht als exakten Hinweis darauf, was übertragen wird, oder um die Ausführung Ihrer Aufgabe zu überwachen. |
| **Übertragt** | `FilesTransferred`, `FoldersTransferred` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die über das Netzwerk DataSync übertragen werden. Dieser Wert wird während der Ausführung der Aufgabe regelmäßig aktualisiert, wenn etwas aus der Quelle gelesen und über das Netzwerk gesendet wird. Wenn DataSync etwas nicht übertragen werden kann, kann dieser Wert kleiner als `EstimatedFilesToTransfer` oder sein`EstimatedFoldersToTransfer`. In einigen Fällen kann dieser Wert auch größer als `EstimatedFilesToTransfer` oder sein`EstimatedFoldersToTransfer`. Dieser Leistungsindikator ist für einige Standorttypen implementierungsspezifisch. Verwenden Sie ihn also nicht als exakten Hinweis darauf, was übertragen wird, oder um die Ausführung Ihrer Aufgabe zu überwachen. |
| **Verifiziert** | `FilesVerified` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die während Ihrer Übertragung DataSync überprüft werden. Wenn Sie Ihre Aufgabe so konfigurieren, dass [nur übertragene Daten überprüft](configure-data-verification-options.md) werden, werden in einigen Situationen Verzeichnisse oder Dateien oder Objekte, die DataSync nicht übertragen werden können, nicht überprüft. |
| **Verifiziert** | `FilesVerified`, `FoldersVerified` | Verbessert | Die Anzahl der Dateien oder Objekte und Verzeichnisse, die während der Übertragung DataSync überprüft werden. |
# Überwachung von Datenübertragungen mit CloudWatch Amazon-Metriken
Amazon CloudWatch stellt Kennzahlen zur Verfügung, mit denen Sie die DataSync Übertragungsleistung verfolgen und Probleme mit Ihrer Übertragungsaufgabe beheben können.
Sie können die AWS DataSync Übertragungsleistung mithilfe von CloudWatch Amazon-Metriken überwachen. DataSync Metriken werden automatisch CloudWatch in 5-Minuten-Intervallen gesendet (unabhängig davon, wie Sie die [Protokollierung konfigurieren](configure-logging.md)). Die Metriken werden für einen Zeitraum von 15 Monaten aufbewahrt.
Um CloudWatch Kennzahlen für zu sehen DataSync, können Sie die folgenden Tools verwenden:
+ Die CloudWatch Konsole
+ Die CloudWatch CLI
+ Die CloudWatch API
+ Die DataSync Konsole (auf der Detailseite der Aufgabenausführung)
Weitere Informationen finden Sie im [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 Metriken für DataSync
DataSync Metriken verwenden den `aws/datasync` Namespace und stellen Metriken für die folgenden Dimensionen bereit:
+ **AgentId**— Die eindeutige ID des Agenten (falls Ihre Aufgabe einen Agenten verwendet).
+ **TaskId**— Die eindeutige ID der Aufgabe. Er hat die Form `task-01234567890abcdef`.
Der `aws/datasync`-Namespace enthält die folgenden Metriken. Einige Metriken sind nicht in jedem [Aufgabenmodus](choosing-task-mode.md) verfügbar.
| CloudWatch Metrik | Unterstützung für den Aufgabenmodus | Beschreibung |
| --- | --- | --- |
| `BytesCompressed` | Basic | Die Anzahl der physischen Byte, die nach der Komprimierung über das Netzwerk DataSync übertragen werden (sofern eine Komprimierung möglich ist). Diese Zahl ist in der Regel geringer als, `BytesTransferred` sofern die Daten nicht komprimierbar sind. Einheit: Byte |
| `BytesPreparedDestination` | Basic | Die Anzahl der logischen Byte, die am Zielspeicherort DataSync vorbereitet werden. Einheit: Byte |
| `BytesPreparedSource` | Basic | Die Anzahl der logischen Byte, die am Quellspeicherort DataSync vorbereitet werden. Einheit: Byte |
| `BytesTransferred` | Basic | Die Anzahl der Byte, die vor der Komprimierung an das Netzwerk DataSync gesendet werden (sofern eine Komprimierung möglich ist). Die Anzahl der über das Netzwerk übertragenen Byte finden Sie in der `BytesCompressed` Metrik. Einheit: Byte |
| `BytesVerifiedDestination` | Basic | Die Anzahl der logischen Byte, die am Zielstandort DataSync verifiziert werden. Einheit: Byte |
| `BytesVerifiedSource` | Basic | Die Anzahl der logischen Byte, die am DataSync Quellspeicherort verifiziert werden. Einheiten: Byte |
| `BytesWritten` | Verbessert, Einfach | Die Anzahl der logischen Byte, die in den Zielspeicherort DataSync geschrieben werden. Einheit: Byte |
| `FilesDeleted` | Verbessert, Einfach | Die Anzahl der Dateien, Objekte und Verzeichnisse, die an Ihrem Zielort DataSync gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden](configure-metadata.md#task-option-file-object-handling), ist der Wert immer`0`. Einheit: Anzahl |
| `FilesListedSource` | Verbessert | Die Anzahl der Objekte, die DataSync an Ihrem Quellort gefunden wurden. Einheit: Anzahl |
| `FilesPrepared` | Verbessert | Die Anzahl der Objekte, DataSync die nach dem Vergleich Ihrer Quell- und Zielorte zu übertragen versuchen. Weitere Informationen finden Sie unter [Wie wird Ihre Datenübertragung DataSync vorbereitet](how-datasync-transfer-works.md#how-datasync-prepares). Diese Metrik ist nicht anwendbar, wenn Sie Ihre Aufgabe so konfigurieren, dass [alle Daten übertragen werden](configure-metadata.md#task-option-transfer-mode). In diesem Szenario wird alles von der Quelle zum Ziel DataSync kopiert, ohne die Unterschiede zwischen den Speicherorten zu vergleichen. Einheit: Anzahl |
| `FilesPreparedDestination` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die am Zielort DataSync vorbereitet werden. Einheit: Anzahl |
| `FilesPreparedSource` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die am Quellspeicherort DataSync vorbereitet werden. Einheit: Anzahl |
| `FilesSkipped` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die bei der Übertragung DataSync übersprungen werden. Einheit: Anzahl |
| `FilesTransferred` | Verbessert, Einfach | Die Anzahl der Dateien, Objekte und Verzeichnisse, die über das Netzwerk DataSync übertragen werden. Dieser Wert wird während der [Ausführung der Aufgabe](run-task.md#understand-task-execution-statuses) regelmäßig aktualisiert, wenn etwas aus der Quelle gelesen und über das Netzwerk gesendet wird. Dieser Wert kann niedriger sein als `EstimatedFilesToTransfer` in einer [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)Antwort, wenn DataSync etwas nicht übertragen werden kann. In einigen Fällen kann dieser Wert auch größer als sein`EstimatedFilesToTransfer`. Diese Metrik ist für einige Standorttypen implementierungsspezifisch. Verwenden Sie sie daher nicht als exakte Angabe dafür, was übertragen wurde, oder um die Ausführung Ihrer Aufgabe zu überwachen. Einheit: Anzahl |
| `FilesVerified` | Verbessert | Die Anzahl der Objekte, die während Ihrer Übertragung DataSync verifiziert werden. Einheit: Anzahl |
| `FilesVerifiedDestination` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die am Zielort DataSync überprüft werden. Einheit: Anzahl |
| `FilesVerifiedSource` | Basic | Die Anzahl der Dateien, Objekte und Verzeichnisse, die am DataSync Quellspeicherort überprüft werden. Einheit: Anzahl |
# Ü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/).
# Überwachung von Datenübertragungen mit Amazon CloudWatch Logs
Sie können Ihre AWS DataSync Übertragung mithilfe von CloudWatch Protokollen überwachen. Wir empfehlen Ihnen, Ihre Aufgabe so zu konfigurieren, dass mindestens grundlegende Informationen (wie Übertragungsfehler) protokolliert werden.
## Ermöglicht DataSync das Hochladen von Protokollen in eine CloudWatch Protokollgruppe
Um die [Protokollierung für Ihre DataSync Aufgabe zu konfigurieren](#configure-logging-for-task), benötigen Sie eine CloudWatch Protokollgruppe, DataSync an die Protokolle gesendet werden dürfen. Sie richten diesen Zugriff über eine AWS Identity and Access Management (IAM-) Rolle ein. Wie das konkret funktioniert, hängt von Ihrem [Aufgabenmodus](choosing-task-mode.md) ab.
------
#### [ Enhanced mode ]
Im erweiterten Modus werden Aufgabenprotokolle DataSync automatisch an eine Protokollgruppe mit dem Namen gesendet`/aws/datasync`. Wenn diese Protokollgruppe in Ihrer nicht vorhanden ist AWS-Region, DataSync erstellt die Protokollgruppe in Ihrem Namen, indem Sie bei der Erstellung Ihrer Aufgabe eine mit dem [IAM-Dienst verknüpfte Rolle](https://docs.aws.amazon.com/datasync/latest/userguide/using-service-linked-roles-service-action-2.html) verwenden.
------
#### [ Basic mode ]
Es gibt mehrere Möglichkeiten, eine CloudWatch Protokollgruppe für eine DataSync Aufgabe im Basismodus einzurichten. In der Konsole können Sie automatisch eine IAM-Rolle erstellen, die in den meisten Fällen die zum Hochladen von Protokollen erforderlichen Berechtigungen umfasst. DataSync Beachten Sie, dass diese automatisch generierte Rolle unter dem Gesichtspunkt der geringsten Rechte möglicherweise nicht Ihren Anforderungen entspricht.
Wenn Sie eine vorhandene CloudWatch Protokollgruppe verwenden oder Ihre Aufgaben programmgesteuert erstellen möchten, müssen Sie die IAM-Rolle selbst erstellen.
Das folgende Beispiel ist eine IAM-Richtlinie, die diese Berechtigungen gewährt.
****
```
{
"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:*:*"
}
]
}
```
Die Richtlinie verwendet `Condition` Anweisungen, um sicherzustellen, dass nur DataSync Aufgaben aus dem angegebenen Konto Zugriff auf die angegebene CloudWatch Protokollgruppe haben. Es wird empfohlen, in diesen `Condition` Anweisungen die Kontextschlüssel [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)und die [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 Bedingung zu verwenden, um sich vor dem Problem des verwirrten Stellvertreters zu schützen. Weitere Informationen finden Sie unter [Serviceübergreifende Confused-Deputy-Prävention](cross-service-confused-deputy-prevention.md).
Um die DataSync Aufgabe oder Aufgaben anzugeben, *`region`* ersetzen Sie sie durch den Regionalcode für den AWS-Region Ort, an dem sich die Aufgaben befinden (z. B.`us-west-2`), und *`account-id`* ersetzen Sie sie durch die AWS-Konto ID des Kontos, das die Aufgaben enthält. Um die CloudWatch Protokollgruppe anzugeben, ersetzen Sie dieselben Werte. Sie können die `Resource` Anweisung auch so ändern, dass sie auf bestimmte Protokollgruppen abzielt. Weitere Informationen zur Verwendung von `SourceArn` und `SourceAccount` finden Sie unter [Globale Bedingungsschlüssel](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) im *IAM-Benutzerhandbuch*.
Um die Richtlinie anzuwenden, speichern Sie diese Richtlinienanweisung in einer Datei auf Ihrem lokalen Computer. Führen Sie dann den folgenden AWS CLI Befehl aus, um die Ressourcenrichtlinie anzuwenden. Um diesen Beispielbefehl zu verwenden, `full-path-to-policy-file` ersetzen Sie ihn durch den Pfad zu der Datei, die Ihre Richtlinienanweisung enthält.
```
aws logs put-resource-policy --policy-name trust-datasync --policy-document file://full-path-to-policy-file
```
**Anmerkung**
Führen Sie diesen Befehl aus, indem Sie denselben Befehl verwenden AWS-Konto und den Befehl verwenden AWS-Region , an dem Sie Ihren DataSync Agenten aktiviert haben.
Weitere Informationen finden Sie im [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).
------
## Konfiguration der Protokollierung für Ihre DataSync Aufgabe
Wir empfehlen, dass Sie mindestens eine gewisse Protokollierungsebene für Ihre DataSync Aufgabe konfigurieren.
**Bevor Sie beginnen**
DataSync benötigt die Erlaubnis, Protokolle in eine CloudWatch Protokollgruppe hochzuladen. Weitere Informationen finden Sie unter [Ermöglicht DataSync das Hochladen von Protokollen in eine CloudWatch Protokollgruppe](#cloudwatchlogs).
### Benutzt die DataSync Konsole
In den folgenden Anweisungen wird beschrieben, wie die CloudWatch Protokollierung beim Erstellen einer Aufgabe konfiguriert wird. Sie können die Protokollierung auch bei der Bearbeitung einer Aufgabe konfigurieren.
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. Wählen Sie auf der Seite **„Einstellungen konfigurieren**“ einen [Aufgabenmodus](choosing-task-mode.md) und alle anderen Optionen aus.
Einige der folgenden Optionen könnten Sie interessieren:
+ Geben Sie mithilfe eines [Manifests](transferring-with-manifest.md) oder von [Filtern](filtering.md) an, welche Daten übertragen werden sollen.
+ Konfigurieren Sie, wie [Dateimetadaten behandelt](configure-metadata.md) werden sollen, und [überprüfen Sie die Datenintegrität](configure-data-verification-options.md).
1. Wählen **Sie für Log Level** eine der folgenden Optionen aus:
+ **Grundinformationen wie Übertragungsfehler protokollieren** — Veröffentlichen Sie Protokolle, die nur grundlegende Informationen enthalten (z. B. Übertragungsfehler).
+ **Alle übertragenen Objekte und Dateien protokollieren** — Veröffentlichen Sie Protokolle für alle Dateien oder Objekte, die DataSync übertragen werden, und führt Datenintegritätsprüfungen durch.
+ **Generieren Sie keine Protokolle**
1. Führen Sie je nach Aufgabenmodus, den Sie zum Erstellen oder Angeben einer CloudWatch Protokollgruppe verwenden, einen der folgenden Schritte aus:
------
#### [ Enhanced mode ]
Wenn Sie **Aufgabe erstellen** wählen, DataSync wird automatisch eine Protokollgruppe mit dem Namen verwendet (oder erstellt)`/aws/datasync`.
------
#### [ Basic mode ]
Geben Sie unter **CloudWatch Protokollgruppe** eine Protokollgruppe an, die berechtigt DataSync ist, Protokolle hochzuladen, indem Sie einen der folgenden Schritte ausführen:
+ Wählen Sie **Automatisch generieren**, um automatisch eine Protokollgruppe DataSync zu erstellen, in die Protokolle hochgeladen werden können.
+ Wählen Sie eine bestehende Protokollgruppe in Ihrer aktuellen AWS-Region Protokollgruppe aus.
Wenn Sie eine bestehende Protokollgruppe auswählen, stellen Sie sicher, dass diese [DataSync Person berechtigt ist](#cloudwatchlogs), Protokolle in diese Protokollgruppe hochzuladen.
------
1. Wählen Sie **Create task** aus.
Sie sind bereit, [mit Ihrer Aufgabe zu beginnen](run-task.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: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. Geben Sie für `--source-location-arn` den Amazon-Ressourcennamen (ARN) Ihres Quellstandorts an.
1. Geben Sie für `--destination-location-arn` den ARN Ihres Zielorts an.
Wenn du zwischen AWS-Regionen unseren Konten überweist, vergewissere dich, dass der ARN die andere Region oder Konto-ID enthält.
1. Geben Sie für `--task-mode` `ENHANCED` oder an`BASIC`.
1. (Empfohlen) Geben Sie für `--name` einen Namen für Ihre Aufgabe an, an den Sie sich erinnern können.
1. Geben Sie für `LogLevel` eine der folgenden Optionen an:
+ `BASIC`— Veröffentlichen Sie Protokolle, die nur grundlegende Informationen enthalten (z. B. Übertragungsfehler).
+ `TRANSFER`— Veröffentlichen Sie Protokolle für alle Dateien oder Objekte, die DataSync übertragen und Datenintegritätsprüfungen durchführen.
+ `NONE`— Generieren Sie keine Protokolle.
1. Geben Sie für - `-cloudwatch-log-group-arn` den ARN einer CloudWatch Protokollgruppe an.
**Wichtig**
Falls `--task-mode` ja`ENHANCED`, müssen Sie diese Option nicht angeben. Weitere Informationen finden Sie unter [Ermöglicht DataSync das Hochladen von Protokollen in eine CloudWatch Protokollgruppe](#cloudwatchlogs).
1. Führen Sie den Befehl `create-task` aus.
Wenn der Befehl erfolgreich ist, erhalten Sie eine Antwort, die Ihnen den ARN der Aufgabe anzeigt, die Sie erstellt haben. Beispiel:
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
Sie sind bereit, [Ihre Aufgabe zu starten](run-task.md).
### Verwenden der DataSync API
Sie können die CloudWatch Protokollierung für Ihre Aufgabe konfigurieren, indem Sie den `CloudWatchLogGroupArn` Parameter mit einer der folgenden Operationen verwenden:
+ [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)
## DataSync Task-Protokolle anzeigen
Wenn Sie [Ihre Aufgabe starten](run-task.md), können Sie die Protokolle der Aufgabenausführung über die CloudWatch Konsole oder AWS CLI (neben anderen Optionen) einsehen. Weitere Informationen finden Sie im [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 stellt JSON-strukturierte Protokolle für Aufgaben im erweiterten Modus bereit. Aufgaben im Basismodus haben unstrukturierte Protokolle. Die folgenden Beispiele zeigen, wie Überprüfungsfehler in Protokollen im erweiterten Modus im Vergleich zu Protokollen im Basismodus angezeigt werden.
------
#### [ 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
```
------
# AWS DataSync API-Aufrufe protokollieren mit AWS CloudTrail
AWS DataSync ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der von einem Benutzer, einer Rolle oder einem AWS-Service Mitglied ausgeführten Aktionen bereitstellt. DataSync CloudTrail erfasst alle API-Aufrufe DataSync als Ereignisse. Zu den aufgezeichneten Aufrufen gehören Aufrufe von der DataSync Konsole und Codeaufrufen für DataSync API-Operationen.
Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Bereitstellung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für AWS DataSync. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im **Ereignisverlauf** anzeigen. Anhand der von gesammelten Informationen können Sie die Anfrage ermitteln CloudTrail, an die die Anfrage gestellt wurde AWS DataSync, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details.
Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Arbeiten mit DataSync Informationen in CloudTrail
CloudTrail ist auf Ihrem aktiviert AWS-Konto , wenn Sie das Konto erstellen. Wenn eine Aktivität in stattfindet AWS DataSync, wird diese Aktivität zusammen mit anderen AWS-Service Ereignissen in der CloudTrail **Ereignishistorie in einem Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem anzeigen, suchen und herunterladen AWS-Konto. Weitere Informationen finden Sie unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Zur kontinuierlichen Aufzeichnung von Ereignissen in Ihrem AWS-Konto, einschließlich Ereignissen für AWS DataSync, erstellen Sie einen Trail. Ein *Trail* ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle AWS-Regionen-Regionen. Der Trail protokolliert Ereignisse von allen Ereignissen AWS-Regionen in derselben AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3 S3-Bucket. Darüber hinaus können Sie andere konfigurieren, AWS-Services um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier:
+ [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Alle DataSync Aktionen werden von protokolliert CloudTrail. (Weitere Informationen finden Sie in der DataSync [API-Referenz](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html).)
Beispielsweise generieren Aufrufe der `ListLocations` Operationen `CreateAgent``CreateTask`, und Einträge in den CloudTrail Protokolldateien.
Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte:
+ Ob die Anfrage mit Root- oder AWS Identity and Access Management (IAM-) Anmeldeinformationen gestellt wurde.
+ Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.
+ Ob die Anforderung aus einem anderen AWS-Service gesendet wurde.
Weitere Informationen finden Sie unter [CloudTrailuserIdentityElement](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) im *AWS CloudTrail Benutzerhandbuch*.
## Grundlegendes zu DataSync Einträgen in Protokolldateien
Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, die Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden.
Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der den `CreateTask` Vorgang demonstriert.
```
{
"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"
}
```
# Überwachung von Ereignissen mithilfe von Amazon EventBridge
EventBridge Amazon-Ereignisse beschreiben Veränderungen bei DataSync Ressourcen. Sie können Regeln einrichten, die diesen Ereignissen entsprechen und sie an eine oder mehrere Zielfunktionen oder Streams weiterleiten. Ereignisse werden auf die bestmögliche Weise ausgegeben.
## DataSync Ereignisse übertragen
Die folgenden EventBridge Ereignisse stehen für DataSync Transfers zur Verfügung.
| **Agent state changes** |
| --- |
| Veranstaltung | Beschreibung |
| Status "Online" | Der Agent ist ordnungsgemäß konfiguriert und einsatzbereit. Dies ist der normale Betriebsstatus für einen Agenten. |
| Offline | Der Agent hat seit mindestens fünf Minuten keinen Kontakt mehr mit dem DataSync Service aufgenommen. Dies kann verschiedene Gründe haben. Weitere Informationen finden Sie unter [Was mache ich, wenn mein Agent offline ist?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline). |
| **Location state changes** |
| --- |
| Veranstaltung | Beschreibung |
| Hinzufügen | DataSync fügt einen Standort hinzu. |
| Available (Verfügbar) | Der Speicherort wurde erstellt und ist zur Verwendung verfügbar. |
| **Task state changes** |
| --- |
| Veranstaltung | Beschreibung |
| Available (Verfügbar) | Die Aufgabe wurde erstellt und ist startbereit. |
| In Ausführung | Die Aufgabe ist in Bearbeitung und funktioniert einwandfrei. |
| Nicht verfügbar | Die Aufgabe ist nicht richtig konfiguriert und kann nicht verwendet werden. Dieses Ereignis wird möglicherweise angezeigt, wenn ein mit der Aufgabe verbundener Agent offline geht. |
| In Warteschlange eingefügt | Eine andere Aufgabe wird ausgeführt und verwendet denselben Agenten. DataSync führt Aufgaben nacheinander aus (first in, first out). |
| **Task execution state changes** |
| --- |
| Veranstaltung | Beschreibung |
| In der Warteschlange | Eine weitere Aufgabenausführung läuft und verwendet denselben DataSync Agenten. Weitere Informationen finden Sie unter [Wissen Sie, wann sich Ihre Aufgabe in der Warteschlange befindet](run-task.md#queue-task-execution). |
| Wird gestartet | DataSync initialisiert die Ausführung der Aufgabe. Dieser Status vergeht normalerweise schnell, kann aber bis zu ein paar Minuten dauern. |
| Schalten Sie die &Snowball;-Appliance ein, indem Sie auf den Ein-/Aus-Schalter über dem E-Ink-Display drücken. | DataSync bestimmt, welche Daten übertragen werden sollen. Dieser Schritt kann nur wenige Minuten oder einige Stunden dauern, abhängig von der Anzahl der Dateien, Objekte oder Verzeichnisse an beiden Speicherorten und davon, wie Sie Ihre Aufgabe konfigurieren. Die Vorbereitung ist möglicherweise auch nicht auf Ihre Aufgabe anwendbar. Weitere Informationen finden Sie unter [Wie wird Ihre Datenübertragung DataSync vorbereitet](how-datasync-transfer-works.md#how-datasync-prepares). |
| Übertragung | DataSync führt die eigentliche Datenübertragung durch. |
| Wird überprüft | DataSync führt am Ende der Übertragung eine Datenintegritätsprüfung durch. |
| Herzlichen Glückwunsch | Die Ausführung der Aufgabe war erfolgreich. |
| Abbrechen | Die Ausführung der Aufgabe wird gerade abgebrochen. |
| Fehler | Die Ausführung der Aufgabe ist fehlgeschlagen. |
# Überwachung AWS DataSync mit manuellen Tools
Sie können Ihre AWS DataSync Übertragungen von der Konsole oder der Befehlszeile aus verfolgen.
## Überwachen Sie Ihre Übertragung mithilfe der DataSync Konsole
Sie können Ihre DataSync Übertragung mithilfe der Konsole überwachen, die Echtzeit-Metriken wie übertragene Daten, Daten- und Dateidurchsatz und Datenkomprimierung bereitstellt.
**Um Ihre Übertragung mithilfe der DataSync Konsole zu überwachen**
1. Nachdem Sie [Ihre DataSync Aufgabe gestartet](run-task.md#starting-task) haben, wählen **Sie Ausführungsdetails** anzeigen aus.
1. Sehen Sie sich Kennzahlen zu Ihrer Übertragung an.
## Überwachen Sie Ihre Übertragung mithilfe der AWS CLI
Sie können Ihre DataSync Übertragung überwachen, indem Sie die Taste AWS Command Line Interface (AWS CLI) verwenden.
Kopieren Sie den folgenden `describe-task-execution` Befehl. Wenn Sie diese Beispielbefehl verwenden möchten, ersetzen Sie `user input placeholders` durch Ihre Informationen.
```
aws datasync describe-task-execution \
--task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task-execution-id'
```
Dieser Befehl gibt Informationen ähnlich wie die folgenden zu einer Aufgabenausführung zurück.
```
{
"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"
}
}
```
+ Wenn die Aufgabenausführung erfolgreich ist, ändert sich der Wert von **Status** zu **SUCCESS (ERFOLGREICH)**. Hinweise zur Bedeutung der Antwortelemente finden Sie unter[DescribeTaskExecution](API_DescribeTaskExecution.md).
+ Wenn die Ausführung der Aufgabe fehlschlägt, sendet das Ergebnis Fehlercodes, die Ihnen bei der Behebung von Problemen helfen können. Informationen zu den Fehlercodes finden Sie unter[TaskExecutionResultDetail](API_TaskExecutionResultDetail.md).
## Überwachen Sie Ihre Übertragung mithilfe des `watch` Dienstprogramms
Um den Fortschritt Ihrer Aufgabe in Echtzeit von der Befehlszeile aus zu überwachen, können Sie das `watch` Unix-Standarddienstprogramm verwenden. Die Werte für die Ausführungsdauer von Aufgaben werden in Millisekunden gemessen.
Das `watch` Hilfsprogramm erkennt den Alias nicht. DataSync Das folgende Beispiel zeigt, wie die CLI direkt aufgerufen wird. Wenn Sie diese Beispielbefehl verwenden möchten, ersetzen Sie `user input placeholders` durch Ihre Informationen.
```
# 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'"
```