loki-logback-appender

Loki4j aims to be the fastest and the most lightweight implementation of Logback appender for Grafana Loki. This project is unofficial and community-driven.

Please proceed to the microsite for more information:

• Quick Start
• Configuration Guide

If you have found this project helpful, please drop a ⭐!

Key features

• Flexible management of Loki labels using MDC and SLF4J Markers
• Out-of-the-box JSON layout support for log message formatting
• Logback plain text formatting patterns can be used for both labels and messages
• Support for JSON and Protobuf Loki API flavors
• Compatibility with Grafana Cloud
• Zero-dependency
• Logging performance metrics

More details and links to examples can be found here.

Contributing

Please start with the Contribution guidelines.

Building and testing the project

Please make sure the following software is installed on your machine so you can build and test the project:

• Java 11 or later

Check out the project in the directory on your local machine and run:

./gradlew check

Project status

At the moment all the main logging features have been implemented and stabilized.

Further development will be concentrated on bug fixes (if any), keeping up with new versions of Loki, and improving the codebase so it's easier to maintain.