fish.payara.nucleus.requesttracing

Class RequestTracingService

java.lang.Object

fish.payara.nucleus.requesttracing.RequestTracingService

All Implemented Interfaces:

MonitoringDataSource, EventListener, ConfigListener

@Service(name="requesttracing-service")
 @RunLevel(value=10)
public class RequestTracingService
extends Object
implements EventListener, ConfigListener, MonitoringDataSource

Main service class that provides methods used by interceptors for tracing requests.

Since:

4.1.1.163

Author:

mertcaliskan

Nested Class Summary

Nested classes/interfaces inherited from interface org.glassfish.api.event.EventListener

EventListener.Event<T>

Field Summary

Fields

Modifier and Type	Field and Description
static String	EVENT_BUS_LISTENER_NAME

Constructor Summary

Constructors

Constructor and Description
RequestTracingService()

Method Summary

Modifier and Type	Method and Description
void	addSpanLog(RequestTraceSpanLog spanLog)
void	bootstrapNotifierList() Configures notifiers with request tracing and starts any enabled ones.
void	bootstrapRequestTracingService() Starts the request tracing service
UnprocessedChangeEvents	changed(PropertyChangeEvent[] events) Notification that @Configured objects that were injected have changed
void	collect(MonitoringDataCollector rootCollector) Collects all the data points of this at the current moment.
void	endTrace()
void	event(EventListener.Event event) Process a Glassfish/Payara event
UUID	getConversationID() Retrieves the current Conversation ID
RequestTracingExecutionOptions	getExecutionOptions()
RequestTraceStoreInterface	getHistoricRequestTraceStore() Returns the RequestTraceStore used for storing historical traces
RequestTraceStoreInterface	getRequestTraceStore() Returns the RequestTraceStore used for storing traces
UUID	getStartingTraceID()
Long	getThresholdValueInNanos()
boolean	isRequestTracingEnabled()
boolean	isTraceInProgress() Returns true if a trace has started and not yet completed.
void	setTraceId(UUID newID) Reset the conversation ID This is especially useful for trace propagation across threads when the event tracer can receive the conversation ID propagated to it
RequestTraceSpan	startTrace(RequestTraceSpan span)
RequestTraceSpan	startTrace(RequestTraceSpan span, long timestampMillis)
RequestTraceSpan	startTrace(String traceName) Starts a new request trace
RequestTraceSpan	startTrace(UUID propagatedTraceId, UUID propagatedParentId, RequestTraceSpan.SpanContextRelationshipType propagatedRelationshipType, String traceName)
void	traceSpan(RequestTraceSpan requestEvent) Adds a new event to the request trace currently in progress
void	traceSpan(RequestTraceSpan requestEvent, long timestampMillis)

Methods inherited from class java.lang.Object

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

Field Detail

EVENT_BUS_LISTENER_NAME

public static final String EVENT_BUS_LISTENER_NAME

See Also:

Constant Field Values

Constructor Detail

RequestTracingService

public RequestTracingService()

Method Detail

event

public void event(EventListener.Event event)

Description copied from interface: EventListener

Process a Glassfish/Payara event

Specified by:

event in interface EventListener

bootstrapRequestTracingService

public void bootstrapRequestTracingService()

Starts the request tracing service

Since:

4.1.1.171

bootstrapNotifierList

public void bootstrapNotifierList()

Configures notifiers with request tracing and starts any enabled ones. If no options are set then the log notifier is automatically turned on.

Since:

4.1.2.173

getConversationID

public UUID getConversationID()

Retrieves the current Conversation ID

Returns:

getStartingTraceID

public UUID getStartingTraceID()

setTraceId

public void setTraceId(UUID newID)

Reset the conversation ID This is especially useful for trace propagation across threads when the event tracer can receive the conversation ID propagated to it

Parameters:

newID -

isTraceInProgress

public boolean isTraceInProgress()

Returns true if a trace has started and not yet completed. NOTE: This only applies to traces started using the request tracing service; traces started using OpenTracing *MAY* not be picked up by this (for example, if you're using the OpenTracing MockTracer instead of the in-built one).

Returns:

startTrace

public RequestTraceSpan startTrace(String traceName)

Starts a new request trace

Returns:

a unique identifier for the request trace

startTrace

public RequestTraceSpan startTrace(RequestTraceSpan span)

startTrace

public RequestTraceSpan startTrace(RequestTraceSpan span,
                                   long timestampMillis)

startTrace

public RequestTraceSpan startTrace(UUID propagatedTraceId,
                                   UUID propagatedParentId,
                                   RequestTraceSpan.SpanContextRelationshipType propagatedRelationshipType,
                                   String traceName)

traceSpan

public void traceSpan(RequestTraceSpan requestEvent)

Adds a new event to the request trace currently in progress

Parameters:

requestEvent -

traceSpan

public void traceSpan(RequestTraceSpan requestEvent,
                      long timestampMillis)

endTrace

public void endTrace()

addSpanLog

public void addSpanLog(RequestTraceSpanLog spanLog)

getThresholdValueInNanos

public Long getThresholdValueInNanos()

Returns:

Since:

4.1.1.164

isRequestTracingEnabled

public boolean isRequestTracingEnabled()

getExecutionOptions

public RequestTracingExecutionOptions getExecutionOptions()

changed

public UnprocessedChangeEvents changed(PropertyChangeEvent[] events)

Description copied from interface: ConfigListener

Notification that @Configured objects that were injected have changed

Specified by:

changed in interface ConfigListener

Parameters:

events - list of changes

Returns:

the list of unprocessed events (requiring a restart) or null if all reconfiguration was processed successfully

getHistoricRequestTraceStore

public RequestTraceStoreInterface getHistoricRequestTraceStore()

Returns the RequestTraceStore used for storing historical traces

Returns:

getRequestTraceStore

public RequestTraceStoreInterface getRequestTraceStore()

Returns the RequestTraceStore used for storing traces

Returns:

collect

public void collect(MonitoringDataCollector rootCollector)

Description copied from interface: MonitoringDataSource

Collects all the data points of this at the current moment.

Specified by:

collect in interface MonitoringDataSource

Parameters:

rootCollector - the MonitoringDataCollector instance to use to collect the data points of this source