Log (Sirius Kernel 2.9 API)

java.lang.Object
- sirius.kernel.health.Log

```
public class Log
extends Object
```
The logging facade used by the system.
Note: Instead of "just" logging exceptions, handle them with Exceptions.handle() to generate sophisticated error messages and to permit other parts of the framework to intercept error handling.
In contrast to other approaches, it is not recommended to create a logger per class, but rather one per framework or sub system. It should have a concise name, all lowercase without any dots. The log level of each logger is read from the configuration using logging.[NAME]. It may be set to one of:
- DEBUG
- INFO
- WARN
- ERROR
Internally uses log4j to perform all logging operations. Still it is recommended to only log through this facade and not to rely on any log4j specific behaviour.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static org.apache.log4j.Level`	`convertJuliLevel(Level juliLevel)` Converts a given java.util.logging.Level to a log4j level.
`static Level`	`convertLog4jLevel(org.apache.log4j.Level log4jLevel)` Converts a given log4j to a java.util.logging.Level level.
`void`	`DEBUG_INFO(Object msg)` Used to log the given message `msg` at INFO level if debug mode is enabled (`Sirius.isDev()`).
`void`	`FINE(Object msg)` Logs the given message at the FINE level The given object is converted to a string if necessary.
`void`	`FINE(String msg, Object... params)` Formats the given message at the FINE level using the supplied parameters.
`static Log`	`get(String name)` Generates a new logger with the given name The given name should be short and simple.
`static List<Log>`	`getAllLoggers()` Returns a list of all known loggers.
`String`	`getName()` Returns the name of this logger
`void`	`INFO(Object msg)` Logs the given message at INFO level The given object is converted to a string if necessary.
`void`	`INFO(String msg, Object... params)` Formats the given message at the INFO level using the supplied parameters.
`boolean`	`isFINE()` Determines if FINE message will be logged.
`static void`	`setLevel(String logger, org.apache.log4j.Level level)` Helper method the change the log-level for a given logger.
`void`	`SEVERE(Object msg)` Logs the given message at the SEVERE or ERROR level The given object is converted to a string if necessary.
`void`	`WARN(Object msg)` Logs the given message at the WARN level The given object is converted to a string if necessary.
`void`	`WARN(String msg, Object... params)` Formats the given message at the WARN level using the supplied parameters.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - get
```
public static Log get(String name)
```
    Generates a new logger with the given name
    The given name should be short and simple. It is not recommended to create a logger per class but one for each framework or subsystem.
    
    Parameters:
    
    name - the name of the logger. This should be a simple name, completely lowercase, without any dots
    
    Returns:
    
    a new logger logging with the given name.
  - getAllLoggers
```
public static List<Log> getAllLoggers()
```
    Returns a list of all known loggers.
    
    Returns:
    
    a list of all known loggers
  - setLevel
```
public static void setLevel(String logger,
                            org.apache.log4j.Level level)
```
    Helper method the change the log-level for a given logger.
    By default the system configuration is used to set the leg level (logging.[name]=LEVEL). Also the "logger" command in the console can be used to change the log level at runtime.
    
    Parameters:
    
    logger - the name of the logger to change
    
    level - the desired log level
  - convertJuliLevel
```
public static org.apache.log4j.Level convertJuliLevel(Level juliLevel)
```
    Converts a given java.util.logging.Level to a log4j level.
    
    Parameters:
    
    juliLevel - the java.util.logging level
    
    Returns:
    
    the converted equivalent for log4j
  - convertLog4jLevel
```
public static Level convertLog4jLevel(org.apache.log4j.Level log4jLevel)
```
    Converts a given log4j to a java.util.logging.Level level.
    
    Parameters:
    
    log4jLevel - the log4j level
    
    Returns:
    
    the converted equivalent java.util.logging
  - INFO
```
public void INFO(Object msg)
```
    Logs the given message at INFO level
    The given object is converted to a string if necessary. The INFO level should be used for informative messages to the system operator which occur at a low rate
    
    Parameters:
    
    msg - the message to be logged
  - DEBUG_INFO
```
public void DEBUG_INFO(Object msg)
```
    Used to log the given message msg at INFO level if debug mode is enabled (Sirius.isDev()). Otherwise the message will be logged as FINE.
    
    Parameters:
    
    msg - the message to log
  - INFO
```
public void INFO(String msg,
                 Object... params)
```
    Formats the given message at the INFO level using the supplied parameters.
    The INFO level should be used for informative messages to the system operator which occur at a low rate
    
    Parameters:
    
    msg - the message containing placeholders as understood by Strings.apply(String, Object...)
    
    params - the parameters used to format the resulting log message
  - FINE
```
public void FINE(Object msg)
```
    Logs the given message at the FINE level
    The given object is converted to a string if necessary. The FINE level can be used for in depth debug or trace messages used when developing a system. Sill the rate should be kept bearable to enable this level in production systems to narrow down errors.
    
    Parameters:
    
    msg - the message to be logged
  - FINE
```
public void FINE(String msg,
                 Object... params)
```
    Formats the given message at the FINE level using the supplied parameters.
    The FINE level can be used for in depth debug or trace messages used when developing a system. Sill the rate should be kept bearable to enable this level in production systems to narrow down errors.
    
    Parameters:
    
    msg - the message containing placeholders as understood by Strings.apply(String, Object...)
    
    params - the parameters used to format the resulting log message
  - WARN
```
public void WARN(Object msg)
```
    Logs the given message at the WARN level
    The given object is converted to a string if necessary. The WARN level can be used to signal unexpected situations which do not (yet) result in an error or problem.
    
    Parameters:
    
    msg - the message to be logged
  - WARN
```
public void WARN(String msg,
                 Object... params)
```
    Formats the given message at the WARN level using the supplied parameters.
    The WARN level can be used to signal unexpected situations which do not (yet) result in an error or problem.
    
    Parameters:
    
    msg - the message containing placeholders as understood by Strings.apply(String, Object...)
    
    params - the parameters used to format the resulting log message
  - SEVERE
```
public void SEVERE(Object msg)
```
    Logs the given message at the SEVERE or ERROR level
    The given object is converted to a string if necessary. The ERROR level can be used to signal problems or error which occurred in the system. It is recommended to handle exceptions using Exceptions - which will eventually also call this method, but provides sophisticated error handling.
    
    Parameters:
    
    msg - the message to be logged
  - isFINE
```
public boolean isFINE()
```
    Determines if FINE message will be logged.
    This can be used to decide whether "expensive" log messages should be constructed at all. Using FINE(String, Object...) doesn't require this check since the message is only formatted if it will be logged. However, if the computation of one of the parameters is complex, one might sill want to surround the log message by an appropriate if statement calling this method.
    
    Returns:
    
    true if this logger logs FINE message, false otherwise
  - getName
```
public String getName()
```
    Returns the name of this logger
    
    Returns:
    
    the name supplied by get(String).

Class Log

Method Summary

Methods inherited from class java.lang.Object

Method Detail

get

getAllLoggers

setLevel

convertJuliLevel

convertLog4jLevel

INFO

DEBUG_INFO

INFO

FINE

FINE

WARN

WARN

SEVERE

isFINE

getName