7.2. Change Broker Logging Verbosity
- Changes
- New content - added February 2013.
When running qpidd from command line, use
--log-enable
option with the syntax:
--log-enable LEVEL[+][:PATTERN]
When using a configuration file (
/etc/qpid/qpidd.conf
by default), use the line:
log-enable=LEVEL[+][:PATTERN]
Notes
LEVEL
is one of:trace debug info notice warning error critical
.- The "
+
" means log the given severity and any higher severity (without the plus, logging of the given severity only will be enabled). PATTERN
is the scope of the logging change.- The string in
PATTERN
is matched against the fully-qualified name of the C++ function with the logging statement. - To see the fully-qualified name of the C++ function with the logging statement, either check the source code or add to the qpid configuration the
log-function=yes
option to force qpid broker to log such message. - So e.g.
--log-enable debug+:
ha
matches everything in theqpid::
ha
module, while e.g.--log-enable debug+:broker::Queue::consumeNextMessage
will enable logging of one particular method only (theconsumeNextMessage
method in the given namespace in this example). PATTERN
is often set to the module one needs to debug, likeacl
,amqp_0_10
,broker
,ha
,management
orstore
.- The option can be used multiple times.
- Be aware that having just one option like "
log-enable=debug+:
ha
" enables debug logs of ha information, but does not produce any other logs; to add some more verbose logging, add an option like the above and also add the default value:log-enable=info+