org.zalando.tracer

Interface TraceListener

All Known Subinterfaces:

StackedTraceListener

All Known Implementing Classes:

LoggingTraceListener, MDCTraceListener, StackedMDCTraceListener

@API(status=STABLE)
public interface TraceListener

A listener that can be attached to a tracer upon creation. It will then observe any lifecycle event of that tracer.

Traditional trace listeners are not aware of trace stacking. A stacked trace will be observed as defined by the following call sequence:

1. onStart("Trace-ID", "A")
2. onStop("Trace-ID", "A")
3. onStart("Trace-ID", "B")
4. onStop("Trace-ID", "B")
5. onStart("Trace-ID", "A")
6. onStop("Trace-ID", "A")

See Also:

Tracer.start(), Tracer.start(Function), Tracer.stop(), StackedTraceListener

Method Summary

Modifier and Type	Method and Description
void	onStart(String name, String value) Callback to be triggered after start.
void	onStop(String name, String value) Callback to be triggered before stop.

Method Detail

onStart

void onStart(String name,
             String value)

Callback to be triggered after start.

Parameters:

name - the trace's name

value - the trace's value after start

onStop

void onStop(String name,
            String value)

Callback to be triggered before stop.

Parameters:

name - the trace's name

value - the trace's value before stop