Logger

The logger is the core component of SLF4D. Use it to generate log messages in your code. An ad-hoc Logger can be created and used anywhere, but usually you'll want to use the getLogger() function to obtain a pre-configured Logger that has been set up with an application-specific LogHandler.

Note that the D language offers some special keywords like __MODULE__ and __PRETTY_FUNCTION__ which at compile time resolve to the respective source symbols, and are used heavily here for adding context to log messages. Because these must be resolved in the actual source location and *not* in the logger's own code, we make use of default values for most logging functions. Functions will usually end with a list of arguments that default to these keywords, and you shouldn't need to ever provide a value for these.

struct Logger {

this(LogHandler handler, Level level, string name);

LogBuilder builder();

void log(LogMessage msg);

void log(Level level, string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void log(Level level, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void logF(Level level, T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void trace(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void trace(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void traceF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

LogBuilder traceBuilder();

void debug_(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void debug_(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void debugF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

LogBuilder debugBuilder();

void info(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void info(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void infoF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

LogBuilder infoBuilder();

void warn(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void warn(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void warnF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

LogBuilder warnBuilder();

void error(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void error(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

void errorF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber);

LogBuilder errorBuilder();

}

Constructors

this this(LogHandler handler, Level level, string name): Initializes a new logger. Usually, you won't use this constructor, and instead, you should obtain a Logger via loggerFactory.getLogger().

Members

Functions

builder LogBuilder builder(): Gets a builder that can be used to fluently build a log message.
debugBuilder LogBuilder debugBuilder(): Undocumented in source. Be warned that the author may not have intended to support it.
debugF void debugF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
debug_ void debug_(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
debug_ void debug_(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
error void error(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
error void error(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
errorBuilder LogBuilder errorBuilder(): Undocumented in source. Be warned that the author may not have intended to support it.
errorF void errorF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
info void info(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
info void info(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
infoBuilder LogBuilder infoBuilder(): Undocumented in source. Be warned that the author may not have intended to support it.
infoF void infoF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
log void log(LogMessage msg): Logs a message. Only messages whose level is greater than or equal to this logger's level will be logged.
log void log(Level level, string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Logs a message.
log void log(Level level, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Logs an exception message. It creates a basic message string formatted like "ExceptionName: message".
logF void logF(Level level, T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Logs a formatted string message.
trace void trace(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
trace void trace(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
traceBuilder LogBuilder traceBuilder(): Undocumented in source. Be warned that the author may not have intended to support it.
traceF void traceF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
warn void warn(string msg, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
warn void warn(Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.
warnBuilder LogBuilder warnBuilder(): Undocumented in source. Be warned that the author may not have intended to support it.
warnF void warnF(T args, Exception exception, string[string] attributes, string moduleName, string functionName, string fileName, size_t lineNumber): Undocumented in source. Be warned that the author may not have intended to support it.

Variables

level Level level;: Undocumented in source.
name string name;: Undocumented in source.

Logger

Constructors

Members

Functions

Variables

Meta

Source