• Home
• com.github.kristofa
• brave-core
• 3.7.0
• source code
• SpanCollector.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

com.github.kristofa.brave.SpanCollector Maven / Gradle / Ivy

package com.github.kristofa.brave;

import com.twitter.zipkin.gen.Span;

/**
 * Collects spans that are submitted by {@link ServerTracer} and {@link ClientTracer}. We can have implementations that
 * simply log the collected spans or implementations that persist the spans to a database, submit them to a service,...
 * 
 * @author kristof
 */
public interface SpanCollector {

    /**
     * Collect span.
     * 
     * @param span Span, should not be null.
     */
    void collect(final Span span);

    /**
     * Adds a fixed annotation that will be added to every span that is submitted to this collector.
     * 

     * One use case for this is to distinguish spans from different environments or for testing reasons.
     * 
     * @param key Annotation name/key. Should not be empty or null.
     * @param value Annotation value. Should not be null.
     *
     * @deprecated decorate {@link #collect(Span)}, if you want to customize spans before they are sent.
     */
    @Deprecated
    void addDefaultAnnotation(final String key, final String value);
}