qpid-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rob...@apache.org
Subject [2/2] qpid-jms git commit: QPIDJMS-47: add some basic docs around logging and enabling protocol frame tracing
Date Mon, 11 May 2015 13:29:37 GMT
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 <robbie@apache.org>
Authored: Mon May 11 14:15:46 2015 +0100
Committer: Robert Gemmell <robbie@apache.org>
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: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org


Mime
View raw message