https://github.com/sinri/keel-logger-ext
Keel Logger Component
https://github.com/sinri/keel-logger-ext
Last synced: 7 days ago
JSON representation
Keel Logger Component
- Host: GitHub
- URL: https://github.com/sinri/keel-logger-ext
- Owner: sinri
- License: gpl-3.0
- Created: 2025-11-07T04:08:22.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-11-24T06:50:36.000Z (6 months ago)
- Last Synced: 2025-11-24T07:52:35.580Z (6 months ago)
- Language: Java
- Size: 174 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Keel Logger Extension
A logging bridge library that routes **SLF4J 2.x** and **Log4j2** API calls
to the [Keel](https://github.com/sinri/keel) logging system via Java SPI — no manual configuration needed.
## Features
- Automatic SPI discovery — add the dependency and it just works
- SLF4J 2.x Marker → Keel classification mapping
- Log4j2 ThreadContext → Keel context mapping
- Configurable minimum log level (`visibleBaseLevel`)
- Extensible via subclassing `KeelSLF4JServiceProvider`
## Requirements
- Java 17+
- [keel-logger-api](https://github.com/sinri/keel-logger-api) 5.0.1
## Installation
### Gradle (Kotlin DSL)
```kotlin
dependencies {
implementation("io.github.sinri:keel-logger-ext:5.0.1")
}
```
### Gradle (Groovy DSL)
```groovy
dependencies {
implementation 'io.github.sinri:keel-logger-ext:5.0.1'
}
```
### Maven
```xml
io.github.sinri
keel-logger-ext
5.0.1
```
## How It Works
```
Third-party libraries / Application code
│
├── SLF4J API ──→ KeelSLF4JServiceProvider ──→ KeelSlf4jLoggerFactory ──→ KeelSlf4jLogger ──┐
│ │
└── Log4j2 API ─→ KeelLog4j2LoggerContextFactory ─→ KeelLog4j2LoggerContext ─→ KeelLog4j2Logger ─┤
▼
Keel LogWriterAdapter (unified output)
```
Once on the classpath, all SLF4J / Log4j2 log output is automatically routed
to Keel's `LogWriterAdapter` through Java SPI.
## Debug Mode
Pass the following JVM property to see logger creation details:
```
-Dkeel.logger.ext.verbose=true
```
## Documentation
Full documentation is available at the [GitHub Pages site](https://sinri.github.io/keel-logger-ext/).
- [Developer Guide](https://sinri.github.io/keel-logger-ext/5.0.1/developer-guide)
- [AI Coding Guide](https://sinri.github.io/keel-logger-ext/5.0.1/ai-coding-guide)
## License
[GPL-v3.0](https://www.gnu.org/licenses/gpl-3.0.txt)