Seelog

Fork from cihub/seelog

Add Tid formatter for trace goroutine. When use this project, you should add Goid function to golang runtime, and rebuild golang. You can refer to caitinggui/golang

Seelog is a powerful and easy-to-learn logging framework that provides functionality for flexible dispatching, filtering, and formatting log messages. It is natively written in the Go programming language.

Features

Xml configuring to be able to change logger parameters without recompilation
Changing configurations on the fly without app restart
Possibility to set different log configurations for different project files and functions
Adjustable message formatting
Simultaneous log output to multiple streams
Choosing logger priority strategy to minimize performance hit
Different output writers
- Console writer
- File writer
- Buffered writer (Chunk writer)
- Rolling log writer (Logging with rotation)
- SMTP writer
- Others... (See Wiki)
Log message wrappers (JSON, XML, etc.)
Global variables and functions for easy usage in standalone apps
Functions for flexible usage in libraries

Quick-start

package main

import log "github.com/caitinggui/seelog"

func main() {
    defer log.Flush()
    log.Info("Hello from Seelog!")
}

Installation

If you don't have the Go development environment installed, visit the Getting Started document and follow the instructions. Once you're ready, execute the following command:

go get -u github.com/caitinggui/seelog

IMPORTANT: If you are not using the latest release version of Go, check out this wiki page

Documentation

Seelog has github wiki pages, which contain detailed how-tos references: https://github.com/cihub/seelog/wiki

Examples

Seelog examples can be found here: seelog-examples

Issues

Feel free to push issues that could make Seelog better: https://github.com/caitinggui/seelog/issues

Changelog

v2.6 : Config using code and custom formatters
- Configuration using code in addition to xml (All internal receiver/dispatcher/logger types are now exported).
- Custom formatters. Check wiki
- Bugfixes and internal improvements.
v2.5 : Interaction with other systems. Part 2: custom receivers
- Finished custom receivers feature. Check wiki
- Added 'LoggerFromCustomReceiver'
- Added 'LoggerFromWriterWithMinLevelAndFormat'
- Added 'LoggerFromCustomReceiver'
- Added 'LoggerFromParamConfigAs...'
v2.4 : Interaction with other systems. Part 1: wrapping seelog
- Added configurable caller stack skip logic
- Added 'SetAdditionalStackDepth' to 'LoggerInterface'
v2.3 : Rethinking 'rolling' receiver
- Reimplemented 'rolling' receiver
- Added 'Max rolls' feature for 'rolling' receiver with type='date'
- Fixed 'rolling' receiver issue: renaming on Windows
v2.2 : go1.0 compatibility point [go1.0 tag]
- Fixed internal bugs
- Added 'ANSI n [;k]' format identifier: %EscN
- Made current release go1 compatible
v2.1 : Some new features
- Rolling receiver archiving option.
- Added format identifier: %Line
- Smtp: added paths to PEM files directories
- Added format identifier: %FuncShort
- Warn, Error and Critical methods now return an error
v2.0 : Second major release. BREAKING CHANGES.
- Support of binaries with stripped symbols
- Added log strategy: adaptive
- Critical message now forces Flush()
- Added predefined formats: xml-debug, xml-debug-short, xml, xml-short, json-debug, json-debug-short, json, json-short, debug, debug-short, fast
- Added receiver: conn (network connection writer)
- BREAKING CHANGE: added Tracef, Debugf, Infof, etc. to satisfy the print/printf principle
- Bug fixes
v1.0 : Initial release. Features:
- Xml config
- Changing configurations on the fly without app restart
- Contraints and exceptions
- Formatting
- Log strategies: sync, async loop, async timer
- Receivers: buffered, console, file, rolling, smtp

caitinggui / seelog