タスクのモニタリング

モニタリングできますAWS DataSyncAmazon CloudWatch を使用します。このメトリクスには DataSync からの未加工データを収集し、リアルタイムに近い読み取り可能なメトリクスに加工することができます。これらの統計は 15 か月保持されます。デフォルトでは、DataSync メトリクスデータは 5 分間隔で CloudWatch に自動的に送信されます。CloudWatch の詳細については、「」を参照してください。Amazon CloudWatch、CloudWatch イベント、および CloudWatch ログとは何ですか?のAmazon CloudWatch ユーザーガイド。

DataSync の Amazon CloudWatch メトリクスへのアクセス

Amazon CloudWatch は DataSync のパフォーマンスに関する情報を入手するために使用できるメトリクスを提供しています。DataSync の CloudWatch メトリクスはさまざまな方法で表示できます。このメトリックスを表示するには、CloudWatch コンソールを使用します。アクセスするには、CloudWatch CLI または CloudWatch API を使用します。これらのメトリクスは、AWS DataSync コンソールのタスク実行の詳細ページでも表示できます。CloudWatch メトリクスの使用方法については、「」を参照してください。Amazon CloudWatch メトリクスを使用するのAmazon CloudWatch ユーザーガイド。

DataSync CloudWatch メトリクス

-AWS/DataSync 名前空間には、次のメトリクスが含まれます。

これらの統計は 15 か月保持されます。

メトリクス	説明
BytesVerifiedSource	送信元の場所で検証されたデータの合計バイト数。 単位: バイト
BytesPreparedSource	送信元の場所で準備されたデータの合計バイト数。 単位: バイト
FilesVerifiedSource	送信元の場所で検証されたファイルの合計数。 単位: カウント
FilesPreparedSource	送信元の場所で準備されたファイルの合計数。 単位: カウント
BytesVerifiedDestination	送信先の場所で検証されたデータの合計バイト数。 単位: バイト
BytesPreparedDestination	送信先の場所で準備されたデータの合計バイト数。 単位: バイト
FilesVerifiedDestination	送信先の場所で検証されたファイルの合計数。 単位: カウント
FilesPreparedDestination	送信先の場所で準備されたファイルの合計数。 単位: カウント
FilesTransferred	ネットワーク経由で転送された実際のファイル数またはメタデータ。この値は、計算され、TRANSFERRING (転送中) フェーズに継続的に更新されます。これは、各ファイルが送信元の場所から読み取られるごとに定期的に更新され、ネットワーク経由で送信されます。 転送中に障害が発生した場合、この値は EstimatedFilesToTransfer 未満になることがあります。場合によっては、この値は EstimatedFilesTransferred より大きくなることもあります。一部の場所タイプではこの要素が実装固有であるため、正確なファイル数あるいはタスク実行のモニタリングのインジケータとしてはこれを使用しないでください。 単位: カウント
BytesTransferred	エージェントが送信元の場所から送信先の場所に読み込む際に、ネットワーク経由で転送された合計バイト数。 単位: バイト
BytesWritten	送信先の場所に転送されたすべてのファイルの合計論理サイズ。 単位: バイト

DataSync の CloudWatch イベント

Amazon CloudWatch イベントは DataSync リソースでの変更点について説明します。このようなイベントを一致させるルールを設定して、1 つ以上のターゲット関数またはストリームにルートできます。イベントは、ベストエフォートベースで出力されます。

次の CloudWatch イベントが AWS DataSync で使用できます。

