Package brave.jms

Class JmsTracing

java.lang.Object

brave.jms.JmsTracing

public final class JmsTracing
extends java.lang.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(brave.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(brave.Tracing tracing)
brave.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(brave.Tracing tracing)

newBuilder

public static JmsTracing.Builder newBuilder(brave.Tracing tracing)

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 brave.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 message, or a new span if one couldn't be extracted.