com.github.kristofa.brave.zipkin.ZipkinSpanCollectorParams Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of brave-zipkin-spancollector Show documentation
Brave SpanCollector that submits spans to the Zipkin collector service.
There is a newer version: 3.0.0
Show newest version
package com.github.kristofa.brave.zipkin;

/**
 * Optional parameters for {@link ZipkinSpanCollector}.
 * 
 * If not specified we will use the default values. We support following parameters:
 * 

 * queue size: Size of the queue that is used as buffer between producers of spans and the thread(s) that submit the
 * spans to collector.
 * batch size: The maximum number of spans that is submitted at once to collector of spans.
 * number of threads: The number of parallel threads for submitting spans to collector.
 * socket time out: Time in milliseconds after which our socket connections will time out. When it times out an exception
 * will be thrown.
 * fail on setup: Indicates if {@link ZipkinSpanCollector} should fail on creation when connection with collector can't
 * be established or just log error message.
 * 
 * 
 * @author kristof
 */
public class ZipkinSpanCollectorParams {

    public int DEFAULT_QUEUE_SIZE = 200;
    public int DEFAULT_BATCH_SIZE = 10;
    public int DEFAULT_NR_OF_THREADS = 1;
    public int DEFAULT_SOCKET_TIMEOUT = 5000;

    private int queueSize;
    private int batchSize;
    private int nrOfThreads;
    private int socketTimeout;
    private boolean failOnSetup = true;

    /**
     * Create a new instance with default values.
     */
    public ZipkinSpanCollectorParams() {
        queueSize = DEFAULT_QUEUE_SIZE;
        batchSize = DEFAULT_BATCH_SIZE;
        nrOfThreads = DEFAULT_NR_OF_THREADS;
        socketTimeout = DEFAULT_SOCKET_TIMEOUT;
    }

    /**
     * Gets queue size.
     * 
     * @return queue size.
     */
    public int getQueueSize() {
        return queueSize;
    }

    /**
     * Sets the size of the queue that is used as buffer between producers of spans and the thread(s) that submit the spans
     * to collector.
     * 
     * @param queueSize Queue size.
     */
    public void setQueueSize(final int queueSize) {
        if (queueSize <= 0) throw new IllegalArgumentException("queueSize must be positive");
        this.queueSize = queueSize;
    }

    /**
     * Gets the maximum batch size.
     * 
     * @return Maximum queue size.
     */
    public int getBatchSize() {
        return batchSize;
    }

    /**
     * Sets the batch size. The batch size is the maximum number of spans that is submitted at once to the collector.
     * 
     * @param batchSize Maximum batch size.
     */
    public void setBatchSize(final int batchSize) {
        if (batchSize <= 0) throw new IllegalArgumentException("batchSize must be positive");
        this.batchSize = batchSize;
    }

    /**
     * Gets the number of threads.
     * 
     * @return Number of threads.
     */
    public int getNrOfThreads() {
        return nrOfThreads;
    }

    /**
     * Sets the number of parallel threads for submitting spans to collector.
     * 
     * @param nrOfThreads Number of parallel threads for submitting spans to collector.
     */
    public void setNrOfThreads(final int nrOfThreads) {
        if (nrOfThreads <= 0) throw new IllegalArgumentException("nrOfThreads must be positive");
        this.nrOfThreads = nrOfThreads;
    }

    /**
     * Gets the socket time out.
     * 
     * @return Returns the socket time out in milliseconds.
     */
    public int getSocketTimeout() {
        return socketTimeout;
    }

    /**
     * Sets the socket time out in milliseconds.
     * 
     * @param socketTimeout Socket time out in milliseconds. Should be >= 100;
     */
    public void setSocketTimeout(final int socketTimeout) {
        if (socketTimeout < 100) throw new IllegalArgumentException("socketTimeout must be >= 100");
        this.socketTimeout = socketTimeout;
    }

    /**
     * Sets fail on setup value.
     * 
     * @param failOnSetup true in case {@link ZipkinSpanCollector} will throw exception when connection can't be
     *            established during setup. Or false in case we should log message but not throw exception.
     */
    public void setFailOnSetup(final boolean failOnSetup) {
        this.failOnSetup = failOnSetup;
    }

    /**
     * Indicates if {@link ZipkinSpanCollector} should fail on creation when connection with collector can't be established.
     * 
     * @return true in case {@link ZipkinSpanCollector} will throw exception when connection can't be
     *         established during setup. Or false in case we should log message but not throw exception. Default
     *         value = true.
     */
    public boolean failOnSetup() {
        return failOnSetup;
    }

}