Package brave.jms

Class 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

      All Methods Static Methods Instance Methods Concrete Methods 
      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)

      • 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.