Package zipkin2.reporter.okhttp3

Class OkHttpSender

java.lang.Object

zipkin2.reporter.Component

zipkin2.reporter.Sender

zipkin2.reporter.okhttp3.OkHttpSender

All Implemented Interfaces:

Closeable, AutoCloseable, BytesMessageSender

public final class OkHttpSender
extends Sender

Reports spans to Zipkin, using its POST endpoint.

Usage

This type is designed for the async reporter.

Here's a simple configuration, configured for json:

 sender = OkHttpSender.create("http://127.0.0.1:9411/api/v2/spans");
 

Here's an example that adds basic auth (assuming you have an authenticating proxy):

{@code
 credential = Credentials.basic("me", "secure");
 sender = OkHttpSender.newBuilder()
   .endpoint("https://authenticated-proxy/api/v2/spans")
   .clientBuilder().authenticator(new Authenticator() {

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OkHttpSender.Builder

Nested classes/interfaces inherited from interface zipkin2.reporter.BytesMessageSender

BytesMessageSender.Base

Method Summary

Modifier and Type	Method	Description
CheckResult	check()	Deprecated.
void	close()	Waits up to a second for in-flight requests to finish before cancelling them
static OkHttpSender	create(String endpoint)	Creates a sender that posts Encoding.JSON messages.
Encoding	encoding()
int	messageMaxBytes()
int	messageSizeInBytes(int encodedSizeInBytes)
int	messageSizeInBytes(List<byte[]> encodedSpans)
static OkHttpSender.Builder	newBuilder()
void	send(List<byte[]> encodedSpans)	Sends spans as a POST to OkHttpSender.Builder.endpoint(String).
Call<Void>	sendSpans(List<byte[]> encodedSpans)	Deprecated.
OkHttpSender.Builder	toBuilder()	Creates a builder out of this object.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

create

public static OkHttpSender create(String endpoint)

Creates a sender that posts Encoding.JSON messages.

newBuilder

public static OkHttpSender.Builder newBuilder()

toBuilder

public OkHttpSender.Builder toBuilder()

Creates a builder out of this object. Note: if the OkHttpSender.Builder.clientBuilder() was customized, you'll need to re-apply those customizations.

messageSizeInBytes

public int messageSizeInBytes(List<byte[]> encodedSpans)

messageSizeInBytes

public int messageSizeInBytes(int encodedSizeInBytes)

Specified by:

messageSizeInBytes in interface BytesMessageSender

Overrides:

messageSizeInBytes in class Sender

encoding

public Encoding encoding()

messageMaxBytes

public int messageMaxBytes()

sendSpans

@Deprecated
public Call<Void> sendSpans(List<byte[]> encodedSpans)

Deprecated.

Specified by:

sendSpans in class Sender

send

public void send(List<byte[]> encodedSpans)
          throws IOException

Sends spans as a POST to OkHttpSender.Builder.endpoint(String).

Specified by:

send in interface BytesMessageSender

Overrides:

send in class Sender

Throws:

IOException

check

@Deprecated
public CheckResult check()

Deprecated.

Overrides:

check in class Component

close

public void close()

Waits up to a second for in-flight requests to finish before cancelling them

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class Component

toString

public final String toString()

Overrides:

toString in class Object