README.md

brolog

Provide a simple slf4j backend.

Defaults to JSON output to stdout.

brolog is intended for containers. Logging to files or other fancy stuff is not supported.

Motivation

I wanted something simple that works well in containerized environments.

• No file appenders
• No config file
• JSON output
• Includes MDC and additional key value pairs in the JSON log entry.

Tests

There is a simple human-readable logger that is only intended for unit tests. Using json output when running tests in the IDE is just not ideal.

Just set the system property brolog.simple.mode or the environment variable BROLOG_SIMPLE_MODE to true.

Gradle example

test {
    systemProperty("brolog.simple.mode", "true")
}

Shell example

BROLOG_SIMPLE_MODE=true ./gradlew test

Gradle

implementation("sh.brocode:brolog:$version")

Configuration

Use the environment variableBROLOG_ROOT_LEVEL to configure the root log level.

For logger levels define environment variables with the prefix BROLOG_LEVEL_.

Read JSON log files on the CLI

Try fblog

Release

./gradlew publishToSonatype closeAndReleaseSonatypeStagingRepository