翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

データ配信のモニタリング

このトピックでは、Amazon CloudWatch メトリクス、CloudWatch Logs、および を使用して配信をモニタリングする方法について説明します AWS CloudTrail。

CloudWatch メトリクス

各配信は、 AWS/Kinesis名前空間の CloudWatch にメトリクスを発行します。メトリクス名には、汎用 Amazon S3 配信DeliveryToS3用とストリーミングテーブル配信DeliveryToIceberg用の送信先タイプがプレフィックスとして付けられます。これらのメトリクスを使用して、配信の状態とパフォーマンスをモニタリングします。

ディメンション

配信メトリクスは、次のディメンションで公開されます。

推奨アラーム

CloudWatch Logs

各配信は、詳細なログを CloudWatch Logs に発行して、デバッグと運用の可視性を実現できます。

CLI による CloudWatch Logs の有効化

以下を使用して配信を作成または更新するときに CloudWatch Logs を有効にします AWS CLI。

aws kinesis create-channel \
    --channel-name "my-channel" \
    --service-execution-role-arn "arn:aws:iam::123456789012:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:123456789012:stream/my-stream",
            "RecordConfiguration": { "RecordFormatType": "JSON" }
        }
    ]' \
    --s3-destination-configuration '{
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::my-destination-bucket",
            "ExpectedBucketOwner": "123456789012",
            "CompressionType": "GZIP"
        }
    }' \
    --logging-configuration '{
        "CloudWatchLogs": {
            "Enabled": true
        }
    }'

ロググループを指定せずに CloudWatch Logs を有効にすると、配信はデフォルトのロググループ を使用します/aws/kinesis/channelName/channelId。カスタム を指定する場合はLogGroupName、サービス実行ロールの CloudWatch Logs アクセス許可が同じロググループにスコープされていることを確認します。必要なアクセス許可については、「データ配信の IAM アクセス許可」を参照してください。

update-channel コマンドを使用して、既存の配信で CloudWatch Logs を有効化または更新し、同じ--logging-configuration値を渡すこともできます。

必要なアクセス許可

CloudWatch Logs を有効にするには、配信のサービス実行ロールに次のアクセス許可が必要です。

これらのアクセス許可を特定のロググループ ARN にスコープします。完全なポリシーの例オプションの CloudWatch Logs アクセス許可については、「」を参照してください。

AWS CloudTrail ログ記録

すべての配信 API コールは によって記録されます AWS CloudTrail。以下は、 CreateChannel呼び出しの AWS CloudTrail イベントの例です。

{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AROA1EXAMPLE:user-session",
        "arn": "arn:aws:sts::<account-id>:assumed-role/<role-name>/user-session",
        "accountId": "<account-id>"
    },
    "eventTime": "2026-07-20T20:00:00Z",
    "eventSource": "kinesis.amazonaws.com",
    "eventName": "CreateChannel",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "192.0.2.1",
    "userAgent": "aws-cli/2.x",
    "requestParameters": {
        "streamName": "my-stream",
        "channelName": "my-channel"
    },
    "responseElements": {
        "channelARN": "arn:aws:kinesis:us-east-1:<account-id>:channel/<channel-id>"
    },
    "requestID": "a1b2c3d4-example",
    "eventID": "e5f6g7h8-example",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "<account-id>"
}