|
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192 |
- # grlogs
- 本库为争游内部日志公共库, 该库基于 beegoLogger 基础上完善, 目前支持的引擎有 file、console、net、smtp、es、alisls
-
- ## 代码示例
-
- 1. 引入
- ```
- import "golib.gaore.com/GaoreGo/grlogs"
- ```
- 2. 简单用法
- ```
- grlogs.Get("test", 128).Info("hello word")
- grlogs.Get("test").Warning("hello word")
- ```
- `Get` 方法中 `lable` 参数为标签,为识别分类所用,在Grlogs里一个分类使用一个管道进行日志
-
- 3. 进阶用法
- ```
- logger := grlogs.GetEs("wifi")
- logger.SetAdapter(LevelAll, AdapterElasticSearch)
- logger.SetAdapter(LevelInfo, AdapterFile)
- logger.Critical("出错了")
- logger.Info("出错了")
- ```
-
- 4. 如果需要写入es 或 alils, 必须设置环境变量 `GRLOG_APP_NAME`, 不能有反斜杠, 如
- ```shell script
- export GRLOG_APP_NAME=mkt.gaore.com;
- ```
- 还需要额外引入es库,完成初始化动作
- ```go
- import _ "golib.gaore.com/GaoreGo/grlogs/logs/es"
- ```
-
- ```go
- import _ "golib.gaore.com/GaoreGo/grlogs/logs/alils"
- ```
-
- 5. 文件日志会写入到 `./runtime/logs/` 文件夹 **请务必在项目构建阶段创建该目录**
-
-
- 6. `AliLS` 日志接入的是阿里SLS GOSDK , 下面是关于 [https://github.com/aliyun/aliyun-log-go-sdk/tree/master/producer] 描述
-
- producer提供了两种关闭模式,分为有限关闭和安全关闭,安全关闭会等待producer中缓存的所有的数据全部发送完成以后在关闭producer,有限关闭会接收用户传递的一个参数值,时间单位为秒,当开始关闭producer的时候开始计时,超过传递的设定值还未能完全关闭producer的话会强制退出producer,此时可能会有部分数据未被成功发送而丢失。
-
- 所以用了aliLS 的 adapter 时,最好调用`grlogs.Close()` 或 `grlogs.CloseAll()` 方法安全关闭通道,以刷新缓冲区
-
- 7. 完整示例
- ```go
- package grlogs
-
- import (
- "fmt"
- _ "golib.gaore.com/GaoreGo/grlogs/logs/es"
- "testing"
- "time"
- )
-
- func TestGetLogger(t *testing.T) {
- // 新建 channel 大小为128 标识为nds 日志通道 , Get 的方法 默认带 console 和 file 输出
- l := grlogs.Get("nds", 128).SetAdapter(LevelAll, AdapterElasticSearch)
- l.Debug("我正在调试")
- l.Critical("出错了")
-
- // 复用 nds 的日志通道
- grlogs.Get("nds").Warning("hadoee %s", time.Now().Format(time.RFC1123))
- grlogs.Get("nds").Warning("hadoee %s", time.Now().Format(time.RFC1123))
-
- // 新建 channel 大小为默认 标识为wifi 日志通道 , GetEs 的方法 默认带 console 和 file 和 elatisearch 输出
- grlogs.GetEs("wifi")
- for i := 0; i < 10; i++ {
- grlogs.Get("wifi").Warning("Warning")
- grlogs.Get("wifi").Warn("Warn")
- grlogs.Get("wifi").Debug("Debug")
- grlogs.Get("wifi").Error("Error")
- grlogs.Get("wifi").Notice("Notice")
- grlogs.Get("wifi").Info("Info")
- grlogs.Get("wifi").Alert("Alert")
- }
-
- Get("wifi").Critical("neoweiwoewe")
- }
-
- func TestDropAdapter(t *testing.T) {
- grlogs.SetAdapter(LevelAll, AdapterAliLs)
- grlogs.DropAdapter(AdapterAliLs)
- grlogs.Informational(errors.New("he hello"))
- grlogs.SetAdapter(LevelAll, AdapterAliLs)
- grlogs.Debug(errors.New("he hello"))
- grlogs.CloseAll()
- }
- ```
|