이벤트 저장 구조¶

개요¶

전송된 이벤트 로그가 BigQuery에 저장되는 구조, attributes JSON 필드의 세부 구조, 전송 규칙을 위반한 로그가 격리되는 방식을 확인할 수 있습니다.

테이블 구조¶

전송된 이벤트 로그는 회사별 BigQuery 데이터셋의 t_raw_event_log 테이블에 저장됩니다.

테이블 컬럼 구조¶

저장 위치¶

컬럼 정의¶

attributes 예시

{
  "hiveAttributes": {
    "dataSource": "custom_server",
    "geoIpCountry": "KR"
  },
  "eventAttributes": {
    "eventTime": "2026-07-20T14:01:01+09:00",
    "level": 10,
    "character_name": "AA",
    "stage_id": "stage_101"
  }
}

테이블 구조 주의사항 & Tips¶

• 재전송 등으로 동일 이벤트가 중복 저장될 수 있으니, 조회 시 checksum 기준 중복 제거 쿼리를 함께 사용하는 것을 권장합니다.
• 전송 규칙을 위반한 이벤트 로그는 이 테이블이 아닌 rescue 테이블에 저장됩니다. 자세한 내용은 데이터 격리를 참고하세요.

attributes 세부 속성¶

attributes 예시¶

{
  "hiveAttributes": {
    "dataSource": "custom_server",
    "geoIpCountry": "KR"
  },
  "eventAttributes": {
    "eventTime": "2026-07-20T14:01:01+09:00",
    "level": 10,
    "character_name": "AA"
  }
}

hiveAttributes¶

파이프라인이 자동으로 처리하여 저장하는 영역입니다.

dataSource 상세¶

dataSource는 이벤트 로그의 전송 주체를 나타내며, 다음 값 중 하나가 자동으로 설정됩니다.

eventAttributes¶

사용자가 전송한 속성과 SDK가 자동 수집한 속성이 저장되는 영역입니다.

attributes 주의사항 & Tips¶

• hiveAttributes는 개발사가 직접 값을 설정하는 영역이 아니라 파이프라인이 자동으로 채우는 영역입니다. dataSource, geoIpCountry 외의 값은 저장되지 않습니다.
• 사용자 정의 속성과 SDK 자동 수집 속성은 모두 eventAttributes에 함께 저장됩니다. 조회 시 속성명으로 구분해야 합니다.
• dataSource 값으로 이벤트 로그의 전송 경로(SDK/서버/MMP 등)를 구분해 조회할 수 있습니다.

데이터 격리¶

격리 사유¶

격리 테이블 구조¶

격리된 이벤트 로그는 t_raw_event_log_rescue 테이블에 다음과 같은 구조로 저장 됩니다.

연관 메뉴¶

• 이벤트 속성 전송 — 필수/자동 수집/사용자 정의 속성 상세 규칙
• 이벤트 로그 전송 — Hive SDK v4, Hive Axyl, Fluentd, HTTP를 통한 전송 방법