翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
CloudWatch Logs を使用して AWS DataSync 転送をモニタリングできます。少なくとも基本情報 (転送エラーなど) をログに記録するようにタスクを設定することをお勧めします。
DataSync に CloudWatch ロググループへのログのアップロードを許可する
DataSync タスクのログ記録を設定するには、DataSync がログを送信するアクセス許可を持つ CloudWatch ロググループが必要です。このアクセスは、 AWS Identity and Access Management (IAM) ロールを使用してセットアップします。これが具体的にどのように機能するかは、タスクモードによって異なります。
拡張モードでは、DataSync は という名前のロググループにタスクログを自動的に送信します/aws/datasync
。そのロググループが に存在しない場合 AWS リージョン、DataSync は、タスクの作成時に IAM サービスにリンクされたロールを使用して、ユーザーに代わってロググループを作成します。
DataSync タスクのログ記録の設定
DataSync タスクには、少なくともある程度のレベルのログ記録を設定することをお勧めします。
[開始する前に]
DataSync には、CloudWatch ロググループにログをアップロードするためのアクセス権限が必要です。詳細については、「DataSync に CloudWatch ロググループへのログのアップロードを許可する」を参照してください。
次の手順は、タスクを作成する際に CloudWatch ロギングを設定する方法を示しています。タスクを編集するときにログ記録を設定することもできます。
https://console.aws.amazon.com/datasync/
で AWS DataSync コンソールを開きます。 左側のナビゲーションペインで [データ転送] を展開し、[タスク]、[タスクの作成] の順に選択します。
-
タスクのソースと送信先の場所を設定します。
詳細については、「AWS DataSyncのデータはどこに転送できますか?」を参照してください
-
設定の構成ページで、タスクモードとその他のオプションを選択します。
オプションは以下のとおりです。
-
ファイルメタデータを処理し、データ整合性を検証する方法を設定します。
-
[ログレベル] で、次のオプションのいずれかを選択します。
-
[転送エラーなどの基本情報をログに記録する] – 基本情報 (転送エラーなど) のみを公開します。
-
転送されたすべてのオブジェクトとファイルのログ記録 – DataSync が転送し、データ整合性チェックを実行するすべてのファイルまたはオブジェクトのログを発行します。
-
ログを生成しない
-
-
CloudWatch ロググループを作成または指定するために使用するタスクモードに応じて、次のいずれかを実行します。
-
[Create task] (タスクの作成) を選択します。
タスクを開始する準備ができました。
-
次の
create-task
コマンドをコピーします。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
:*" -
--source-location-arn
パラメータには、ソースの場所の Amazon リソースネーム (ARN) を指定します。 -
--destination-location-arn
には、転送先の場所の ARN を指定します。AWS リージョン または アカウント間で転送する場合は、ARN に他のリージョンまたはアカウント ID が含まれていることを確認してください。
-
には
--task-mode
、ENHANCED
または を指定しますBASIC
。 -
(推奨)
--name
では、簡単に覚えられる名前をタスクに指定してください。 -
には
LogLevel
、次のいずれかのオプションを指定します。-
BASIC
– 基本情報 (転送エラーなど) のみを含むログを発行します。 -
TRANSFER
– DataSync が転送し、データ整合性チェックを実行するすべてのファイルまたはオブジェクトのログを発行します。 -
NONE
– ログを生成しないでください。
-
-
- には
-cloudwatch-log-group-arn
、CloudWatch ロググループの ARN を指定します。重要
--task-mode
が の場合ENHANCED
、このオプションを指定する必要はありません。詳細については、「DataSync に CloudWatch ロググループへのログのアップロードを許可する」を参照してください。 -
create-task
コマンドを実行します。コマンドが成功すると、作成した場所の ARN を示す応答が返されます。以下に例を示します。
{ "TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026" }
タスクを開始する準備ができました。
以下のいずれかのオペレーションで CloudWatchLogGroupArn
パラメータを使用して、タスクの CloudWatch ロギングを設定できます。
DataSync タスクログの表示
タスクを開始するときは、CloudWatch コンソールまたは AWS CLI (他のオプションの中で) を使用して、タスク実行のログを表示できます。詳細については、「Amazon CloudWatch Logs ユーザーガイド」を参照してください。
DataSync は、拡張モードタスク用の JSON 構造化ログを提供します。基本モードタスクには非構造化ログがあります。次の例は、拡張モードログでの検証エラーと基本モードログの比較を示しています。
{
"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"
}