io.lettuce.core.tracing

Class MicrometerTracing

java.lang.Object

io.lettuce.core.tracing.MicrometerTracing

All Implemented Interfaces:

Tracing

public class MicrometerTracing
extends Object
implements Tracing

Tracing adapter using Micrometer's Observation. This adapter integrates with Micrometer to propagate observations into timers, distributed traces and any other registered handlers. Observations include a set of tags capturing Redis runtime information.

Capturing full statements

This adapter can capture full statements when enabling includeCommandArgsInSpanTags. You should carefully consider the impact of this setting as all command arguments will be captured in traces including these that may contain sensitive details.

Since:

6.3

Author:

Mark Paluch

Nested Class Summary

Nested classes/interfaces inherited from interface io.lettuce.core.tracing.Tracing

Tracing.Endpoint

Constructor Summary

Constructors

Constructor and Description
MicrometerTracing(io.micrometer.observation.ObservationRegistry observationRegistry, String serviceName) Create a new MicrometerTracing instance.
MicrometerTracing(io.micrometer.observation.ObservationRegistry observationRegistry, String serviceName, boolean includeCommandArgsInSpanTags) Create a new MicrometerTracing instance.
MicrometerTracing(io.micrometer.observation.ObservationRegistry observationRegistry, String serviceName, LettuceObservationConvention convention) Create a new MicrometerTracing instance.

Method Summary

Modifier and Type	Method and Description
Tracing.Endpoint	createEndpoint(SocketAddress socketAddress) Create an Tracing.Endpoint given SocketAddress.
TracerProvider	getTracerProvider()
boolean	includeCommandArgsInSpanTags() Returns true if tags for Tracer.Spans should include the command arguments.
TraceContextProvider	initialTraceContextProvider()
boolean	isEnabled() Returns true if tracing is enabled.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.lettuce.core.tracing.Tracing

clearContext, disabled, getContext, withTraceContextProvider

Constructor Detail

MicrometerTracing

public MicrometerTracing(io.micrometer.observation.ObservationRegistry observationRegistry,
                         String serviceName)

Create a new MicrometerTracing instance.

Parameters:

observationRegistry - must not be null.

serviceName - service name to be used.

MicrometerTracing

public MicrometerTracing(io.micrometer.observation.ObservationRegistry observationRegistry,
                         String serviceName,
                         boolean includeCommandArgsInSpanTags)

Create a new MicrometerTracing instance.

Parameters:

observationRegistry - must not be null.

serviceName - service name to be used.

includeCommandArgsInSpanTags - whether to attach the full command into the trace. Use this flag with caution as sensitive arguments will be captured in the observation spans and metric tags.

MicrometerTracing

public MicrometerTracing(io.micrometer.observation.ObservationRegistry observationRegistry,
                         String serviceName,
                         LettuceObservationConvention convention)

Create a new MicrometerTracing instance.

Parameters:

observationRegistry - must not be null.

serviceName - service name to be used.

convention - the observation convention to use

Method Detail

getTracerProvider

public TracerProvider getTracerProvider()

Specified by:

getTracerProvider in interface Tracing

Returns:

the TracerProvider.

initialTraceContextProvider

public TraceContextProvider initialTraceContextProvider()

Specified by:

initialTraceContextProvider in interface Tracing

Returns:

the TraceContextProvider supplying the initial TraceContext (i.e. if there is no active span).

isEnabled

public boolean isEnabled()

Description copied from interface: Tracing

Returns true if tracing is enabled.

Specified by:

isEnabled in interface Tracing

Returns:

true if tracing is enabled.

includeCommandArgsInSpanTags

public boolean includeCommandArgsInSpanTags()

Description copied from interface: Tracing

Returns true if tags for Tracer.Spans should include the command arguments.

Specified by:

includeCommandArgsInSpanTags in interface Tracing

Returns:

true if tags for Tracer.Spans should include the command arguments.

createEndpoint

public Tracing.Endpoint createEndpoint(SocketAddress socketAddress)

Description copied from interface: Tracing

Create an Tracing.Endpoint given SocketAddress.

Specified by:

createEndpoint in interface Tracing

Parameters:

socketAddress - the remote address.

Returns:

the Tracing.Endpoint for SocketAddress.