zipkin2.reporter

Class AsyncReporter<S>

java.lang.Object

zipkin2.Component

zipkin2.reporter.AsyncReporter<S>

Type Parameters:

S - type of the span, usually Span

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable, Reporter<S>

public abstract class AsyncReporter<S>
extends zipkin2.Component
implements Reporter<S>, Flushable

As spans are reported, they are encoded and added to a pending queue. The task of sending spans happens on a separate thread which calls flush(). By doing so, callers are protected from latency or exceptions possible when exporting spans out of process.

Spans are bundled into messages based on size in bytes or a timeout, whichever happens first.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AsyncReporter.Builder

Field Summary

Fields inherited from interface zipkin2.reporter.Reporter

CONSOLE, NOOP

Constructor Summary

Constructors

Constructor and Description
AsyncReporter()

Method Summary

Modifier and Type	Method and Description
static AsyncReporter.Builder	builder(Sender sender) Like create(Sender), except you can configure settings such as the timeout.
abstract void	close() Shuts down the sender thread, and increments drop metrics if there were any unsent spans.
static AsyncReporter<zipkin2.Span>	create(Sender sender) After a certain threshold, spans are drained and sent to Zipkin collectors.
abstract void	flush() Calling this will flush any pending spans to the transport on the current thread.
static AsyncReporter<zipkin2.Span>	v2(Sender sender) Builds a reporter for Zipkin V2 spans.

Methods inherited from class zipkin2.Component

check

Methods inherited from class java.lang.Object

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

Methods inherited from interface zipkin2.reporter.Reporter

report

Constructor Detail

AsyncReporter

public AsyncReporter()

Method Detail

create

public static AsyncReporter<zipkin2.Span> create(Sender sender)

After a certain threshold, spans are drained and sent to Zipkin collectors.

v2

public static AsyncReporter<zipkin2.Span> v2(Sender sender)

Builds a reporter for Zipkin V2 spans. If http, the endpoint of the sender is usually "http://zipkinhost:9411/api/v2/spans".

builder

public static AsyncReporter.Builder builder(Sender sender)

Like create(Sender), except you can configure settings such as the timeout.

flush

public abstract void flush()

Calling this will flush any pending spans to the transport on the current thread.

Note: If you set message timeout to zero, you must call this externally as otherwise spans will never be sent.

Specified by:

flush in interface Flushable

Throws:

IllegalStateException - if closed

close

public abstract void close()

Shuts down the sender thread, and increments drop metrics if there were any unsent spans.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class zipkin2.Component