综述
SGAME框架所使用的日志系统基于一个小的日志库slog,具体细节可以参考https://github.com/nmsoccer/slog 其安装也很简单,会在/usr/local/lib下生成一个slog.a静态库(主要免去到目标机器时各种部署动态库的麻烦,而且便于调试). slog有一个slog.go作为GO的API,在框架里已经包含
源码
SGAME的日志目录位于sgame/lib/log
,内容如下
sgame/lib/log/ |-- api.go `-- slog.go
- slog.go: 是slog项目本身提供的GO接口,我们将其包含进来
- api.go: 是基于slog与SGAME框架本身的封装层,框架实际使用的是api.go里的函数
类别
SGAME框架主要提供两类日志:
- 本地文件日志,方便记录进程运行时的各种事件
- 网络传输日志,因为游戏经常会有经分审计等需要,而且很多重要的功能节点也需要专门的信息保存,所以可以通过网络日志将重要信息发送到对端的UDP服务器用于保存和统计。因为是基于简单的UDP文本传输,接收端的开发也会很简单
本地日志
本地日志支持以下功能
- 日志分级
SGAME框架主要分为DEBUG,INFO,ERR,FATAL等四个级别。而且支持在进程运行时动态调整打印级别 - 日志滚动
SGAME框架支持日志文件的滚动,同时支持进程运行时的数目动态修改 - 时间粒度
支持秒,毫秒,微秒和纳秒四个粒度的时间,同时也支持进程运行时动态调整 - 协程支持
框架本身使用了多协程处理,所以支持多协程的日志打印
API
- 打开日志句柄
/*Open a Log handler * @filt_level:refer LOG_LV_XX. only print log above filt-level * @log_degree:refer LOG_DEGREE_XX * @rotate: log file max rotate num * @size: log file size */ func OpenLog(log_name string , filt_level int , log_degree int , rotate int , log_size int) *SLogPen
这里的参数就是日志文件名、过滤等级、日志粒度、日志滚动