日志管理

集团服务有多种Log,开发商可以通过Log来分析问题或者解析用户使用数据。

系统Log

内容:记录系统信息以及服务出错信息。

作用:用来分析系统出错原因。

位置:{服务安装目录}/service/logs/bit_service.log(或bit_service_xxx.log)

开启方式:默认开启(不可关闭)。

大小限制:每个文件大小限制50M,超过50M会切换到新文件,文件数量最多10个,超过会自动清理旧日志。

系统状态Log

内容:间隔三秒记录服务当前的队列状态。

作用:用来分析系统负载能力。

位置:{服务安装目录}/service/logs/bit.system.status.log。

开启方式:默认关闭,通过手动创建bit.system.status.log文件开启。

大小限制:每个文件大小限制50M,超过50M会切换到新文件,文件数量最多10个,超过会自动清理旧日志。

系统崩溃日志

内容:服务崩溃时记录崩溃堆栈信息。

作用:用来分析服务崩溃原因。

位置:{服务安装目录}/service/bit_service.anl。

开启方式:默认开启(不可关闭)。

大小限制:无限制。

Debug Log

内容:用来记录产品状态,包括SN(或特征项)添加日志,用户访问日志。

作用:用来分析以及排查用户访问出错原因。

位置:{服务安装目录}/service/logs/{产品名}.log(或 {产品名}_xxx.log)。

开启方式:默认关闭,开启方式参考集团服务常用命令

大小限制:单个文件最大100M,超过100M会切换到新文件,文件数量最多10个。

日志格式

每一行是一条日志,日志格式:

Time \[Type\] data
Time:日志记录时间
Type:事件类型,通过 \[xxx\] 包裹
Data:更具Type不同会有不同数据

[Start]/[End]

记录日志开始与结束时间。服务启动时会也会记录[Start]

2024-10-08 14:45:50 [Start]
…
2024-10-08 14:45:50 [End]

[Diary]

新的一天,会记录一条日志。

2024-10-08 14:45:50 [Diary] Date:2024-10-08, Start:00:00, End:14:45, RunSeconds:49223, PeakUsers:0, FullSeconds:0, LoginFail:0

[InstallFeature]

添加特征项事件。

2024-10-08 14:45:50 [InstallFeature] SNXXX “feature 1.0” “2024-12-21 12:00:00” 20
[日志记录时间] [InstallFeature] [SN] “[特征项名] [特征项版本]” [结束日期] [用户数]

特征项版本:如果特征项有版本,就会输出,没版本则只输出特征项名
结束日期:有结束日期则输出,无结束日期,输出Unlimited

[RemoveFeature]

删除特征项事件。

2024-10-08 14:45:50 [RemoveFeature] SNXXX “feature 1.0” “2024-12-21 12:00:00” 20
[日志记录时间] [RemoveFeature] [SN] “[特征项名] [特征项版本]” [结束日期] [用户数]

特征项版本:如果特征项有版本,就会输出,没版本则只输出特征项名
结束日期:有结束日期则输出,无结束日期,输出Unlimited

[ExpiredFeature]

特征项过期事件。

2024-10-08 14:45:50 [ExpiredFeature] SNXXX  “feature 1.0” “2024-12-21 12:00:00” 20
[日志记录时间] [ExpiredFeature] [SN] “[特征项名] [特征项版本]” [结束日期] [用户数]

特征项版本:如果特征项有版本,就会输出,没版本则只输出特征项名
结束日期:有结束日期则输出,无结束日期,输出Unlimited

[UpdateFeature]

特征项更新事件。

2024-10-08 14:45:50 [UpdateFeature] SNXXX “feature 1.0” “2024-12-21 12:00:00” 20
[日志记录时间] [UpdateFeature] [SN] “[特征项名] [特征项版本]” [结束日期] [用户数]

特征项版本:如果特征项有版本,就会输出,没版本则只输出特征项名
结束日期:有结束日期则输出,无结束日期,输出Unlimited

