커스텀 로그
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 HHSS 형식으로 표시하는 로그 시간 한국 시간(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": "계정 생성"
}
]
}