pekko/akka-contrib/docs/jul.rst

Java Logging (JUL)
==================

This extension module provides a logging backend which uses the `java.util.logging` (j.u.l)
API to do the endpoint logging for `akka.event.Logging`.

Provided with this module is an implementation of `akka.event.LoggingAdapter` which is independent of any `ActorSystem` being in place. This means that j.u.l can be used as the backend, via the Akka Logging API, for both Actor and non-Actor codebases.

To enable j.u.l as the `akka.event.Logging` backend, use the following Akka config:

  loggers = ["akka.contrib.jul.JavaLogger"]

To access the `akka.event.Logging` API from non-Actor code, mix in `akka.contrib.jul.JavaLogging`.

This module is preferred over SLF4J with its JDK14 backend, due to integration issues resulting in the incorrect handling of `threadId`, `className` and `methodName`.

This extension module was contributed by Sam Halliday.
java.util.logging backend for ActorLogging system, see #2805 [RK: assembled commit log from original branch, squashed] akka-contrib: - an event handler which properly sets the ThreadID on log records - a LoggingAdapter which does synchronous logging to j.u.l.Logger - a small logging mixin for the aforementioned adapter 2012-12-01 23:38:48 +00:00			`Java Logging (JUL)`
update to staged 2.10.0 release, CrossVersion.binary, see #2684 2012-12-21 14:53:05 +01:00			`==================`
java.util.logging backend for ActorLogging system, see #2805 [RK: assembled commit log from original branch, squashed] akka-contrib: - an event handler which properly sets the ThreadID on log records - a LoggingAdapter which does synchronous logging to j.u.l.Logger - a small logging mixin for the aforementioned adapter 2012-12-01 23:38:48 +00:00
			This extension module provides a logging backend which uses the `java.util.logging` (j.u.l)
			API to do the endpoint logging for `akka.event.Logging`.

			Provided with this module is an implementation of `akka.event.LoggingAdapter` which is independent of any `ActorSystem` being in place. This means that j.u.l can be used as the backend, via the Akka Logging API, for both Actor and non-Actor codebases.

			To enable j.u.l as the `akka.event.Logging` backend, use the following Akka config:

Rename event-handlers to loggers, see #2979 * Rename config akka.event-handlers to akka.loggers * Rename config akka.event-handler-startup-timeout to akka.logger-startup-timeout * Rename JulEventHandler to JavaLogger * Rename Slf4jEventHandler to Slf4jLogger * Change all places in tests and docs * Deprecation, old still works, but with warnings * Migration guide * Test for the deprecated event-handler config 2013-02-01 08:02:53 +01:00			`loggers = ["akka.contrib.jul.JavaLogger"]`
java.util.logging backend for ActorLogging system, see #2805 [RK: assembled commit log from original branch, squashed] akka-contrib: - an event handler which properly sets the ThreadID on log records - a LoggingAdapter which does synchronous logging to j.u.l.Logger - a small logging mixin for the aforementioned adapter 2012-12-01 23:38:48 +00:00
			To access the `akka.event.Logging` API from non-Actor code, mix in `akka.contrib.jul.JavaLogging`.

			This module is preferred over SLF4J with its JDK14 backend, due to integration issues resulting in the incorrect handling of `threadId`, `className` and `methodName`.

update to staged 2.10.0 release, CrossVersion.binary, see #2684 2012-12-21 14:53:05 +01:00			`This extension module was contributed by Sam Halliday.`