[Status]

特征项或SN的当前状态。

// 特征项状态
2024-10-08 14:45:50 [Status] SNXXX “feature 1.0” “2024-12-21 00:00:00” users:0/100
[日志记录时间] [Status] [SN\] “[特征项名] [特征项版本]” [结束日期] users:[当前用户数]/[总的用户数]

// SN状态
2024-10-08 14:45:50 [Status] SNXXX users:0/100
[日志记录时间] [Status] [SN] users:[当前用户数]/[总的用户数]

[Login]

客户端Login事件。

2024-06-04 19:56:39 [Login] 192.168.0.63 root@ubuntu pid:1 app:”xx.exe” feature:”feature 1.0” users:0/20 loginTime:"2024-06-04 19:54:57" required:2 error:1283

[日志记录事件] [Login] [ip] [用户名]@[机器名] pid:[进程ID] app:”[app名称]” feature:”请求的特征项” users:[当前用户数]/[用户总数] required:[请求的用户数] error:[请求出错,状态码]

上述日志的字段pid, app, feature, users, required, error 如果有就会输出,没有则不输出。
对于error,如果没有该字段,表示服务端成功响应了客户端的授权请求。

[Logout]

客户端Lgout事件,数据见[Login]事件。

[Checkout]

客户端借出事件,数据见[Login]事件。

[Checkin]

客户端归还事件,数据见[Login]事件。

[Query]

客户端Query事件,数据见[Login]事件。

[Release]

客户端Release事件,数据见[Login]事件。

[TimeChange]

系统时间变化事件。

[TimeChange] System time changes

用量数据

内容:用户访问的详细信息。

作用:用来分析用户行为,比起产品Log,它有更加精准的数据关联关系且支持通过接口查询。

位置:{服务安装目录}/service/data/{产品名}.log。

开启方式:默认关闭,在集团管理页面开启。

大小限制:默认数据保存2个月(可配置,参考集团服务常用命令)。

格式:二进制,通过RestFul接口查询。

Access日志

bit_client_access.log

内容:记录针对8273端口的访问。

作用:用来分析网络问题。

位置:{服务安装目录}/service/logs/bit_client_access.log。

开启方式:默认关闭,通过手动创建“{服务安装目录}/service/logs/bit.access.log”后开启。

大小限制:大小无限制。2024-12-21 11:59:12 [127.0.0.1] 11:59:10 11:59:12 "GET /" 0 "HTTP/1.1 200 OK"
[访问时间] [IP地址] [接收到请求的时间] [请求接受完时间] [请求地址] [请求的数据大小] [响应状态]

bit_web_access.log

内容:记录针对8274端口的访问。

作用:用来分析网络问题。

位置:{服务安装目录}/service/logs/bit_web_access.log。

开启方式:默认关闭,通过手动创建“{服务安装目录}/service/logs/bit.web.access.log”后开启。

大小限制:大小无限制。

2025-03-13 10:39:11 [127.0.0.1] 10:39:11 10:39:11 "GET /manager/getUsers.bit" "productname=312D31&seed=0.590914893065871" 41 "HTTP/1.1 200 OK" 
[访问时间] [IP地址] [接收到请求的时间] [请求接受完时间] [请求地址] [请求的数据大小] [响应状态]

slow log

内容:记录针对8273和8274端口超过5s的请求

作用:用来分析网络问题。

位置:

  • 8273:{服务安装目录}/service/logs/bit_service.log
  • 8274:{服务安装目录}/service/logs/{产品名}.log(或 {产品名}_xxx.log)
2025-03-17 10:41:05 [Slow] 192.168.1.39 "98001@Zayn" time:29281ms trace:"45380-1692543523-2-501548911" ucType:"14" db:"1" queue:"0" thread:"5"
[访问时间] [log类型] [IP地址] [用户名@机器名] [响应时间] [唯一id] [对应API] [db数] [队列数] [线程数]