Chapter 11. Configuring logging

Procedure

1. In the /etc/qpid-dispatch/qdrouterd.conf configuration file, add a log section to set the default logging properties:

   This example configures all logging modules to log events starting at the info level:

   log {
       module: DEFAULT
       enable: info+
       includeTimestamp: yes
   }

   module

   Specify DEFAULT.

   enable

   The logging level. You can specify any of the following levels (from lowest to highest):

   • trace - provides the most information, but significantly affects system performance
   • debug - useful for debugging, but affects system performance
   • info - provides general information without affecting system performance
   • notice - provides general information, but is less verbose than info
   • warning - provides information about issues you should be aware of, but which are not errors
   • error - error conditions that you should address
   • critical - critical system issues that you must address immediately

   To specify multiple levels, use a comma-separated list. You can also use + to specify a level and all levels above it. For example, trace,debug,warning+ enables trace, debug, warning, error, and critical levels. For default logging, you should typically use the info+ or notice+ level. These levels will provide general information, warnings, and errors for all modules without affecting the performance of AMQ Interconnect.

   includeTimestamp

   Set this to yes to include the timestamp in all logs.

   For information about additional log attributes, see log in the qdrouterd.conf man page.

2. If you want to configure non-default logging for any of the logging modules, add an additional log section for each module that should not follow the default.

   This example configures the ROUTER logging module to log debug events:

   log {
       module: ROUTER
       enable: debug
       includeTimestamp: yes
   }