翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# タスクレポートによるデータ転送のモニタリング
*タスクレポート*には、タスクの実行中に AWS DataSync が試行した転送、スキップ、検証、削除の詳細が記されています。詳細については、「[DataSync がファイルやオブジェクト、ディレクトリを転送する仕組み](how-datasync-transfer-works.md#transferring-files)」を参照してください。
タスクレポートは JSON 形式で作成されます。タスクレポートの詳細度はカスタマイズが可能です。
+ [概要のみのタスクレポート](#task-report-types-summary)では、転送されたファイルの数や、DataSync がそれらのファイルのデータ整合性を検証できるかなど、タスクの実行に関する必須情報が記されています。
+ [標準のタスクレポート](#task-report-types-standard)には、DataSync が転送、スキップ、検証、削除を試みた、各ファイル、オブジェクト、フォルダを一覧表示する詳細なレポートと概要が記されています。標準のタスクレポートでは、[レポートの詳細度](#task-report-level)を指定して、タスク実行の失敗のみまたは成功と失敗を示すこともできます。
## ユースケース
データ転送のモニタリングと監査にタスクレポートが役立つケースは以下のとおりです。
+ 数百万のファイルを移行する場合に、DataSync で転送中に問題が生じているファイルをすばやく特定できます。
+ ファイルの管理の流れを検証できます。
## 概要のみのタスクレポート
タスク実行の概要のみを記したレポートには、以下の情報が記されています。
+ タスク実行 AWS アカウント を実行した
+ 送信元と送信先の場所
+ スキップ、転送、検証、削除されたファイル、オブジェクト、フォルダの総数
+ 転送された合計バイト数 (論理バイトと物理バイト)
+ タスクの実行が完了したか、キャンセルされたか、エラーが発生したか
+ 開始時刻と終了時刻 (転送の合計時間を含む)
+ タスクの設定 (帯域幅の制限、データ整合性の検証、DataSync 転送のその他の選択肢など)
## 標準タスクレポート
標準のタスクレポートには、タスク実行の[概要](#task-report-types-summary)のほか、DataSync が行った転送、スキップ、検証、削除の詳細なレポートが含まれています。
**Topics**
+ [レポートレベル](#task-report-level)
+ [転送されたレポート](#task-report-types-transferred)
+ [スキップされたレポート](#task-report-types-skipped)
+ [検証済みレポート](#task-report-types-verified)
+ [削除のレポート](#task-report-types-deleted)
### レポートレベル
標準タスクレポートでは、以下のレポートレベルのいずれかを選択できます。
+ エラーのみ
+ 成功と失敗 (基本的にタスクの実行中に発生したことをすべてリスト化)
たとえば、転送中に DataSync が正常にスキップしたファイルと正常にスキップされなかったファイルを確認したい場合があります。DataSync が正常にスキップしたファイルは、送信先にすでに存在するため、意図的に DataSync に除外させたファイルである可能性があります。ただし、たとえばスキップされたエラーは、DataSync にファイルを読み取るための適切な許可がないことを示している可能性があります。
### 転送されたレポート
タスクの実行中に DataSync が転送を試みたファイル、オブジェクト、ディレクトリのリスト。転送のレポートには以下の情報が記されています。
+ 転送されたデータのパス
+ 転送された内容 (コンテンツ、メタデータ、または両方)
+ データタイプ、コンテンツサイズ (オブジェクトとファイルのみ) などを含むメタデータ
+ 項目が転送された時刻
+ オブジェクトバージョン (送信先がバージョニングが有効になっている Amazon S3 バケットの場合)
+ 送信先で上書きが実行されたか
+ アイテムが正常に転送されたかどうか
**注記**
S3 バケット間でデータを移動する場合、[送信元の場所](create-s3-location.md)で指定したプレフィックスは、そのプレフィックスが送信先の場所にオブジェクトとして存在しない場合でも、レポート (または Amazon CloudWatch Logs) に表示されることがあります。(DataSync コンソールでは、このプレフィックスがスキップデータまたは検証済みデータとして表示されることもあります。)
### スキップされたレポート
DataSync が送信元で検出したが、転送を試みなかったファイル、オブジェクト、ディレクトリのリスト。DataSync がデータをスキップする理由は、タスクの設定方法やストレージシステムのアクセス許可などさまざまな要因に応じて異なります。次に例を示します。
+ 送信元と送信先のロケーションに存在するファイルがあります。送信元のファイルは、前回のタスク実行以降、変更されていません。[変更されたデータのみを転送している](configure-metadata.md#task-option-transfer-mode)ため、DataSync は次のタスクの実行中にはそのファイルを転送しません。
+ 両方の場所に存在するオブジェクトが送信元で変更されます。タスクを実行すると、DataSync は送信先のこのオブジェクトをスキップします。これは、タスクが[送信先のデータを上書き](configure-metadata.md#task-option-file-object-handling)しないためです。
+ DataSync は、[アーカイブストレージクラス](create-s3-location.md#using-storage-classes)を使用していて復元されていない送信元のオブジェクトをスキップします。DataSync がオブジェクトを読み取るには、アーカイブされたオブジェクトを復元する必要があります。
+ DataSync は、送信先の場所にある読み取り不能なファイル、オブジェクト、ディレクトリをスキップします。これが予期せず発生する場合は、ストレージシステムのアクセス許可を確認し、スキップされた内容を DataSync が読み取れることを確認してください。
スキップのレポートには以下の情報が記されています。
+ スキップされたデータのパス
+ アイテムがスキップされた時刻
+ スキップされた理由
+ アイテムが正常にスキップされたかどうか
**注記**
スキップされたレポートに成功と失敗が含まれており、[変更したデータのみを転送する](configure-metadata.md)ようにタスクを設定し、ソースデータが既に送信先に存在する場合は、レポートのサイズが大きくなる可能性があります。
### 検証済みレポート
タスクの実行中に DataSync が整合性を検証しようとしたファイル、オブジェクト、ディレクトリのリスト。検証済みデータのレポートには以下の情報が記されています。
+ 検証済みデータのパス
+ 項目が検証された時刻
+ 検証に失敗した理由 (該当する場合)
+ 送信元と送信先の SHA256 チェックサム (ファイルのみ)
+ アイテムが正常に検証されたかどうか
検証済みレポートについては、次の点に注意してください。
+ [転送されたデータのみを検証する](configure-data-verification-options.md)ようにタスクを設定すると、DataSync は状況によってはディレクトリを検証せず、また転送に失敗したファイルやオブジェクトを検証しません。いずれの場合も、DataSync はこのレポートに未検証のデータを含めません。
+ [拡張モード](choosing-task-mode.md)を使用している場合、大きなオブジェクトを転送する際、検証に通常よりも時間がかかることがあります。
### 削除のレポート
タスクの実行中に削除されたファイル、ディレクトリ、オブジェクトのリスト。DataSync は、送信先にあって送信元にはないデータを削除するように[タスクを設定した](configure-metadata.md)場合のみ、このレポートを作成します。削除されたデータのレポートには以下の情報が記されています。
+ 削除されたデータのパス
+ アイテムが正常に削除されたかどうか
+ アイテムが削除された時刻
## タスクレポートの例
タスクレポートの詳細レベルはユーザーが選択できます。以下は、次のように設定した転送済みデータのレポートの例です。
+ **レポートタイプ** — 標準
+ **レポートレベル** — 成功とエラー
**注記**
レポートでは、タイムスタンプ形式に ISO-8601 標準を使用します。時間は UTC で、ナノ秒単位で測定されます。この動作は、他のタスクレポートメトリクスの測定方法とは異なります。たとえば、`TransferDuration` や `VerifyDuration` などの[タスク実行の詳細](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskExecutionResultDetail.html)はミリ秒単位で測定されます。
拡張モードタスクレポートでは、基本モードタスクレポートとは若干異なるスキーマが使用されます。次の例は、使用する[タスクモード](choosing-task-mode.md)に応じて、レポートに何が期待できるのかを理解するのに役立ちます。
**ステータスが成功である転送済みデータのレポートの例**
次のレポートは、`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"
}]
}
```
**ステータスが失敗である転送済みデータのレポートの例**
次のレポートは、DataSync が `object1.txt` という名前のオブジェクトを転送できない場合の例を示しています。
このレポートは、 AWS KMS のアクセス許可の問題により、DataSync が `object1.txt` という名前のオブジェクトにアクセスできないことを示しています。(このようなエラーが発生したときは、「[サーバー側の暗号化を使用して S3 バケットにアクセスする](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"
}]
}
```
このレポートは、`object1.txt` という名前のオブジェクトが、S3 バケットのアクセス許可に問題があったため転送されなかったことを示しています (このようなエラーが発生したときは、「[DataSync に対する S3 バケットへのアクセス許可の付与](create-s3-location.md#create-s3-location-access)」を参照してください)。
```
{
"TaskExecutionId": "exec-abcdefgh12345678",
"Transferred": [{
"RelativePath": "/object1.txt",
"SrcMetadata": {
"Type": "Regular",
"ContentSize": 6,
"Mtime": "2022-01-07T16:59:26.136114671Z",
"Atime": "2022-01-07T16:59:26.136114671Z",
"Uid": 0,
"Gid": 0,
"Mode": "0644"
},
"Overwrite": "False",
"DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP",
"TransferTimestamp": "2022-01-07T16:59:45.747270957Z",
"TransferType": "CONTENT_AND_METADATA",
"TransferStatus": "FAILED",
"FailureReason": "S3 Get Object Failed",
"FailureCode": 40974
}]
}
```
## 制限事項
+ 個別のタスクレポートは 5 MB を超えることはできません。大量のファイルをコピーすると、タスクレポートは複数のレポートに分割されることがあります。
+ タスクレポートの作成が、データ転送のパフォーマンスに影響を与えることがあります。例えば、ネットワーク接続のレイテンシーが高く転送するファイルが小さい場合や、メタデータの変更のみをコピーする場合などです。