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 Reference
• Migration Guide

If your company runs Loki4j in production, sponsoring the project is how you help keep it fast, current, and well maintained for the long run.

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

Key features

• Dynamic generation of Loki labels and metadata out of any Logback pattern, MDC, KVP, or SLF4J markers
• Structured metadata support
• Fast JSON layout for log message formatting
• Support of JSON and Protobuf Loki API flavors
• Compatibility with Grafana Cloud
• Zero-dependency
• Performance metrics

More details and links to the 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 17 or later

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

./gradlew check

Project status

Loki4j is stable and actively maintained. The main logging features are implemented and the configuration API is settled, so releases now focus on:

• compatibility with new Grafana Loki versions
• security patches and dependency updates
• bug fixes and issue triage for teams running Loki4j in production