Logging can be an important tool to monitor your server’s health and performance. Logging may be controlled and customized on a per-component basis.
A logging
bean has been implemented to allow more fine configuration of each component.
logging () { rootLevel = CONFIG 'packet-debug-full' = true loggers = { 'tigase.server' = { level = ALL } 'tigase.conf' = { level = FINEST } } handlers = { ' java.util.logging.FileHandler' = { level = ALL append = true count = 5 formatter = 'tigase.util.LogFormatter' limit = 10000000 pattern = 'logs/tigase.log' } 'java.util.logging.ConsoleHandler' = { level = WARNING formatter = 'tigase.util.LogFormatter' } } }
You only need to specify the settings you wish to customize, otherwise they will be left as default.
packet-debug-full
- controls whether log entries should be obfuscated (all CData of all elements will be replaced by CData size: <length in bytes of the replaced string>
) or not; default: false
.rootLevel
- Defines the root level of logging for all components not otherwise defined. Default is CONFIGloggers
- Defines the level of logging for packages running in tigase server. This is similar to the --debug setting, however you must use tigase.{package}
format. Default is NONE.handlers
- Defines the level of logging for File output and Console output.
FileHandler
- is the file output for log files, with the following options:
level
- specifies the level of logs to be written, default is ALL.append
- whether to append to the log or replace it during restart. Default is true.count
- number of individual log files to keep at set limit. Default is 5. (default settings will continue appending logs until 5 files at 10MB are reached, then the oldest file will be overwritten.)formatter
- specifies the package to format logging output. Default is tigase.util.LogFormatter.limit
- Byte limit for each log file. Default is 10000000 or 10MB.pattern
- Directory and filename of the log file with respect to the Tigase installation directory. Default is logs/tigase.log.ConsoleHandler
- Determines the formatting for Tigase output to console.
level
- specifies the level of logs to be written, default is WARNING.formatter
- specifies the package to format logging output. Default is tigase.util.LogFormatter.