AWS DataSync のモニタリング

Amazon CloudWatch を使用して AWS DataSync をモニタリングすることで、DataSync から raw データを収集し、ほぼリアルタイムで読み取り可能なメトリクスに処理されます。これらの統計は 15 か月保持されます。デフォルトでは、 DataSyncメトリクスデータは 5 分間隔で自動的にCloudWatch に送信されます。CloudWatch の詳細については、「Amazon CloudWatch ユーザーガイド」の「Amazon CloudWatch、CloudWatch Events、CloudWatch Logs とは？」をご覧ください。

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 (エージェントの状態変更)	詳細については、DataSync エージェントステータス を参照してください
ONLINE	エージェントは適切に設定され、使用可能です。ONLINE ステータスは、エージェントが正常に実行中であることを示すステータスです。
OFFLINE	エージェントの VM の電源が切れているか、エージェントが異常な状態で、5 分以上サービスに接続されていません。異常な状態を引き起こしていた問題が解決すると、エージェントは ONLINE ステータスに戻ります。
State Changes for a Location (場所の状態変更)
ADDING	DataSync は場所を追加しています。
AVAILABLE	この場所は作成され、使用可能です。
State Changes for a Task (タスクの状態変更)	詳細については、DataSync タスク作成ステータス を参照してください
CREATING	DataSync はネットワークファイルシステム (NFS) の場所のマウントとタスクの作成を試みます。
RUNNING	DataSync にはマウントされた送信元があり、正常に機能しています。
AVAILABLE	タスクは適切に設定され、開始可能です。
UNAVAILABLE	タスクが適切に設定されず、使用不可です。送信元 (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 ロググループにアクセスできるようにします。を使用することをお勧めします。aws:SourceArnそしてaws:SourceAccount混乱した代理問題から保護するために、これらの条件ステートメント内のグローバル条件コンテキストキー。詳細については、「サービス間の混乱した代理の防止」を参照してください。

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

注記

DataSyncエージェントがアクティブ化されているのと同じAWS アカウント とリージョンを使用して、このコマンドを実行します。

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