QPIDJMS-47: add some basic docs around logging and enabling protocol frame tracing
Project: http://git-wip-us.apache.org/repos/asf/qpid-jms/repo Commit: http://git-wip-us.apache.org/repos/asf/qpid-jms/commit/729162d5 Tree: http://git-wip-us.apache.org/repos/asf/qpid-jms/tree/729162d5 Diff: http://git-wip-us.apache.org/repos/asf/qpid-jms/diff/729162d5 Branch: refs/heads/master Commit: 729162d5bb06884a002f34e557da45785c9e72c4 Parents: 6e32ccd Author: Robert Gemmell <[email protected]> Authored: Mon May 11 14:15:46 2015 +0100 Committer: Robert Gemmell <[email protected]> Committed: Mon May 11 14:15:46 2015 +0100 ---------------------------------------------------------------------- qpid-jms-docs/Configuration.md | 10 ++++++++++ 1 file changed, 10 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/qpid-jms/blob/729162d5/qpid-jms-docs/Configuration.md ---------------------------------------------------------------------- diff --git a/qpid-jms-docs/Configuration.md b/qpid-jms-docs/Configuration.md index ea49af1..368b6c7 100644 --- a/qpid-jms-docs/Configuration.md +++ b/qpid-jms-docs/Configuration.md @@ -160,3 +160,13 @@ The complete set of configuration options for failover is listed below: These options apply to the behaviour of certain AMQP functionality. + **amqp.idleTimeout** Controls the idle timeout in milliseconds after which the connection will be failed if the peer sends no AMQP frames. Default is 60000. + +## Logging + +The client makes use of the SLF4J API, allowing users to select a particular logging implementation based on their needs by supplying a SLF4J 'Binding', such as *slf4j-log4j*. More details on SLF4J are available from http://www.slf4j.org/. + +The client uses Logger names residing within the *org.apache.qpid.jms* heirarchy, which you can use to configure a logging implementation based on your needs. + +When debugging some issues, it may sometimes be useful to enable additional protocol trace logging from the Qpid Proton AMQP 1.0 library. There are two options to achieve this: ++ Set the environment variable (not Java system property) *PN_TRACE_FRM* to true, which will cause Proton to emit frame logging to stdout. ++ Add the option amqp.traceFrames=true to your connection URI to have the client add a protocol tracer to Proton, and configure the *org.apache.qpid.jms.provider.amqp.FRAMES* Logger to *TRACE* level to include the output in your logs. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
