Custom log
Note
This function is deprecated. Now, you can use the Log Definition to define and send logs for games. See the guides below.
- Guide on Log Definition: Operation > Analytics > Log Definition
- Guide on Sending Log Definition: API > Hive Server API > Analytics > Sending Log Definition
Category¶
| Common Server 172.19.1.10 / 112.175.65.135 | service_metrics-custom_log |
|---|---|
| Test Server 112.175.143.37 | service_metrics_test-custom_log |
Log specification¶
Note
The snake-cased field, like server_id, is transformed to camel case, like serverId, when it stores in the final storage (BigQuery), and the log sent in the unspecified form, such as serverid, is not saved in its column.
| Field Name (Main) | Field Name (Sub) | Description | Type | Required |
|---|---|---|---|---|
| category | game title_custom_log (Game title is the same with the value of game field) | String | Y | |
| guid | Key value of a log It is recommended to use random string such as uuid library | string | Y | |
| dateTime | The time of log stack with YYYY-MM-DD HH It is the same with the value of date field, based on KST | string | Y | |
| log | The data which stack on the log table (unit: row) | json | Y | |
| date | The time storing log Format: yyyy-MM-dd hh e.g., 2012-01-19 16:24:00 | string | Y | |
| type | Custom log type which created data mapping with data table | varchar | Y | |
| client_ip | Client IP. This value extracts the value of country | varchar | N | |
| server_id | Server Code Refer to Table of Server Code to input server code (JSON Input Code) | varchar | N | |
| app_id | AppID which Hive SDK uses e.g., com.com2us.derbyday.kakao.freefull.google.global.android. common | varchar | Y | |
| guid | Unique key generated per log Random format such as uuid is recommended | varchar(64) | N | |
| ... | (Add the following field to the appropriate table) | |||
| meta | The data which update the duplicate keys | json array | Y | |
| type | Custom log type which created data mapping with metatable | varchar | Y | |
| channel | Login channel * C2S: HIVE * KAK: Kakao Talk * LIN: LINE * WEI: Weibo | varchar | Y | |
| game | Use the brand name of game (e.g., derbydays) The third item of app_id e.g., com.com2us.littlelegends.kakao.freefull.apple.global.ios.universal => littlelegends | varchar | Y | |
| id | Metadata ID | varchar | Y | |
| name | Metadata name | varchar | Y |
Log sample¶
{
"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": "Create an Account"
}
]
}