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)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static JmsTracing create(Tracing tracing)

create

public static JmsTracing create(MessagingTracing messagingTracing)

Since:

5.9

newBuilder

public static JmsTracing.Builder newBuilder(Tracing tracing)

newBuilder

public static JmsTracing.Builder newBuilder(MessagingTracing messagingTracing)

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 wrap

addConsumerSpan - set to true when the underlying message receipt is not traced (ex. JCA)

nextSpan

public Span nextSpan(javax.jms.Message message)

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.