커스텀 로그
Note
커스텀 로그 기능의 지원이 중단됩니다. 로그 정의 기능을 사용하여 게임별 로그를 정의하고 전송할 수 있습니다. 아래의 가이드를 참조하세요.
- 로그 정의 가이드: 운영 > 애널리틱스 > 로그 정의
- 로그 정의 전송 가이드: API > Hive Server API > 애널리틱스 > 로그 정의 전송
카테고리¶
| 상용 서버 172.19.1.10 / 112.175.65.135 | service_metrics-custom_log | 
|---|---|
| 개발 서버 112.175.143.37 | service_metrics_test-custom_log | 
로그 스펙¶
Note
스네이크 케이스(예: server_id) 형태의 필드는 최종 저장소(BigQuery)에 저장될 때 카멜 케이스(예: serverId) 형태로 변환되며, serverid 같은 스펙에 명시되지 않은 형태로 전송된 로그는 해당 컬럼에 저장되지 않습니다.
| 필드명 (1단계) | 필드명 (2단계) | 설명 | 타입 | 필수여부 | 
|---|---|---|---|---|
| category | 게임명_custom_log (게임명은 game 필드와 동일한 값) | String | Y | |
| guid | 로그의 키 값 uuid 라이브러리 등으로 랜덤 문자열 생성을 추천 | string | Y | |
| dateTime | YYYY-MM-DD HH 한국 시간(KST) 기준이며, date 필드와 동일한 값 | string | Y | |
| log | 로그 테이블에 row 단위로 쌓일 정보 | json | Y | |
| date | 로그 발생 시각 형식: 년-월-일 시:분:초 예. 2012-01-19 16:24:00 | string | Y | |
| type | 커스텀 로그의 타입. 데이터 테이블과 매핑됨 | varchar | Y | |
| client_ip | 클라이언트 IP 국가정보 추출에만 사용 | varchar | N | |
| server_id | 서버 구분 코드 서버코드표 참조하여 '서버 코드(JSON 입력 코드)'를 입력 | varchar | N | |
| app_id | HIVE에서 사용하는 AppID 예. com.com2us.derbyday.kakao.freefull.google.global.android. common | varchar | Y | |
| guid | 매 로그마다 발생하는 고유 키 값 uuid와 같은 랜덤 문자열 형태를 권장 | varchar(64) | N | |
| ... | (이후 커스텀 로그 필드는 각 테이블에 맞게 추가) | |||
| meta | 메타 테이블에서 중복되는 키를 업데이트하는 정보 | json array | Y | |
| type | 커스텀 로그의 타입 메타 테이블과 매핑됨 | varchar | Y | |
| channel | 로그인 채널 
 | varchar | Y | |
| game | 게임 브랜드 네임 사용 (예. derbydays) app_id의 세 번째 항목 예. com.com2us.littlelegends.kakao.freefull.apple.global.ios.universal => littlelegends | varchar | Y | |
| id | 메타데이터 ID | varchar | Y | |
| name | 메타데이터 이름 | varchar | Y | 
로그 예제¶
{
  "category": "misample_custom_log",
  "guid": "ca4bd34c867f4617a819ae139d8d6670",
  "dateTime": "2018-12-17 17:29:11",
  "log": {
    "date": "2018-12-17 17:29:11",
    "type": "tutorial",
    "channel": "C2S",
    "game": "misample",
    "server_id": 3,
    "app_id": "com.com2us.misample",
    "device_id": 11111,
    "game_id": 22222,
    "channel_uid": 33333,
    "tutorial_id": 10001,
    "last_reset_date": "2018-12-17 17:23:31",
    "client_ip": "123.123.123.123",
    "guid": "ca4bd34c867f4617a819ae139d8d6670"
  },
  "meta": [
    {
      "type": "tutorial",
      "channel": "C2S",
      "game": "misample",
      "id": 10001,
      "name": "계정 생성"
    }
  ]
}