イベント	説明
State Changes for an Agent (エージェントの状態変更)	詳細については、「」を参照してくださいエージェントステータスの理解
ONLINE	エージェントは適切に設定され、使用可能です。ONLINE ステータスは、エージェントが正常に実行中であることを示すステータスです。
OFFLINE	エージェントの VM の電源が切れているか、エージェントが正常でない状態であり、5 分以上サービスとの接触が切れています。異常な状態を引き起こしていた問題が解決すると、エージェントは ONLINE ステータスに戻ります。
State Changes for a Location (場所の状態変更)
ADDING	DataSync は場所を追加しています。
AVAILABLE	この場所は作成され、使用可能です。
State Changes for a Task (タスクの状態変更)	詳細については、「」を参照してくださいタスク作成ステータスを理解します。
CREATING	DataSync はネットワークファイルシステム (NFS) の場所のマウントとタスクの作成を試みます。
RUNNING	DataSync にはマウントされた送信元があり、正常に機能しています。
AVAILABLE	タスクは適切に設定され、開始可能です。
使用不可	タスクが適切に設定されず、使用不可です。送信元 (NFS) の場所に関連付けられたエージェントがオフラインになった場合、タスクは UNAVAILABLE (使用不可) 状態に移行します。
State Changes for a Task Execution (タスク実行の状態変更)	詳細については、「」を参照してくださいタスク実行ステータスを理解します。
LAUNCHING	DataSync はタスク実行を初期化しています。
PREPARING	DataSync はどのファイルを転送する必要があるかを処理しています。
TRANSFERRING	DataSync はへのデータの転送を現在実行しています。AWS
VERIFYING	DataSync はすべてのデータおよびメタデータの整合性の検証を実行して、送信先のデータが送信元の正確なコピーであることを確認します。
SUCCESS	転送は成功しました。
ERROR	同期は失敗しました。

DataSync ディメンション

DataSync メトリックスは、AWS/DataSync 名前空間を使用し、以下のディメンションのメトリクスを提供します。

• AgentId：エージェントの一意の ID。

• TaskId-タスクの一意の ID。task-01234567890abcdef という書式が使用されます。

DataSync が Amazon CloudWatch ロググループにログをアップロードできるようにする

CloudWatch ロググループを使用すると、タスクをモニタリングし、デバッグすることができます。ロググループにログをアップロードするには、DataSync には、十分なアクセス許可を付与するリソースポリシーがに必要です。を使用してタスクを作成する場合AWS Management Consoleに設定すると、DataSync は必要なリソースポリシーを自動的に作成できます。詳細については、「タスク設定の構成」を参照してください。

このようなアクセス許可を付与するリソースポリシーの例を次に示します。

{
	"Statement": [
		{
			"Sid": "DataSyncLogsToCloudWatchLogs",
			"Effect": "Allow",
			"Action": [
				"logs:PutLogEvents",
				"logs:CreateLogStream"
			],
			"Principal": {
				"Service": "datasync.amazonaws.com"
			},
			"Condition": 
			{
				"ArnLike": {"aws:SourceArn": ["arn:aws:datasync:region:account-id:task/*]},
				"StringEquals": {"aws:SourceAccount": "account-id"}
			},
			"Resource": "arn:aws:logs:region:account-id:log-group:*:*"
		}
	],
	"Version": "2012-10-17"
}

ポリシーでは、条件ステートメントを使用して、指定されたアカウントの DataSync タスクのみが指定された CloudWatch ロググループにアクセスできるようにします。混乱した副問題から保護するために、条件ステートメントを使用することをお勧めします。詳細については、「」を参照してください。「混乱した代理」問題のIAM ユーザーガイド。

DataSync タスクを指定するには、regionの地域コードでAWS リージョンタスクが配置されている場所、およびaccount-idとAWS アカウントタスクを含むアカウントの ID。CloudWatch ロググループを指定するには、同じ値を置き換えます。また、Resourceステートメントを使用して、特定のロググループをターゲットにします。の使用方法の詳細については、SourceArnおよびSourceAccount「」を参照してください。グローバル条件キーのIAM ユーザーガイド。

ポリシーを適用するには、このポリシーステートメントをローカルコンピュータ上のファイルに保存します。次に、以下のコマンドを実行します。AWS Command Line Interface(AWS CLI) コマンドを使用して、リソースポリシーを適用します。

aws logs put-resource-policy --policy-name trustDataSync --policy-document file://full-path-to-policy-file

注記

このコマンドを同じAWS アカウントと DataSync エージェントがアクティブになっているリージョンです。

CloudWatch ロググループの詳細については、「」を参照してください。ロググループとログストリームの操作のAmazon CloudWatch Logs ユーザーガイド。