Top 3.5% dependent repos on proxy.golang.org
proxy.golang.org : github.com/halimath/kvlog
Package kvlog provides a structured logging facility. The underlying structure is based on key-value pairs. key-value pairs are rendered as JSON lines but other Formatters can be used to provide different outputs including custom ones. While package kvlog provides a ready-to-use Logger via the L variable, creating a custom logger gives you more flexibility on the logger's target and format. Creating a new Logger is done via the New function. It accepts any number of Handlers. Each Handler pairs an io.Writer as well as a Formatter. Handlers can be synchronous as well as asynchronous. Synchronous Handlers execute the Formatter as well as writing the output in the same goroutine that invoked the Logger. Asynchronous Handlers dispatch the log event to a different goroutine via a channel. Thus, asynchronous Handlers must be closed before shutdown in order to flush the channel and emit all log events. Events are constructed by calling a Logger's With() method. This creates an Event that can be extended by calling its KV or delegating methods (such as Err or Dur). Eventually, submit the Event by invoking Log or Logf. Anything passed to Log is under under the Event's "msg" key. Loggers can be derived from other Loggers. This enables to configure a set of key-value-pairs to be added to every Event emitted via a deriverd logger. The syntax works similar to emitting log messages this time only invoking Logger() instead of Log. In addition to deriving Loggers, any number of Hooks may be added to a Logger. The Hook's callback function is invoked everytime an Event is emitted via this Logger or any Logger's derived from it. Hooks are useful to add dynamic values, such as timestamps or anything else read from the surrounding context. Adding a timestamp to every log Event is realized via the TimeHook. The kvlog package comes with three Formatters out of the box: Custom formatters may be created by implementing the Formatter interface or using the FormatterFunc convenience type.
Registry
-
Source
- Documentation
- JSON
- codemeta.json
purl: pkg:golang/github.com/halimath/kvlog
Keywords:
go
, golang
, log
, logger
, logging
License: Apache-2.0
Latest release: about 1 month ago
First release: almost 5 years ago
Namespace: github.com/halimath
Dependent packages: 1
Dependent repositories: 2
Stars: 0 on GitHub
Forks: 0 on GitHub
See more repository details: repos.ecosyste.ms
Last synced: 7 days ago