Package io.honeycomb.beeline.tracing

Class SendingSpan

java.lang.Object

io.honeycomb.beeline.tracing.Span

io.honeycomb.beeline.tracing.SendingSpan

All Implemented Interfaces:

AutoCloseable

public class SendingSpan
extends Span

Implements close with the ability to send Spans to Honeycomb using the Event returned by the configured SpanPostProcessor, which adds the standard fields that are required for Honeycomb to recognise an Event as a Span.

Close must only be called once, and subsequent invocations will be ignored.

If you need to construct Spans of this type, you can make use SpanBuilderFactory.

Thread-safety

Instances of this class are not thread-safe.

Constructor Summary

Constructors

Constructor	Description
SendingSpan(String spanName, String serviceName, String spanId, Map<String,?> fields, PropagationContext context, SpanPostProcessor processor, io.honeycomb.libhoney.transport.batch.ClockProvider clock, int initialSampleRate)

Method Summary

Modifier and Type	Method	Description
protected void	closeInternal()	Closes the span by generating an Event using the configured SpanPostProcessor, adding required fields, applying the sampling hook, and, if sampled, sends it to Honeycomb.
int	getInitialSampleRate()	Returns the initial sample rate.
protected SpanPostProcessor	getProcessor()	Getter for the processor, in case future development needs access to it.

Methods inherited from class java.lang.Object

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

Methods inherited from class io.honeycomb.beeline.tracing.Span

addField, addFields, addTraceField, addTraceFields, close, elapsedTimeMs, getDataset, getFields, getNoopInstance, getParentSpanId, getServiceName, getSpanId, getSpanName, getStartTime, getTimestamp, getTraceContext, getTraceFields, getTraceId, isNoop, markStart, markStart, toString

Constructor Detail

SendingSpan

public SendingSpan(String spanName,
                   String serviceName,
                   String spanId,
                   Map<String,?> fields,
                   PropagationContext context,
                   SpanPostProcessor processor,
                   io.honeycomb.libhoney.transport.batch.ClockProvider clock,
                   int initialSampleRate)

Method Detail

closeInternal

protected void closeInternal()

Closes the span by generating an Event using the configured SpanPostProcessor, adding required fields, applying the sampling hook, and, if sampled, sends it to Honeycomb.

The event's sampling rate is set to the product of the initialSampleRate and the sampling rate returned by SpanPostProcessor.runSamplerHook(Span).

Overrides:

closeInternal in class Span

getInitialSampleRate

public int getInitialSampleRate()

Returns the initial sample rate.

Returns:

the sampler rate set for this span.

getProcessor

protected SpanPostProcessor getProcessor()

Getter for the processor, in case future development needs access to it.

Returns:

this spans processor.