Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ibbd-dev/go-async-log
Golang异步日志库，支持异步批量写入，按天或者小时自动切割，错误等级，多文件等
https://github.com/ibbd-dev/go-async-log
Last synced: 6 days ago
JSON representation
Golang异步日志库，支持异步批量写入，按天或者小时自动切割，错误等级，多文件等
- Host: GitHub
- URL: https://github.com/ibbd-dev/go-async-log
- Owner: ibbd-dev
- License: mit
- Created: 2016-11-02T01:39:32.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2017-12-16T13:04:39.000Z (almost 7 years ago)
- Last Synced: 2024-06-18T21:39:18.354Z (5 months ago)
- Language: Go
- Homepage:
- Size: 13.7 KB
- Stars: 34
- Watchers: 4
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 异步日志库
## Install
```sh
go get -u github.com/ibbd-dev/go-async-log
```
## 实现的功能及说明
- 多个日志文件写入：例如错误信息一个文件，测试信息一个文件等
- 日志自动切割：前期支持按小时或者天切割
- 支持批量写入：最小单位为100毫秒，不同的文件可以设置不同的写入频率（周期性写入，程序挂掉的时候最多可能会丢一个周期的数据，重要数据不能采用该方式
- 同时支持实时写入文件，使用文件系统缓存（只要系统不挂，就不会有问题）
- 错误等级实现
- 可以写入json数据
- 时间格式采用`RFC3339`，格式如`2006-01-02T15:04:05Z07:00`
- 支持按概率写log
## 配置项
- 文件名
- 日志记录的等级
- 自动切割周期：默认按小时
- 批量写入周期：默认每秒写入一次
- 异常等级：
- 是否需要Flags：默认需要
## Example
普通写入日志文件
```go
lf := asyncLog.NewLogFile("/tmp/test.log")
// 设置按天切割文件，如果默认则是按小时
lf.SetRotate(asyncLog.RotateDate)
lf.SetProbability(0.5) // 设置写log的概率，默认全部都写入
_ = lf.Write("lf: hello world")
// 注意：因为是每秒写入一次，所以这里需要暂停一下
time.Sleep(time.Second * 2)
```
写入错误等级文件
```go
infoFile := asyncLog.NewLevelLog("/tmp/test-info.log", asyncLog.LevelInfo) // 只有Info级别或者以上级别的日志才会被记录
infoFile.SetProbability(0.5) // 设置写log的概率，默认全部都写入
infoFile.Debug("hello world") // 该日志不会写入文件
infoFile.Info("hello world")
infoFile.Error("hello world")
// 需要改变日志写入等级时，例如测试阶段
infoFile.SetLevel(asyncLog.LevelDebug)
time.Sleep(time.Second * 2)
```
## 性能数据
不缓存内容的时候，如果不对文件句柄进行缓存重用，性能是比较低的，如下：（这是旧版本）
```sh
# go test -bench=".*"
BenchmarkWrite-4 3000000 444 ns/op
BenchmarkWriteNoCache-4 300000 4400 ns/op
```
对句柄进行缓存重用之后，性能如下：
```sh
BenchmarkWrite-4 3000000 570 ns/op
BenchmarkWriteNoCache-4 1000000 2304 ns/op
```
结论：对句柄进行缓存，是能大大提升效率的。
-------
性能比`github.com/ibbd-dev/go-tools/logfile`至少提升一个数量级