com.github.kristofa.brave.zipkin

Class ZipkinSpanCollector

java.lang.Object

com.github.kristofa.brave.zipkin.ZipkinSpanCollector

All Implemented Interfaces:

SpanCollector, Closeable, AutoCloseable

public class ZipkinSpanCollector
extends Object
implements SpanCollector, Closeable

Sends spans to Zipkin collector or Scribe.

Typically the ZipkinSpanCollector should be a singleton in your application that can be used by both ClientTracer as ServerTracer.

This SpanCollector is implemented so it puts spans on a queue which are processed by a separate thread. In this way we are submitting spans asynchronously and we should have minimal overhead on application performance.

At this moment the number of processing threads is fixed and set to 1.

Author:

kristof

Constructor Summary

Constructors

Constructor and Description
ZipkinSpanCollector(String zipkinCollectorHost, int zipkinCollectorPort) Create a new instance with default queue size (= ZipkinSpanCollectorParams.DEFAULT_QUEUE_SIZE) and default batch size (= ZipkinSpanCollectorParams.DEFAULT_BATCH_SIZE).
ZipkinSpanCollector(String zipkinCollectorHost, int zipkinCollectorPort, ZipkinSpanCollectorParams params) Create a new instance.

Method Summary

Modifier and Type	Method and Description
void	addDefaultAnnotation(String key, String value)
void	close()
void	collect(Span span)

Methods inherited from class java.lang.Object

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

Constructor Detail

ZipkinSpanCollector

public ZipkinSpanCollector(String zipkinCollectorHost,
                           int zipkinCollectorPort)

Create a new instance with default queue size (= ZipkinSpanCollectorParams.DEFAULT_QUEUE_SIZE) and default batch size (= ZipkinSpanCollectorParams.DEFAULT_BATCH_SIZE).

Parameters:

zipkinCollectorHost - Host for zipkin collector.

zipkinCollectorPort - Port for zipkin collector.

ZipkinSpanCollector

public ZipkinSpanCollector(String zipkinCollectorHost,
                           int zipkinCollectorPort,
                           ZipkinSpanCollectorParams params)

Create a new instance.

Parameters:

zipkinCollectorHost - Host for zipkin collector.

zipkinCollectorPort - Port for zipkin collector.

params - Zipkin Span Collector parameters.

Method Detail

collect

public void collect(Span span)

Specified by:

collect in interface SpanCollector

addDefaultAnnotation

public void addDefaultAnnotation(String key,
                                 String value)

Specified by:

addDefaultAnnotation in interface SpanCollector

close

public void close()

Specified by:

close in interface SpanCollector

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable