akka.event

Logging

Related Doc: package event

object Logging

Main entry point for Akka logging: log levels and message types (aka channels) defined for the main transport medium, the main event bus. The recommended use is to obtain an implementation of the Logging trait with suitable and efficient methods for generating log events:


val log = Logging(<bus>, <source object>)
...
log.info("hello world!")

The source object is used in two fashions: its Class[_] will be part of all log events produced by this logger, plus a string representation is generated which may contain per-instance information, see apply or create below.

Loggers are attached to the level-specific channels Error, Warning, Info and Debug as appropriate for the configured (or set) log level. If you want to implement your own, make sure to handle these four event types plus the InitializeLogger message which is sent before actually attaching it to the logging bus.

Logging is configured by setting (some of) the following:


akka {
  loggers = ["akka.slf4j.Slf4jLogger"] # for example
  loglevel = "INFO"        # used when normal logging ("loggers") has been started
  stdout-loglevel = "WARN" # used during application start-up until normal logging is available
}

Source
Logging.scala
Linear Supertypes
Content Hierarchy Learn more about scaladoc diagrams
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Logging
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Type Members

  1. case class Debug(logSource: String, logClass: Class[_], message: Any = "") extends LogEvent with Product with Serializable

    For DEBUG Logging

  2. class Debug2 extends Debug

  3. class DefaultLogger extends Actor with StdOutLogger

    Actor wrapper around the standard output logger.

    Actor wrapper around the standard output logger. If akka.loggers is not set, it defaults to just this logger.

  4. case class Error(cause: Throwable, logSource: String, logClass: Class[_], message: Any = "") extends LogEvent with Product with Serializable

    For ERROR Logging

  5. class Error2 extends Error

  6. case class Info(logSource: String, logClass: Class[_], message: Any = "") extends LogEvent with Product with Serializable

    For INFO Logging

  7. class Info2 extends Info

  8. case class InitializeLogger(bus: LoggingBus) extends NoSerializationVerificationNeeded with Product with Serializable

    Message which is sent to each default logger (i.e.

    Message which is sent to each default logger (i.e. from configuration file) after its creation but before attaching it to the logging bus. The logger actor must handle this message, it can be used e.g. to register for more channels. When done, the logger must respond with a LoggerInitialized message. This is necessary to ensure that additional subscriptions are in effect when the logging system finished starting.

  9. sealed trait LogEvent extends NoSerializationVerificationNeeded

    Base type of LogEvents

  10. class LogEventException extends Throwable with NoStackTrace

    Exception that wraps a LogEvent.

  11. final case class LogLevel(asInt: Int) extends AnyVal with Product with Serializable

    Marker trait for annotating LogLevel, which must be Int after erasure.

  12. class LoggerException extends AkkaException

    Artificial exception injected into Error events if no Throwable is supplied; used for getting a stack dump of error locations.

  13. class LoggerInitializationException extends AkkaException

    LoggerInitializationException is thrown to indicate that there was a problem initializing a logger

  14. abstract class LoggerInitialized extends AnyRef

    Response message each logger must send within 1 second after receiving the InitializeLogger request.

    Response message each logger must send within 1 second after receiving the InitializeLogger request. If initialization takes longer, send the reply as soon as subscriptions are set-up.

  15. type MDC = Map[String, Any]

  16. class StandardOutLogger extends InternalActorRef with MinimalActorRef with StdOutLogger

    Actor-less logging implementation for synchronous logging to standard output.

    Actor-less logging implementation for synchronous logging to standard output. This logger is always attached first in order to be able to log failures during application start-up, even before normal logging is started. Its log level can be defined by configuration setting akka.stdout-loglevel.

  17. trait StdOutLogger extends AnyRef

  18. case class Warning(logSource: String, logClass: Class[_], message: Any = "") extends LogEvent with Product with Serializable

    For WARNING Logging

  19. class Warning2 extends Warning

Value Members

  1. final def !=(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  4. val AllLogLevels: Seq[LogLevel]

  5. object Debug extends Serializable

  6. final val DebugLevel: LogLevel

  7. object Error extends Serializable

  8. final val ErrorLevel: LogLevel

    Log level in numeric form, used when deciding whether a certain log statement should generate a log event.

    Log level in numeric form, used when deciding whether a certain log statement should generate a log event. Predefined levels are ErrorLevel (1) to DebugLevel (4). In case you want to add more levels, loggers need to be subscribed to their event bus channels manually.

  9. object Info extends Serializable

  10. final val InfoLevel: LogLevel

  11. object LoggerInitialized extends LoggerInitialized with Product with Serializable

  12. val StandardOutLogger: StandardOutLogger

  13. object Warning extends Serializable

  14. final val WarningLevel: LogLevel

  15. def apply(logSource: Actor): DiagnosticLoggingAdapter

    Obtain LoggingAdapter with MDC support for the given actor.

    Obtain LoggingAdapter with MDC support for the given actor. Don't use it outside its specific Actor as it isn't thread safe

  16. def apply[T](bus: LoggingBus, logSource: T)(implicit arg0: LogSource[T]): LoggingAdapter

    Obtain LoggingAdapter for the given logging bus and source object.

    Obtain LoggingAdapter for the given logging bus and source object.

    The source is used to identify the source of this logging channel and must have a corresponding implicit LogSource[T] instance in scope; by default these are provided for Class[_], Actor, ActorRef and String types. See the companion object of akka.event.LogSource for details.

    You can add your own rules quite easily, see akka.event.LogSource.

  17. def apply[T](system: ActorSystem, logSource: T)(implicit arg0: LogSource[T]): LoggingAdapter

    Obtain LoggingAdapter for the given actor system and source object.

    Obtain LoggingAdapter for the given actor system and source object. This will use the system’s event stream and include the system’s address in the log source string.

    Do not use this if you want to supply a log category string (like “com.example.app.whatever”) unaltered, supply system.eventStream in this case or use

    Logging(system, this.getClass)

    The source is used to identify the source of this logging channel and must have a corresponding implicit LogSource[T] instance in scope; by default these are provided for Class[_], Actor, ActorRef and String types. See the companion object of akka.event.LogSource for details.

    You can add your own rules quite easily, see akka.event.LogSource.

  18. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  19. def classFor(level: LogLevel): Class[_ <: LogEvent]

    Returns the event class associated with the given LogLevel

  20. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  21. val emptyMDC: MDC

  22. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  23. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  24. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  25. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  26. def getLogger(logSource: UntypedActor): DiagnosticLoggingAdapter

    Obtain LoggingAdapter with MDC support for the given actor.

    Obtain LoggingAdapter with MDC support for the given actor. Don't use it outside its specific Actor as it isn't thread safe

  27. def getLogger(bus: LoggingBus, logSource: AnyRef): LoggingAdapter

    Obtain LoggingAdapter for the given logging bus and source object.

    Obtain LoggingAdapter for the given logging bus and source object.

    The source is used to identify the source of this logging channel and must have a corresponding implicit LogSource[T] instance in scope; by default these are provided for Class[_], Actor, ActorRef and String types. See the companion object of akka.event.LogSource for details.

  28. def getLogger(system: ActorSystem, logSource: AnyRef): LoggingAdapter

    Obtain LoggingAdapter for the given actor system and source object.

    Obtain LoggingAdapter for the given actor system and source object. This will use the system’s event stream and include the system’s address in the log source string.

    Do not use this if you want to supply a log category string (like “com.example.app.whatever”) unaltered, supply system.eventStream in this case or use

    Logging.getLogger(system, this.getClass());

    The source is used to identify the source of this logging channel and must have a corresponding implicit LogSource[T] instance in scope; by default these are provided for Class[_], Actor, ActorRef and String types. See the companion object of akka.event.LogSource for details.

  29. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  30. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  31. def levelFor(eventClass: Class[_ <: LogEvent]): LogLevel

    Returns the LogLevel associated with the given event class.

    Returns the LogLevel associated with the given event class. Defaults to DebugLevel.

  32. def levelFor(s: String): Option[LogLevel]

    Returns the LogLevel associated with the given string, valid inputs are upper or lowercase (not mixed) versions of: "error", "warning", "info" and "debug"

  33. def loggerInitialized(): LoggerInitialized.type

    Java API to create a LoggerInitialized message.

  34. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  35. def noCause: NoCause.type

  36. final def notify(): Unit

    Definition Classes
    AnyRef
  37. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  38. def simpleName(clazz: Class[_]): String

    Returns a 'safe' getSimpleName for the provided Class

    Returns a 'safe' getSimpleName for the provided Class

    returns

    the simple name of the given Class

  39. def simpleName(obj: AnyRef): String

    Returns a 'safe' getSimpleName for the provided object's Class

    Returns a 'safe' getSimpleName for the provided object's Class

    obj
    returns

    the simple name of the given object's Class

  40. def stackTraceFor(e: Throwable): String

    Returns the StackTrace for the given Throwable as a String

  41. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  42. def toString(): String

    Definition Classes
    AnyRef → Any
  43. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  44. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  45. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped