Class Logger

  • Direct Known Subclasses:
    AbstractLogger

    public abstract class Logger
    extends java.lang.Object
    Logging API provided inside of actors through the actor context.

    All log-level methods support simple interpolation templates with up to four arguments placed by using {} within the template (first string argument):

    
     ctx.log.error(exception, "Exception while processing {} in state {}", msg, state)
     

    More than four arguments can be defined by using an Array with the method with one argument parameter.

    *Rationale for an Akka-specific logging API:* Provided rather than a specific logging library logging API to not enforce a specific logging library on users but still providing a convenient, performant, asynchronous and testable logging solution. Additionally it allows unified logging for both user implemented actors and built in Akka actors where the actual logging backend can be selected by the user. This logging facade is also used by Akka internally, without having to depend on specific logging frameworks.

    The Logger of an actor is tied to the actor path and should not be shared with other threads outside of the actor.

    Not for user extension

    • Constructor Summary

      Constructors 
      Constructor Description
      Logger()  
    • Method Summary

      All Methods Instance Methods Abstract Methods Concrete Methods 
      Modifier and Type Method Description
      abstract void debug​(LogMarker marker, java.lang.String message)
      Log message at debug level.
      abstract void debug​(LogMarker marker, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void debug​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void debug​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void debug​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void debug​(java.lang.String message)
      Log message at debug level.
      abstract void debug​(java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void debug​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void debug​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void debug​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void error​(LogMarker marker, java.lang.String message)
      Log message at error level, without providing the exception that caused the error.
      abstract void error​(LogMarker marker, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void error​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void error​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void error​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void error​(LogMarker marker, java.lang.Throwable cause, java.lang.String message)
      Log message at error level, including the exception that caused the error.
      abstract void error​(LogMarker marker, java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void error​(LogMarker marker, java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void error​(LogMarker marker, java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void error​(LogMarker marker, java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void error​(java.lang.String message)
      Log message at error level, without providing the exception that caused the error.
      abstract void error​(java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void error​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void error​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void error​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void error​(java.lang.Throwable cause, java.lang.String message)
      Log message at error level, including the exception that caused the error.
      abstract void error​(java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void error​(java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void error​(java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void error​(java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void info​(LogMarker marker, java.lang.String message)
      Log message at info level.
      abstract void info​(LogMarker marker, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void info​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void info​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void info​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void info​(java.lang.String message)
      Log message at info level.
      abstract void info​(java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void info​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void info​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void info​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract boolean isDebugEnabled()
      Whether debug logging is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
      abstract boolean isErrorEnabled()
      Whether error logging is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
      abstract boolean isInfoEnabled()
      Whether info logging is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
      boolean isLevelEnabled​(Logging.LogLevel logLevel)
      Whether a log level is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
      abstract boolean isWarningEnabled()
      Whether error logging is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
      abstract void log​(Logging.LogLevel level, LogMarker marker, java.lang.String message)
      Log message at the specified level.
      abstract void log​(Logging.LogLevel level, LogMarker marker, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void log​(Logging.LogLevel level, LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void log​(Logging.LogLevel level, LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void log​(Logging.LogLevel level, LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void log​(Logging.LogLevel level, java.lang.String message)
      Log message at the specified level.
      abstract void log​(Logging.LogLevel level, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void log​(Logging.LogLevel level, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void log​(Logging.LogLevel level, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void log​(Logging.LogLevel level, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void warning​(LogMarker marker, java.lang.String message)
      Log message at warning level.
      abstract void warning​(LogMarker marker, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void warning​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void warning​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void warning​(LogMarker marker, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void warning​(LogMarker marker, java.lang.Throwable cause, java.lang.String message)
      Log message at warning level.
      abstract void warning​(LogMarker marker, java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void warning​(LogMarker marker, java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void warning​(LogMarker marker, java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void warning​(LogMarker marker, java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void warning​(java.lang.String message)
      Log message at warning level.
      abstract void warning​(java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void warning​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void warning​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void warning​(java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract void warning​(java.lang.Throwable cause, java.lang.String message)
      Log message at warning level.
      abstract void warning​(java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1)
      Message template with 1 replacement argument.
      abstract void warning​(java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2)
      Message template with 2 replacement arguments.
      abstract void warning​(java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3)
      Message template with 3 replacement arguments.
      abstract void warning​(java.lang.Throwable cause, java.lang.String template, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4)
      Message template with 4 replacement arguments.
      abstract Logger withLoggerClass​(java.lang.Class<?> clazz)
      Return a new logger sharing properties of this logger except the logger class
      abstract Logger withLogSource​(java.lang.String logSource)
      Return a new logger sharing properties of this logger except the log source
      abstract Logger withMdc​(java.util.Map<java.lang.String,​java.lang.Object> mdc)
      Java API: the returned logger will add the given MDC (Mapped Diagnostic Context) to any log entry logged
      abstract Logger withMdc​(scala.collection.immutable.Map<java.lang.String,​java.lang.Object> mdc)
      Scala API: the returned logger will add the given MDC (Mapped Diagnostic Context) to any log entry logged
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • Logger

        public Logger()
    • Method Detail

      • debug

        public abstract void debug​(java.lang.String message)
        Log message at debug level.

        Parameters:
        message - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(java.lang.String template,
                                   java.lang.Object arg1)
        Message template with 1 replacement argument.

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2)
        Message template with 2 replacement arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3)
        Message template with 3 replacement arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3,
                                   java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(LogMarker marker,
                                   java.lang.String message)
        Log message at debug level.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        message - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(LogMarker marker,
                                   java.lang.String template,
                                   java.lang.Object arg1)
        Message template with 1 replacement argument.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(LogMarker marker,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2)
        Message template with 2 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(LogMarker marker,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3)
        Message template with 3 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • debug

        public abstract void debug​(LogMarker marker,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3,
                                   java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.String message)
        Log message at error level, without providing the exception that caused the error.

        Parameters:
        message - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.String template,
                                   java.lang.Object arg1)
        Message template with 1 replacement argument.

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2)
        Message template with 2 replacement arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3)
        Message template with 3 replacement arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3,
                                   java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.Throwable cause,
                                   java.lang.String message)
        Log message at error level, including the exception that caused the error.

        Parameters:
        cause - (undocumented)
        message - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.Throwable cause,
                                   java.lang.String template,
                                   java.lang.Object arg1)
        Message template with 1 replacement argument.

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.Throwable cause,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2)
        Message template with 2 replacement arguments.

        Parameters:
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.Throwable cause,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3)
        Message template with 3 replacement arguments.

        Parameters:
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(java.lang.Throwable cause,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3,
                                   java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        Parameters:
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.Throwable cause,
                                   java.lang.String message)
        Log message at error level, including the exception that caused the error.

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        message - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.Throwable cause,
                                   java.lang.String template,
                                   java.lang.Object arg1)
        Message template with 1 replacement argument.

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.Throwable cause,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2)
        Message template with 2 replacement arguments.

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.Throwable cause,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3)
        Message template with 3 replacement arguments.

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.Throwable cause,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3,
                                   java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.String message)
        Log message at error level, without providing the exception that caused the error.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        message - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.String template,
                                   java.lang.Object arg1)
        Message template with 1 replacement argument.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2)
        Message template with 2 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3)
        Message template with 3 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • error

        public abstract void error​(LogMarker marker,
                                   java.lang.String template,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3,
                                   java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(java.lang.String message)
        Log message at info level.

        Parameters:
        message - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(java.lang.String template,
                                  java.lang.Object arg1)
        Message template with 1 replacement argument.

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(java.lang.String template,
                                  java.lang.Object arg1,
                                  java.lang.Object arg2)
        Message template with 2 replacement arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(java.lang.String template,
                                  java.lang.Object arg1,
                                  java.lang.Object arg2,
                                  java.lang.Object arg3)
        Message template with 3 replacement arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(java.lang.String template,
                                  java.lang.Object arg1,
                                  java.lang.Object arg2,
                                  java.lang.Object arg3,
                                  java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(LogMarker marker,
                                  java.lang.String message)
        Log message at info level.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        message - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(LogMarker marker,
                                  java.lang.String template,
                                  java.lang.Object arg1)
        Message template with 1 replacement argument.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(LogMarker marker,
                                  java.lang.String template,
                                  java.lang.Object arg1,
                                  java.lang.Object arg2)
        Message template with 2 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(LogMarker marker,
                                  java.lang.String template,
                                  java.lang.Object arg1,
                                  java.lang.Object arg2,
                                  java.lang.Object arg3)
        Message template with 3 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • info

        public abstract void info​(LogMarker marker,
                                  java.lang.String template,
                                  java.lang.Object arg1,
                                  java.lang.Object arg2,
                                  java.lang.Object arg3,
                                  java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • isDebugEnabled

        public abstract boolean isDebugEnabled()
        Whether debug logging is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
        Returns:
        (undocumented)
      • isErrorEnabled

        public abstract boolean isErrorEnabled()
        Whether error logging is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
        Returns:
        (undocumented)
      • isInfoEnabled

        public abstract boolean isInfoEnabled()
        Whether info logging is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
        Returns:
        (undocumented)
      • isLevelEnabled

        public boolean isLevelEnabled​(Logging.LogLevel logLevel)
        Whether a log level is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
        Parameters:
        logLevel - (undocumented)
        Returns:
        (undocumented)
      • isWarningEnabled

        public abstract boolean isWarningEnabled()
        Whether error logging is enabled on the actor system level, may not represent the setting all the way to the logger implementation, but when it does it allows avoiding unnecessary resource usage for log entries that will not actually end up in any logger output.
        Returns:
        (undocumented)
      • log

        public abstract void log​(Logging.LogLevel level,
                                 java.lang.String message)
        Log message at the specified level.

        Parameters:
        level - (undocumented)
        message - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 java.lang.String template,
                                 java.lang.Object arg1)
        Message template with 1 replacement argument.

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        level - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 java.lang.String template,
                                 java.lang.Object arg1,
                                 java.lang.Object arg2)
        Message template with 2 replacement arguments.

        Parameters:
        level - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 java.lang.String template,
                                 java.lang.Object arg1,
                                 java.lang.Object arg2,
                                 java.lang.Object arg3)
        Message template with 3 replacement arguments.

        Parameters:
        level - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 java.lang.String template,
                                 java.lang.Object arg1,
                                 java.lang.Object arg2,
                                 java.lang.Object arg3,
                                 java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        Parameters:
        level - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 LogMarker marker,
                                 java.lang.String message)
        Log message at the specified level.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        level - (undocumented)
        marker - (undocumented)
        message - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 LogMarker marker,
                                 java.lang.String template,
                                 java.lang.Object arg1)
        Message template with 1 replacement argument.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        level - (undocumented)
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 LogMarker marker,
                                 java.lang.String template,
                                 java.lang.Object arg1,
                                 java.lang.Object arg2)
        Message template with 2 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        level - (undocumented)
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 LogMarker marker,
                                 java.lang.String template,
                                 java.lang.Object arg1,
                                 java.lang.Object arg2,
                                 java.lang.Object arg3)
        Message template with 3 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        level - (undocumented)
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • log

        public abstract void log​(Logging.LogLevel level,
                                 LogMarker marker,
                                 java.lang.String template,
                                 java.lang.Object arg1,
                                 java.lang.Object arg2,
                                 java.lang.Object arg3,
                                 java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        level - (undocumented)
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(java.lang.String message)
        Log message at warning level.
        Parameters:
        message - (undocumented)
      • warning

        public abstract void warning​(java.lang.String template,
                                     java.lang.Object arg1)
        Message template with 1 replacement argument.

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2)
        Message template with 2 replacement arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2,
                                     java.lang.Object arg3)
        Message template with 3 replacement arguments.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2,
                                     java.lang.Object arg3,
                                     java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        Parameters:
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(java.lang.Throwable cause,
                                     java.lang.String message)
        Log message at warning level.
        Parameters:
        cause - (undocumented)
        message - (undocumented)
      • warning

        public abstract void warning​(java.lang.Throwable cause,
                                     java.lang.String template,
                                     java.lang.Object arg1)
        Message template with 1 replacement argument.

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(java.lang.Throwable cause,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2)
        Message template with 2 replacement arguments.
        Parameters:
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(java.lang.Throwable cause,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2,
                                     java.lang.Object arg3)
        Message template with 3 replacement arguments.
        Parameters:
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(java.lang.Throwable cause,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2,
                                     java.lang.Object arg3,
                                     java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.
        Parameters:
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.String message)
        Log message at warning level.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        message - (undocumented)
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.String template,
                                     java.lang.Object arg1)
        Message template with 1 replacement argument.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2)
        Message template with 2 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2,
                                     java.lang.Object arg3)
        Message template with 3 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2,
                                     java.lang.Object arg3,
                                     java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        Parameters:
        marker - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.Throwable cause,
                                     java.lang.String message)
        Log message at warning level.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        message - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.Throwable cause,
                                     java.lang.String template,
                                     java.lang.Object arg1)
        Message template with 1 replacement argument.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        If arg1 is an Array it will be expanded into replacement arguments, which is useful when there are more than four arguments.

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.Throwable cause,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2)
        Message template with 2 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.Throwable cause,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2,
                                     java.lang.Object arg3)
        Message template with 3 replacement arguments.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        See Also:
        Logger
      • warning

        public abstract void warning​(LogMarker marker,
                                     java.lang.Throwable cause,
                                     java.lang.String template,
                                     java.lang.Object arg1,
                                     java.lang.Object arg2,
                                     java.lang.Object arg3,
                                     java.lang.Object arg4)
        Message template with 4 replacement arguments. For more parameters see the single replacement version of this method.

        The marker argument can be picked up by various logging frameworks such as slf4j to mark this log statement as "special".

        Parameters:
        marker - (undocumented)
        cause - (undocumented)
        template - (undocumented)
        arg1 - (undocumented)
        arg2 - (undocumented)
        arg3 - (undocumented)
        arg4 - (undocumented)
        See Also:
        Logger
      • withLogSource

        public abstract Logger withLogSource​(java.lang.String logSource)
        Return a new logger sharing properties of this logger except the log source
        Parameters:
        logSource - (undocumented)
        Returns:
        (undocumented)
      • withLoggerClass

        public abstract Logger withLoggerClass​(java.lang.Class<?> clazz)
        Return a new logger sharing properties of this logger except the logger class
        Parameters:
        clazz - (undocumented)
        Returns:
        (undocumented)
      • withMdc

        public abstract Logger withMdc​(scala.collection.immutable.Map<java.lang.String,​java.lang.Object> mdc)
        Scala API: the returned logger will add the given MDC (Mapped Diagnostic Context) to any log entry logged

        See also akka.actor.typed.scaladsl.Behaviors.withMdc

        Parameters:
        mdc - (undocumented)
        Returns:
        (undocumented)
      • withMdc

        public abstract Logger withMdc​(java.util.Map<java.lang.String,​java.lang.Object> mdc)
        Java API: the returned logger will add the given MDC (Mapped Diagnostic Context) to any log entry logged

        See also akka.actor.typed.javadsl.Behaviors.withMdc

        Parameters:
        mdc - (undocumented)
        Returns:
        (undocumented)