跳转至

日志登录

此日志由用户登录存储。您可以检查因加入新游戏或因促销而玩游戏的用户的当前状态。

类别

  • 书写类型
常见服务器 service_metrics-login_log
测试服务器 test-login_log
  • FTP 类型
命名规则 login_[日期][服务器][避免重复的ID].json 例如，login_20180705_111500_GLOBAL-4.json
  • Fluentd 类型（基于日志定义）
服务器（将负载平衡到两个服务器） analytics-hivelog-03.withhive.com analytics-hivelog-04.withhive.com
命名标签的规则 ha2union.game.[游戏的简短名称].login_log 例如，ha2union.game.samplegame.login_log
字段category的值 [游戏的简短名称]_login_log 例如，{"category":"samplegame_login_log","aaa":1}
详细传输方法
  • http 类型（基于日志定义）
服务器 https://analytics-log.withhive.com
字段category的值 [游戏的短名称]_login_log 例如，{"category":"samplegame_login_log","aaa":1}
详细传输方法

日志规范

Note

蛇形命名的字段，如 server_id，在存储到最终存储（BigQuery）时会转换为驼峰命名，如 serverId，而以未指定形式发送的日志，例如 serverid，不会保存在其列中。

字段名称 描述 类型 必需
date 存储日志的时间
格式：yyyy-mm-dd hh🇲🇲ss
例如：2012-01-19 16:24:00
Scribe/FTP 类型必需，Fluentd 类型可选		 string N
dateTime 存储日志的时间
格式：yyyy-mm-dd hh🇲🇲ss
例如：2012-01-19 16:24:00		 string Y
category [游戏的品牌名称]_[日志名称]
游戏的品牌名称是 app_id 的第三项
例如：“derbyday_login_log”		 string Y
timezone 日志中时间参数的 UTC 偏移
将时区的值固定为 空白或 GMT+09:00，因为当以 scribe 或 ftp 类型发送日志定义时，日期总是 KST。
例如：“GMT+09:00”
* 在以 fluentd 或 http 类型发送日志定义时，根据 dateTime 的值灵活设置时区的值。
例如：“GMT+10:30”		 string Y
channel 登录渠道
C2S: HIVE
KAK: Kakao Talk
LIN: LINE
WEI: 微博
GVL: Gamevile Live
STE: Steam		 string(3) Y
user_id 与配置的渠道字段一起使用的用户标识符
C2S: vid
KAK: App Center 发放的用户标识符
LIN: App Center 发放的用户标识符
WEI: 微博		 bigint Y
app_id Hive SDK 使用的 AppID
例如：'com.com2us.derbyday.kakao.freefull.google.global.android.common'		 string(200) Y
did Hive SDK 使用的设备 ID bigint Y
level 游戏中的用户等级（拥有众多角色的最高等级） int Y
client_ip 客户端 IP。此值从 GeoIP 提取国家值 string(32) Y
server_ip 服务器 IP string(32) N
device_name 用户设备型号
例如：iPhone, iPad, SM-G935, LGM-G600S		 string(32) Y
company 游戏发布公司，日志的目标：
例如：“C2S”：Com2uS，“GVI”：Com2uS Holdings		 string(3) Y
server_id 服务器代码
请参见 服务器代码表 输入 'JSON 输入代码'		 string Y
server_uid 游戏服务器中使用的用户标识符 bigint Y
last_login_date 昨天的最后登录时间
如果用户今天注册，则将此字段设置为登录时间
格式：yyyy-mm-dd hh🇲🇲ss
例如：2017-02-28 14:33		 string 不必需，但推荐。
country 如果未提供 client_ip，请直接输入国家代码。
参考：标识符政策
例如：KR		 string(2) N
os_version 操作系统版本信息。
例如：9.2.1		 string(10) 不必需，但推荐。
game_language 游戏中设置的语言。两个小写字母。
参考：标识符政策
例如：ko		 varchar 不必需，但推荐。
is_emulator 如果通过 PC 模拟器（如 BlueStacks）连接，则返回 1；否则，返回 0
对于 PC 版本，返回 2		 int 不必需，但推荐。
guid 每个日志生成的唯一键
推荐使用随机格式，如 uuid		 varchar(64) N

日志示例

{
    "date": "2012-11-26 13:32:45",
    "dateTime": "2012-11-26 13:32:45",
    "category": "derbyday_login_log",
    "channel": "KAK",
    "user_id": "**174577796603776",
    "app_id": "com.com2us.derbyday.kakao.freefull.google.global.android.common",
    "client_ip": "203.236.26.252",
    "server_ip": "112.175.60.138",
    "level": 28,
    "guid": "ca4bd34c867f4617a819ae139d8d6670"
}

收集的数据库架构（简化）

CREATE TABLE `LOGIN_LOG_20131031` (
    `log_id` BIGINT(20) NOT NULL AUTO_INCREMENT,
    `login_date` DATE NOT NULL,
    `last_login_date` DATETIME NULL,
    `app_id` VARCHAR(200) NOT NULL,
    `channel` VARCHAR(3) NOT NULL,
    `user_id` BIGINT(20) NOT NULL,
    `device_name` VARCHAR(128) NOT NULL DEFAULT 'unknown',
    `level` INT(11) NOT NULL,
    `country` CHAR(2) NULL DEFAULT NULL,
    `count` INT(11) NOT NULL,
    `add_date` DATETIME NOT NULL,
    `mod_date` DATETIME NOT NULL,
    `db_date` DATETIME NOT NULL,
    PRIMARY KEY (`log_id`),
    UNIQUE INDEX `ix_unique` (`login_date`, `app_id`, `channel`, `user_id`, `device_name`)
)
COLLATE='utf8_general_ci'
ENGINE=InnoDB

记录者类型

<?php
$GLOBALS['THRIFT_ROOT'] = '/dev/scribe-php'; // This route is changable. Modify it in accordance with the development environment.
include_once $GLOBALS['THRIFT_ROOT'].'/scribe.php';
include_once $GLOBALS['THRIFT_ROOT'].'/transport/TSocket.php';
include_once $GLOBALS['THRIFT_ROOT'].'/transport/TFramedTransport.php';
include_once $GLOBALS['THRIFT_ROOT'].'/protocol/TBinaryProtocol.php';
…
public function writeLoginLog($app_id, $channel, $user_id) // Function is an example as well. Modify it in accordance with the development environment. (Category, however, should be fixed as ‘login_log’)
{
        $msg['category'] = 'login_log';
        $msg['message'] = array();
        $msg['message']['date'] = date('Y-m-d H:i:s', time());
        $msg['message']['last_login_date'] = date('Y-m-d H:i:s', time());
        $msg['message']['app_id'] = $app_id;
        $msg['message']['channel'] = $channel;
        $msg['message']['user_id'] = $user_id;
        $msg['message']['level'] = $level;
        $msg['message']['client_ip'] = $client_ip;
        $msg['message']['server_ip'] = $server_ip;

        $msg['message'] = json_encode($msg['message']);

        $entry = new LogEntry($msg);
        $messages = array($entry);
        //var_dump($messages);

        $socket = new TSocket('localhost', 1463, TRUE); // the target host to send logs(fixed port)
        $transport = new TFramedTransport($socket);
        $protocol = new TBinaryProtocol($transport, FALSE, FALSE);
        $scribe_client = new scribeClient($protocol, $protocol);

        $transport->open();
        $scribe_client->Log($messages);
        $transport->close();  
}
?>

如何使用