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 the qpid::ha module, while e.g. --log-enable debug+:broker::Queue::consumeNextMessage will enable logging of one particular method only (the consumeNextMessage method in the given namespace in this example).
  • PATTERN is often set to the module one needs to debug, like acl, amqp_0_10, broker,ha, management or store.
  • 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+
Report a bug