com.avioconsulting.mule.opentelemetry.internal.store

Interface TransactionStore

All Known Implementing Classes:

InMemoryTransactionStore

public interface TransactionStore

Transaction store for managing service transactions.

Field Summary

Fields

Modifier and Type	Field and Description
static String	TRACE_CONTEXT_MAP_KEY
static String	TRACE_ID
static String	TRACE_TRANSACTION_ID

Method Summary

Modifier and Type	Method and Description
void	addProcessorSpan(String transactionId, String location, io.opentelemetry.api.trace.SpanBuilder spanBuilder) Add a new processor span under an existing transaction.
void	addTransactionTags(String transactionId, String tagPrefix, Map<String,String> tags) Add custom tags to an existing transaction.
default void	endProcessorSpan(String transactionId, String location) End an existing span under an existing transaction.
default void	endProcessorSpan(String transactionId, String location, Consumer<io.opentelemetry.api.trace.Span> spanUpdater) End an existing span under an existing transaction.
void	endProcessorSpan(String transactionId, String location, Consumer<io.opentelemetry.api.trace.Span> spanUpdater, Instant endTime) This overloading allows to end a span at given time.
default void	endTransaction(String transactionId, String rootFlowName) End a transaction represented by provided transaction id and rootFlowName, if exists.
default void	endTransaction(String transactionId, String rootFlowName, Consumer<io.opentelemetry.api.trace.Span> spanUpdater) End a transaction represented by provided transaction id and rootFlowName, if exists.
void	endTransaction(String transactionId, String rootFlowName, Consumer<io.opentelemetry.api.trace.Span> spanUpdater, Instant endTime) End a transaction at given end time.
String	getTraceIdForTransaction(String transactionId) Get the Trace Id associated the transaction
io.opentelemetry.context.Context	getTransactionContext(String transactionId) Get the Context of the initiating flow span.
void	startTransaction(String transactionId, String rootFlowName, io.opentelemetry.api.trace.SpanBuilder rootFlowSpan) Start a new transaction.
default String	transactionIdFor(org.mule.runtime.api.event.Event muleEvent) A default implementation to get a mule correlation id as a local transaction id.

Field Detail

TRACE_TRANSACTION_ID

static final String TRACE_TRANSACTION_ID

See Also:

Constant Field Values

TRACE_CONTEXT_MAP_KEY

static final String TRACE_CONTEXT_MAP_KEY

See Also:

Constant Field Values

TRACE_ID

static final String TRACE_ID

See Also:

Constant Field Values

Method Detail

transactionIdFor

default String transactionIdFor(org.mule.runtime.api.event.Event muleEvent)

A default implementation to get a mule correlation id as a local transaction id.

Parameters:

muleEvent - Event

Returns:

String transaction id

startTransaction

void startTransaction(String transactionId,
                      String rootFlowName,
                      io.opentelemetry.api.trace.SpanBuilder rootFlowSpan)

Start a new transaction. This usually happens when a new source flow starts. If the transaction with `transactionId` already exists but for different rootFlowName, then it is possible that new rootFlowSpan is a child flow invocation. In that case, span may be added to an existing transaction as a span.

Parameters:

transactionId - A unique transaction id within the context of an application. Eg. Correlation id.

rootFlowName - Name of the flow requesting to start transaction.

rootFlowSpan - SpanBuilder for building the root span.

addTransactionTags

void addTransactionTags(String transactionId,
                        String tagPrefix,
                        Map<String,String> tags)

Add custom tags to an existing transaction.

Parameters:

transactionId - A unique transaction id within the context of an application. Eg. Correlation id.

tagPrefix -

tags - Map of String Keys and String Values containing the tags.

getTransactionContext

io.opentelemetry.context.Context getTransactionContext(String transactionId)

Get the Context of the initiating flow span. This may be required to propagate context for a given transaction.

Parameters:

transactionId - A unique transaction id within the context of an application. Eg. Correlation id.

Returns:

Context

getTraceIdForTransaction

String getTraceIdForTransaction(String transactionId)

Get the Trace Id associated the transaction

Parameters:

transactionId - A unique transaction id within the context of an application. Eg. Correlation id.

Returns:

traceId

endTransaction

default void endTransaction(String transactionId,
                            String rootFlowName)

End a transaction represented by provided transaction id and rootFlowName, if exists.

Parameters:

transactionId - A unique transaction id within the context of an application. Eg. Correlation id.

rootFlowName - Name of the flow requesting to start transaction.

endTransaction

default void endTransaction(String transactionId,
                            String rootFlowName,
                            Consumer<io.opentelemetry.api.trace.Span> spanUpdater)

End a transaction represented by provided transaction id and rootFlowName, if exists. Consumer parameter allows updating the Span before ending. This is useful in scenarios like setting processing status code to error.

Here is an example of setting Error when processor execution fails. transactionStore.endTransaction(traceComponent.getTransactionId(), traceComponent.getName(), rootSpan -> { if(notification.getException() != null) { rootSpan.setStatus(StatusCode.ERROR, notification.getException().getMessage()); rootSpan.recordException(notification.getException()); } });

Parameters:

transactionId - A unique transaction id within the context of an application. Eg. Correlation id.

rootFlowName - Name of the flow requesting to start transaction.

spanUpdater - Consumer to allow updating Span before ending.

endTransaction

void endTransaction(String transactionId,
                    String rootFlowName,
                    Consumer<io.opentelemetry.api.trace.Span> spanUpdater,
                    Instant endTime)

End a transaction at given end time. See endTransaction(String, String, Consumer)

Parameters:

transactionId -

rootFlowName -

spanUpdater -

endTime -

addProcessorSpan

void addProcessorSpan(String transactionId,
                      String location,
                      io.opentelemetry.api.trace.SpanBuilder spanBuilder)

Add a new processor span under an existing transaction.

Parameters:

transactionId -

location -

spanBuilder -

endProcessorSpan

default void endProcessorSpan(String transactionId,
                              String location)

End an existing span under an existing transaction.

Parameters:

transactionId -

location -

endProcessorSpan

default void endProcessorSpan(String transactionId,
                              String location,
                              Consumer<io.opentelemetry.api.trace.Span> spanUpdater)

End an existing span under an existing transaction. Consumer parameter allows updating the Span before ending. This is useful in scenarios like setting processing status code to error.

Here is an example of setting Error when processor execution fails. transactionStore.endProcessorSpan(traceComponent.getTransactionId(), traceComponent.getLocation(), s -> { if(notification.getEvent().getError().isPresent()) { Error error = notification.getEvent().getError().get(); s.setStatus(StatusCode.ERROR, error.getDescription()); s.recordException(error.getCause()); } });

Parameters:

transactionId -

location -

spanUpdater - Consumer to allow updating Span before ending.

endProcessorSpan

void endProcessorSpan(String transactionId,
                      String location,
                      Consumer<io.opentelemetry.api.trace.Span> spanUpdater,
                      Instant endTime)

This overloading allows to end a span at given time. See endProcessorSpan(String, String, Consumer).

Parameters:

transactionId -

location -

spanUpdater -

endTime -