기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

데이터 전송 모니터링

이 주제를 사용하여 Amazon CloudWatch 지표, CloudWatch Logs 및를 사용하여 전송을 모니터링하는 방법을 알아봅니다 AWS CloudTrail.

CloudWatch Metrics

각 전송은 AWS/Kinesis 네임스페이스의 CloudWatch에 지표를 게시합니다. 지표 이름은 범용 Amazon S3 전송의 DeliveryToS3 경우 , 스트리밍 테이블 전송의 경우 DeliveryToIceberg의 대상 유형에 따라 접두사가 지정됩니다. 이러한 지표를 사용하여 전송 상태와 성능을 모니터링합니다.

측정 기준

전송 지표는 다음 차원으로 게시됩니다.

권장되는 경보

CloudWatch Logs

각 전송은 디버깅 및 운영 가시성을 위해 CloudWatch Logs에 세부 로그를 게시할 수 있습니다.

CLI를 통해 CloudWatch Logs 활성화

AWS CLI다음을 사용하여 전송을 생성하거나 업데이트할 때 CloudWatch Logs를 활성화합니다.

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. 사용자 지정을 지정하는 경우 서비스 실행 역할의 CloudWatch Logs 권한이 동일한 로그 그룹으로 범위가 지정되었는지 LogGroupName확인합니다. 필요한 권한에 대해서는 데이터 전송을 위한 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>"
}