Package brave.jms
Class JmsTracing
java.lang.Object
brave.jms.JmsTracing
public final class JmsTracing extends Object
Use this class to decorate your JMS consumer / producer and enable Tracing.
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
JmsTracing.Builder
-
Method Summary
Modifier and Type Method Description javax.jms.Connection
connection(javax.jms.Connection connection)
javax.jms.ConnectionFactory
connectionFactory(javax.jms.ConnectionFactory connectionFactory)
static JmsTracing
create(MessagingTracing messagingTracing)
static JmsTracing
create(Tracing tracing)
javax.jms.MessageListener
messageListener(javax.jms.MessageListener messageListener, boolean addConsumerSpan)
Returns a message listener that optionally starts a consumer span for the message received before wrapping the listener in a separate span.static JmsTracing.Builder
newBuilder(MessagingTracing messagingTracing)
static JmsTracing.Builder
newBuilder(Tracing tracing)
Span
nextSpan(javax.jms.Message message)
Use this to create a span for processing the given message.javax.jms.QueueConnection
queueConnection(javax.jms.QueueConnection connection)
javax.jms.TopicConnection
topicConnection(javax.jms.TopicConnection connection)
javax.jms.XAConnection
xaConnection(javax.jms.XAConnection xaConnection)
javax.jms.XAConnectionFactory
xaConnectionFactory(javax.jms.XAConnectionFactory xaConnectionFactory)
javax.jms.XAQueueConnection
xaQueueConnection(javax.jms.XAQueueConnection connection)
javax.jms.XATopicConnection
xaTopicConnection(javax.jms.XATopicConnection connection)
-
Method Details
-
create
-
create
- Since:
- 5.9
-
newBuilder
-
newBuilder
- Since:
- 5.9
-
connection
public javax.jms.Connection connection(javax.jms.Connection connection) -
queueConnection
public javax.jms.QueueConnection queueConnection(javax.jms.QueueConnection connection) -
topicConnection
public javax.jms.TopicConnection topicConnection(javax.jms.TopicConnection connection) -
xaConnection
public javax.jms.XAConnection xaConnection(javax.jms.XAConnection xaConnection) -
xaQueueConnection
public javax.jms.XAQueueConnection xaQueueConnection(javax.jms.XAQueueConnection connection) -
xaTopicConnection
public javax.jms.XATopicConnection xaTopicConnection(javax.jms.XATopicConnection connection) -
connectionFactory
public javax.jms.ConnectionFactory connectionFactory(javax.jms.ConnectionFactory connectionFactory) -
xaConnectionFactory
public javax.jms.XAConnectionFactory xaConnectionFactory(javax.jms.XAConnectionFactory xaConnectionFactory) -
messageListener
public javax.jms.MessageListener messageListener(javax.jms.MessageListener messageListener, boolean addConsumerSpan)Returns a message listener that optionally starts a consumer span for the message received before wrapping the listener in a separate span.- Parameters:
messageListener
- listener to wrapaddConsumerSpan
- set to true when the underlying message receipt is not traced (ex. JCA)
-
nextSpan
Use this to create a span for processing the given message. Note: the result has no name and is not started.In general, prefer
MessageListener
for processing messages, as it is more efficient and less lossy with regards to context data.This creates a child from identifiers extracted from the message properties, or a new span if one couldn't be extracted.
-