|Version 6 (modified by 8 years ago) ( diff ),|
S3Log is a simple global logging facility for Sahana Eden.
The logger is called like:
current.log.error("Something went wrong", value="Example")
Which gives a log entry like:
2014-02-16 11:58:41 S3LOG ERROR: Something went wrong: Example
The logger functions correspond to the severity level of the message:
- current.log.critical() (highest)
- current.log.debug() (lowest)
The call signature of all logger functions is identical with the example above. The "value" parameter is optional.
The logger can be configured in models/000_config:
# Configure the log level ("DEBUG", "INFO", "WARNING", "ERROR" or "CRITICAL"), None = turn off logging #settings.log.level = None # Uncomment to write log messages to the console (sys.stderr) #settings.log.console = True # Configure a log file (file name) #settings.log.logfile = None # Uncomment to get detailed caller information #settings.log.caller_info = True
settings.log.level = "DEBUG"
determines the minimum severity level at which messages will be logged.
- CRITICAL (highest)
- DEBUG (lowest)
- None turns all logging off.
settings.log.console = True
enables logging to the system error console (sys.stderr). False disables console logging. Console logging can be enabled in parallel with file logging.
settings.log.logfile = "/var/log/eden.log"
enables logging to the specified file. The logger rotates 3 log files with a maximum size of 1MB: /var/log/eden.log, /var/log/eden.log.1 and /var/log/eden.log.2 None disables logging to file. File logging can be enabled in parallel with console logging.
settings.log.caller_info = True
the log messages will include information about the origin of the log message (file name, line number, function name):
2014-02-16 11:58:23 (applications/eden/modules/s3/s3rest.py 477 __init__) ERROR: Something went wrong: Example