https://github.com/go-coldbrew/log
log provides a minimal interface for structured logging in services. It provides a simple interface to log errors, warnings, info and debug messages. It also provides a mechanism to add contextual information to logs. We provide implementations for gokit, logrus and zap.
https://github.com/go-coldbrew/log
golang logger logging microservice
Last synced: 4 days ago
JSON representation
log provides a minimal interface for structured logging in services. It provides a simple interface to log errors, warnings, info and debug messages. It also provides a mechanism to add contextual information to logs. We provide implementations for gokit, logrus and zap.
- Host: GitHub
- URL: https://github.com/go-coldbrew/log
- Owner: go-coldbrew
- License: apache-2.0
- Created: 2021-01-08T15:50:15.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2026-03-20T02:33:01.000Z (16 days ago)
- Last Synced: 2026-03-20T17:29:47.362Z (16 days ago)
- Topics: golang, logger, logging, microservice
- Language: Go
- Homepage:
- Size: 90.8 KB
- Stars: 0
- Watchers: 0
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/go-coldbrew/log/actions/workflows/go.yml)
[](https://goreportcard.com/report/github.com/go-coldbrew/log)
[](https://pkg.go.dev/github.com/go-coldbrew/log)
[](https://opensource.org/licenses/MIT)
# log
```go
import "github.com/go-coldbrew/log"
```
Package log provides a minimal interface for structured logging in services. ColdBrew uses this log package for all logs. It provides a simple interface to log errors, warnings, info and debug messages. It also provides a mechanism to add contextual information to logs. available implementations of BaseLogger are in loggers package. You can also implement your own BaseLogger to use with this package.
### How To Use
The simplest way to use this package is by calling static log functions to report particular level \(error/warning/info/debug\)
```
log.Error(...)
log.Warn(...)
log.Info(...)
log.Debug(...)
```
You can also initialize a new logger by calling 'log.NewLogger' and passing a loggers.BaseLogger implementation \(loggers package provides a number of pre built implementations\)
```
logger := log.NewLogger(gokit.NewLogger())
logger.Info(ctx, "key", "value")
```
Note:
```
Preferred logging output is in either logfmt or json format, so to facilitate these log function arguments should be in pairs of key-value
```
### Contextual Logs
log package uses context.Context to pass additional information to logs, you can use 'loggers.AddToLogContext' function to add additional information to logs. For example in access log from service
```
{"@timestamp":"2018-07-30T09:58:18.262948679Z","caller":"http/http.go:66","error":null,"grpcMethod":"/AuthSvc.AuthService/Authenticate","level":"info","method":"POST","path":"/2.0/authenticate/","took":"1.356812ms","trace":"15592e1b-93df-11e8-bdfd-0242ac110002","transport":"http"}
```
we pass 'grpcMethod' from context, this information gets automatically added to all log calls called inside the service and makes debugging services much easier. ColdBrew also generates a 'trace' ID per request, this can be used to trace an entire request path in logs.
this package is based on https://github.com/carousell/Orion/tree/master/utils/log
## Index
- [Constants](<#constants>)
- [func AddToContext\(ctx context.Context, key string, value any\) context.Context](<#AddToContext>)
- [func Debug\(ctx context.Context, args ...any\)](<#Debug>)
- [func Error\(ctx context.Context, args ...any\)](<#Error>)
- [func GetLevel\(\) loggers.Level](<#GetLevel>)
- [func GetOverridenLogLevel\(ctx context.Context\) \(loggers.Level, bool\)](<#GetOverridenLogLevel>)
- [func Info\(ctx context.Context, args ...any\)](<#Info>)
- [func OverrideLogLevel\(ctx context.Context, level loggers.Level\) context.Context](<#OverrideLogLevel>)
- [func SetLevel\(level loggers.Level\)](<#SetLevel>)
- [func SetLogger\(l Logger\)](<#SetLogger>)
- [func Warn\(ctx context.Context, args ...any\)](<#Warn>)
- [type Logger](<#Logger>)
- [func GetLogger\(\) Logger](<#GetLogger>)
- [func NewLogger\(log loggers.BaseLogger\) Logger](<#NewLogger>)
## Constants
SupportPackageIsVersion1 is a compile\-time assertion constant. Downstream packages reference this to enforce version compatibility.
```go
const SupportPackageIsVersion1 = true
```
```go
func AddToContext(ctx context.Context, key string, value any) context.Context
```
AddToContext adds log fields to the provided context. Any info added here will be included in all logs that use the returned context. This is the preferred entry point for adding contextual logging fields and is implemented internally using loggers.AddToLogContext.
Example
```go
package main
import (
"context"
"github.com/go-coldbrew/log"
)
func main() {
ctx := context.Background()
// Add per-request fields to context — these appear in all subsequent log lines
ctx = log.AddToContext(ctx, "request_id", "abc-123")
ctx = log.AddToContext(ctx, "user_id", "user-42")
// All logs using this context now include request_id and user_id
log.Info(ctx, "msg", "processing request", "step", "validation")
log.Info(ctx, "msg", "request complete", "status", "ok", "duration_ms", 42)
}
```
```go
func Debug(ctx context.Context, args ...any)
```
Debug writes out a debug log to global logger This is a convenience function for GetLogger\(\).Log\(ctx, loggers.DebugLevel, 1, args...\)
```go
func Error(ctx context.Context, args ...any)
```
Error writes out an error log to global logger This is a convenience function for GetLogger\(\).Log\(ctx, loggers.ErrorLevel, 1, args...\)
Example
```go
package main
import (
"context"
"github.com/go-coldbrew/log"
)
func main() {
ctx := context.Background()
log.Error(ctx, "msg", "database connection failed", "host", "db.internal", "port", 5432, "retry_in", "5s")
}
```
```go
func GetLevel() loggers.Level
```
GetLevel returns the current log level This is useful for checking if a log level is enabled
## func [GetOverridenLogLevel]()
```go
func GetOverridenLogLevel(ctx context.Context) (loggers.Level, bool)
```
GetOverridenLogLevel fetches overriden log level from context If no log level is overriden, it returns false If log level is overriden, it returns the log level and true
```go
func Info(ctx context.Context, args ...any)
```
Info writes out an info log to global logger This is a convenience function for GetLogger\(\).Log\(ctx, loggers.InfoLevel, 1, args...\)
Example
```go
package main
import (
"context"
"github.com/go-coldbrew/log"
)
func main() {
ctx := context.Background()
log.Info(ctx, "msg", "order processed", "order_id", "ORD-123", "items", 3)
}
```
```go
func OverrideLogLevel(ctx context.Context, level loggers.Level) context.Context
```
OverrideLogLevel allows the default log level to be overridden from request context This is useful when you want to override the log level for a specific request For example, you can set the log level to debug for a specific request while the default log level is set to info
```go
func SetLevel(level loggers.Level)
```
SetLevel sets the log level to filter logs
```go
func SetLogger(l Logger)
```
SetLogger sets the global logger
```go
func Warn(ctx context.Context, args ...any)
```
Warn writes out a warning log to global logger This is a convenience function for GetLogger\(\).Log\(ctx, loggers.WarnLevel, 1, args...\)
Logger interface is implemnted by the log implementation to provide the log methods to the application code.
```go
type Logger interface {
loggers.BaseLogger
// Debug logs a message at level Debug.
// ctx is used to extract the request id and other context information.
Debug(ctx context.Context, args ...any)
// Info logs a message at level Info.
// ctx is used to extract the request id and other context information.
Info(ctx context.Context, args ...any)
// Warn logs a message at level Warn.
// ctx is used to extract the request id and other context information.
Warn(ctx context.Context, args ...any)
// Error logs a message at level Error.
// ctx is used to extract the request id and other context information.
Error(ctx context.Context, args ...any)
}
```
```go
func GetLogger() Logger
```
GetLogger returns the global logger If the global logger is not set, it will create a new one with slog logger
```go
func NewLogger(log loggers.BaseLogger) Logger
```
NewLogger creates a new logger with a provided BaseLogger The default logger is slog logger
Generated by [gomarkdoc]()