PLogger Structured Logger

A lightweight logger for Go with structured output and pluggable formatter/writer.

Features

• High performance.
• Modular design: easily swap formatters & writers.
• Supports multiple outputs (console, file, discard) for writer.
• Benchmark against zap, zerolog, logrus, etc.

Getting Started

Note that we only supports the two most recent minor versions of Go.

go get github.com/lthphuw/plogger@latest

Usage

Quick start

1formatter, _ := plogger.NewJSONFormatter()
2writer, _ := plogger.NewConsoleWriter()
3
4// Create logger options using builder pattern
5opts := plogger.NewLoggerOptions().
6    SetWriter(writer).
7    SetFormatter(formatter).
8    SetCaller(true)
9
10// Create logger
11logger, _ := plogger.NewLogger(opts)
12
13// Log an info message with additional fields
14logger.Info(plogger.NewEntry().
15    SetMsg("Hi world").
16    SetFieldMap(map[string]any{
17        "app": "my-service",
18        "env": "prod",
19    }))

Output will look something like this:

1{
2  "app": "my-service",
3  "env": "prod",
4  "file": ".../main/main.go",
5  "func": "main.main",
6  "level": "info",
7  "line": 22,
8  "msg": "Hi world",
9  "timestamp": "2025-05-22T15:47:36+07:00"
10}

Advanced Usage

Custom fields

1
2entry := plogger.NewEntry().
3    SetMsg("User login").
4    AddField("user_id", 123).
5    AddField("ip", "192.168.1.1")
6
7logger.Info(entry)

Use File Writer (Supports Rotation & Safe Concurrency)

1fileWriter, _ := plogger.NewFileWriter(
2    plogger.NewFileWriterOptions().SetFilename("/var/log/app.log"),
3)
4
5logger, _ := plogger.NewLogger(
6    plogger.NewLoggerOptions().
7        SetWriter(fileWriter).
8        SetFormatter(formatter),
9)

Benchmarks

The following benchmarks are adapted from the original zap logging benchmarks.
We've reused the same test scenarios and environment setup to ensure a fair comparison, with additional entries for plogger.

Log a message:

Log a message and 10 fields:

License

This project is licensed under the MIT License – see the LICENSE file for details.

Contact

Maintained by Phu.
For questions, feedback, or support, please contact: lthphuw@gmail.com

(back to top)