Package org.springframework.cloud.sleuth.instrument.messaging

Class TracingChannelInterceptor

java.lang.Object

org.springframework.cloud.sleuth.instrument.messaging.TracingChannelInterceptor

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware, org.springframework.messaging.support.ChannelInterceptor, org.springframework.messaging.support.ExecutorChannelInterceptor

public final class TracingChannelInterceptor
extends Object
implements org.springframework.messaging.support.ExecutorChannelInterceptor, org.springframework.context.ApplicationContextAware

This starts and propagates Span.Kind.PRODUCER span for each message sent (via native headers. It also extracts or creates a Span.Kind.CONSUMER span for each message received. This span is injected onto each message so it becomes the parent when a handler later calls MessageHandler.handleMessage(Message).

Since:

3.0.0

Author:

Marcin Grzejszczak, Artem Bilan

Field Summary

Fields

Modifier and Type	Field	Description
static String	STREAM_DIRECT_CHANNEL	Name of the class in Spring Cloud Stream that is a direct channel.

Constructor Summary

Constructors

Constructor	Description
TracingChannelInterceptor(Tracer tracer, Propagator propagator, Propagator.Setter<org.springframework.messaging.support.MessageHeaderAccessor> setter, Propagator.Getter<org.springframework.messaging.support.MessageHeaderAccessor> getter, Function<String,String> remoteServiceNameMapper, MessageSpanCustomizer messageSpanCustomizer)

Method Summary

Modifier and Type	Method	Description
void	afterMessageHandled(org.springframework.messaging.Message<?> message, org.springframework.messaging.MessageChannel channel, org.springframework.messaging.MessageHandler handler, Exception ex)
void	afterReceiveCompletion(org.springframework.messaging.Message<?> message, org.springframework.messaging.MessageChannel channel, Exception ex)
void	afterSendCompletion(org.springframework.messaging.Message<?> message, org.springframework.messaging.MessageChannel channel, boolean sent, Exception ex)
org.springframework.messaging.Message<?>	beforeHandle(org.springframework.messaging.Message<?> message, org.springframework.messaging.MessageChannel channel, org.springframework.messaging.MessageHandler handler)	This starts a consumer span as a child of the incoming message or the current trace context.
org.springframework.messaging.Message<?>	postReceive(org.springframework.messaging.Message<?> message, org.springframework.messaging.MessageChannel channel)	This starts a consumer span as a child of the incoming message or the current trace context, placing it in scope until the receive completes.
org.springframework.messaging.Message<?>	preSend(org.springframework.messaging.Message<?> message, org.springframework.messaging.MessageChannel channel)	Starts and propagates Span.Kind.PRODUCER span for each message sent.
void	setApplicationContext(org.springframework.context.ApplicationContext applicationContext)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.messaging.support.ChannelInterceptor

postSend, preReceive

Field Detail

STREAM_DIRECT_CHANNEL

public static final String STREAM_DIRECT_CHANNEL

Name of the class in Spring Cloud Stream that is a direct channel.

See Also:

Constant Field Values

Constructor Detail

TracingChannelInterceptor

public TracingChannelInterceptor(Tracer tracer,
                                 Propagator propagator,
                                 Propagator.Setter<org.springframework.messaging.support.MessageHeaderAccessor> setter,
                                 Propagator.Getter<org.springframework.messaging.support.MessageHeaderAccessor> getter,
                                 Function<String,String> remoteServiceNameMapper,
                                 MessageSpanCustomizer messageSpanCustomizer)

Method Detail

setApplicationContext

public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
                           throws org.springframework.beans.BeansException

Specified by:

setApplicationContext in interface org.springframework.context.ApplicationContextAware

Throws:

org.springframework.beans.BeansException

preSend

public org.springframework.messaging.Message<?> preSend(org.springframework.messaging.Message<?> message,
                                                        org.springframework.messaging.MessageChannel channel)

Starts and propagates Span.Kind.PRODUCER span for each message sent.

Specified by:

preSend in interface org.springframework.messaging.support.ChannelInterceptor

afterSendCompletion

public void afterSendCompletion(org.springframework.messaging.Message<?> message,
                                org.springframework.messaging.MessageChannel channel,
                                boolean sent,
                                Exception ex)

Specified by:

afterSendCompletion in interface org.springframework.messaging.support.ChannelInterceptor

postReceive

public org.springframework.messaging.Message<?> postReceive(org.springframework.messaging.Message<?> message,
                                                            org.springframework.messaging.MessageChannel channel)

This starts a consumer span as a child of the incoming message or the current trace context, placing it in scope until the receive completes.

Specified by:

postReceive in interface org.springframework.messaging.support.ChannelInterceptor

afterReceiveCompletion

public void afterReceiveCompletion(org.springframework.messaging.Message<?> message,
                                   org.springframework.messaging.MessageChannel channel,
                                   Exception ex)

Specified by:

afterReceiveCompletion in interface org.springframework.messaging.support.ChannelInterceptor

beforeHandle

public org.springframework.messaging.Message<?> beforeHandle(org.springframework.messaging.Message<?> message,
                                                             org.springframework.messaging.MessageChannel channel,
                                                             org.springframework.messaging.MessageHandler handler)

This starts a consumer span as a child of the incoming message or the current trace context. It then creates a span for the handler, placing it in scope.

Specified by:

beforeHandle in interface org.springframework.messaging.support.ExecutorChannelInterceptor

afterMessageHandled

public void afterMessageHandled(org.springframework.messaging.Message<?> message,
                                org.springframework.messaging.MessageChannel channel,
                                org.springframework.messaging.MessageHandler handler,
                                Exception ex)

Specified by:

afterMessageHandled in interface org.springframework.messaging.support.ExecutorChannelInterceptor