Package com.avioconsulting.mule.opentelemetry.internal.connection

Class OpenTelemetryConnection

java.lang.Object

com.avioconsulting.mule.opentelemetry.internal.connection.OpenTelemetryConnection

All Implemented Interfaces:

TraceContextHandler

public class OpenTelemetryConnection
extends Object
implements TraceContextHandler

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OpenTelemetryConnection.HashMapTextMapSetter

Field Summary

Fields

Modifier and Type	Field	Description
Map<String,String>	OTEL_SYSTEM_PROPERTIES_MAP	Collect all otel specific system properties and cache them in a map.
static String	SPAN_ID_LONG
static String	TRACE_ID_LONG_LOW_PART

Method Summary

Modifier and Type	Method	Description
void	addProcessorSpan(TraceComponent traceComponent, String rootContainerName)	Creates a Span for given TraceComponent and adds it to the TraceComponent.getTransactionId() transaction.
SpanMeta	endProcessorSpan(TraceComponent traceComponent, org.mule.runtime.api.message.Error error)
TransactionMeta	endTransaction(TraceComponent traceComponent, Exception exception)
io.opentelemetry.api.metrics.Meter	get(String instrumentationScopeName)
AppIdentifier	getAppIdentifier()
static OpenTelemetryConnection	getInstance()
static OpenTelemetryConnection	getInstance(OpenTelemetryConfigWrapper openTelemetryConfigWrapper)
OpenTelemetryMetricsProviderCollection	getMetricsProviders()
Map<String,String>	getTraceContext(String transactionId)	Get the trace context information for a given transaction id.
Map<String,String>	getTraceContext(String transactionId, org.mule.runtime.api.component.location.ComponentLocation componentLocation)	Get the trace context information for a given transaction id.
<T> io.opentelemetry.context.Context	getTraceContext(T carrier, io.opentelemetry.context.propagation.TextMapGetter<T> textMapGetter)
TransactionStore	getTransactionStore()
<T> void	injectTraceContext(T carrier, io.opentelemetry.context.propagation.TextMapSetter<T> textMapSetter)
void	invalidate()
boolean	isTurnOffTracing()
static void	resetForTest()	This is for tests to reset the static instance in-between the tests.
void	setSpanStatus(TraceComponent traceComponent, io.opentelemetry.api.trace.Span span)
io.opentelemetry.api.trace.SpanBuilder	spanBuilder(String spanName)
void	startTransaction(TraceComponent traceComponent)
static Supplier<OpenTelemetryConnection>	supplier()	Supplier to use with ConnectionProvider where lazy initialization is required.

Methods inherited from class java.lang.Object

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

Field Detail

TRACE_ID_LONG_LOW_PART

public static final String TRACE_ID_LONG_LOW_PART

See Also:

Constant Field Values

SPAN_ID_LONG

public static final String SPAN_ID_LONG

See Also:

Constant Field Values

OTEL_SYSTEM_PROPERTIES_MAP

public final Map<String,String> OTEL_SYSTEM_PROPERTIES_MAP

Collect all otel specific system properties and cache them in a map.

Method Detail

getAppIdentifier

public AppIdentifier getAppIdentifier()

isTurnOffTracing

public boolean isTurnOffTracing()

getMetricsProviders

public OpenTelemetryMetricsProviderCollection getMetricsProviders()

supplier

public static Supplier<OpenTelemetryConnection> supplier()

Supplier to use with ConnectionProvider where lazy initialization is required.

Returns:

a non-null Supplier<OpenTelemetryConnection>

resetForTest

public static void resetForTest()

This is for tests to reset the static instance in-between the tests. Reset Global OpenTelemetry instances.

getInstance

public static OpenTelemetryConnection getInstance(OpenTelemetryConfigWrapper openTelemetryConfigWrapper)

getInstance

public static OpenTelemetryConnection getInstance()

spanBuilder

public io.opentelemetry.api.trace.SpanBuilder spanBuilder(String spanName)

getTraceContext

public <T> io.opentelemetry.context.Context getTraceContext(T carrier,
                                                            io.opentelemetry.context.propagation.TextMapGetter<T> textMapGetter)

Specified by:

getTraceContext in interface TraceContextHandler

getTraceContext

public Map<String,String> getTraceContext(String transactionId)

Get the trace context information for a given transaction id. This returns a Map with at least one entry with key TransactionStore.TRACE_TRANSACTION_ID and transactionId as value. The other entries in the map depends on the propagator used. For W3C Trace Context Propagator, it can contain entries for `traceparent` and optionally `tracestate`.

Parameters:

transactionId - Local transaction id

Returns:

Map

getTraceContext

public Map<String,String> getTraceContext(String transactionId,
                                                org.mule.runtime.api.component.location.ComponentLocation componentLocation)

Get the trace context information for a given transaction id. This returns a Map with at least one entry with key TransactionStore.TRACE_TRANSACTION_ID and transactionId as value. The other entries in the map depends on the propagator used.

For W3C Trace Context Propagator, it can contain entries for `traceparent` and optionally `tracestate`.

Parameters:

transactionId - Local transaction id

componentLocation - ComponentLocation to get context for

Returns:

Map

injectTraceContext

public <T> void injectTraceContext(T carrier,
                                   io.opentelemetry.context.propagation.TextMapSetter<T> textMapSetter)

Specified by:

injectTraceContext in interface TraceContextHandler

getTransactionStore

public TransactionStore getTransactionStore()

invalidate

public void invalidate()

get

public io.opentelemetry.api.metrics.Meter get(String instrumentationScopeName)

addProcessorSpan

public void addProcessorSpan(TraceComponent traceComponent,
                             String rootContainerName)

Creates a Span for given TraceComponent and adds it to the TraceComponent.getTransactionId() transaction.

Parameters:

traceComponent - TraceComponent

rootContainerName - String name of the container such as flow that holds this component

endProcessorSpan

public SpanMeta endProcessorSpan(TraceComponent traceComponent,
                                 org.mule.runtime.api.message.Error error)

startTransaction

public void startTransaction(TraceComponent traceComponent)

endTransaction

public TransactionMeta endTransaction(TraceComponent traceComponent,
                                      Exception exception)

setSpanStatus

public void setSpanStatus(TraceComponent traceComponent,
                          io.opentelemetry.api.trace.Span span)