Seelog
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/cihub/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/cihub/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/cihub/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