CloudWatch Logs의 로그 형식

CloudWatch Logs의 로그 형식

Amazon S3 서버 접근 로그가 Amazon CloudWatch Logs로 전달되면 각 로그 레코드는 구조화된 JSON 객체예요. 이는 일반 용도 Amazon S3 버킷 전달에 사용되는 공백으로 구분된 텍스트 형식과 달라요. 구조화된 형식 덕분에 regex 파싱 없이 CloudWatch Logs Insights에서 필드를 직접 조회할 수 있어요.

참고: 일반 용도 버킷 전달에 사용되는 공백으로 구분된 텍스트 형식은 "Amazon S3 서버 접근 로그 형식"을 참고하세요.

출처: 문서

본문

로그 레코드 필드

다음 표는 CloudWatch Logs로 전달되는 각 서버 접근 로그 레코드의 필드를 설명해요.

샘플 로그 레코드

다음은 CloudWatch Logs에 나타나는 서버 접근 로그 레코드의 예시예요.

{
  "schema_version_id": "V_1_0",
  "bucket_arn": "arn:aws:s3:::my-data-bucket",
  "bucket_name": "my-data-bucket",
  "request_time": "2026-04-29T14:32:16.000Z",
  "bucket_owner_id": "79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be",
  "remote_ip": "203.0.113.45",
  "requester": "arn:aws:iam::123456789012:role/DataAnalystRole",
  "request_id": "3E57427F33A59F07",
  "operation": "REST.GET.OBJECT",
  "key_name": "reports/2026/quarterly-summary.parquet",
  "request_uri": "GET /my-data-bucket/reports/2026/quarterly-summary.parquet HTTP/1.1",
  "http_status": 200,
  "error_code": null,
  "bytes_sent_size": 1048576,
  "object_size": 1048576,
  "total_duration": 45,
  "turn_around_duration": 12,
  "referer": null,
  "user_agent": "aws-sdk-java/2.20.0",
  "version_id": null,
  "host_id": "s9lzHYrFp76ZVxRcpX9+5cjAnEH2ROuNkd2BHfIa6UkFVdtjf5mKR3/eTPFvsiP/XV/VLi31234=",
  "signature_version": "SigV4",
  "cipher_suite": "TLS_AES_128_GCM_SHA256",
  "authentication_type": "AuthHeader",
  "host_header": "my-data-bucket.s3.us-east-1.amazonaws.com",
  "tls_version": "TLSv1.3",
  "access_point_arn": null,
  "acl_required": false,
  "source_region": "us-east-1"
}

일반 용도 버킷 로그 형식과의 차이

CloudWatch Logs 로그 형식은 다음과 같은 점에서 일반 용도 버킷 로그 형식과 달라요.

• 형식 – CloudWatch Logs 로그는 구조화된 JSON 객체예요. 일반 용도 버킷 로그는 공백으로 구분된 텍스트예요.
• 필드 이름 – CloudWatch Logs 형식은 설명적인 밑줄로 구분된 필드 이름(bytes_sent_size, total_duration, key_name, authentication_type 등)을 사용해요. 일반 용도 버킷 형식은 이름이 없는 열의 위치 기반 공백으로 구분된 텍스트예요.
• 추가 필드 – CloudWatch Logs 형식에는 일반 용도 버킷 텍스트 형식에는 없는 schema_version_id와 bucket_arn이 포함돼요.
• 파싱 불필요 – CloudWatch Logs 로그는 구조화된 JSON이므로 regex 파싱 없이 CloudWatch Logs Insights에서 개별 필드를 직접 조회할 수 있어요. 일반 용도 버킷 텍스트 형식은 필드를 추출하려면 regex나 사용자 지정 파서가 필요해요.

더 알아보기 (Learn more)

• 서버 접근 로그를 CloudWatch Logs로 전달
• CloudWatch Logs Insights로 로그 조회
• Amazon S3 서버 접근 로그 형식