Package io.opentelemetry.exporter.otlp.http.trace

Class OtlpHttpSpanExporter

java.lang.Object

io.opentelemetry.exporter.otlp.http.trace.OtlpHttpSpanExporter

All Implemented Interfaces:

SpanExporter, Closeable, AutoCloseable

@ThreadSafe
public final class OtlpHttpSpanExporter
extends Object
implements SpanExporter

Exports spans using OTLP via HTTP, using OpenTelemetry's protobuf model.

Since:

1.5.0

Field Summary

Fields

Modifier and Type	Field	Description
private final HttpExporterBuilder<Marshaler>	builder
private final HttpExporter<Marshaler>	delegate
private final SpanReusableDataMarshaler	marshaler

Constructor Summary

Constructors

Constructor	Description
OtlpHttpSpanExporter(HttpExporterBuilder<Marshaler> builder, HttpExporter<Marshaler> delegate, MemoryMode memoryMode)

Method Summary

Modifier and Type	Method	Description
static OtlpHttpSpanExporterBuilder	builder()	Returns a new builder instance for this exporter.
CompletableResultCode	export(Collection<SpanData> spans)	Submits all the given spans in a single batch to the OpenTelemetry collector.
CompletableResultCode	flush()	The OTLP exporter does not batch spans, so this method will immediately return with success.
static OtlpHttpSpanExporter	getDefault()	Returns a new OtlpHttpSpanExporter using the default values.
CompletableResultCode	shutdown()	Shutdown the exporter, releasing any resources and preventing subsequent exports.
OtlpHttpSpanExporterBuilder	toBuilder()	Returns a builder with configuration values equal to those for this exporter.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.opentelemetry.sdk.trace.export.SpanExporter

close

Field Details

builder

private final HttpExporterBuilder<Marshaler> builder

delegate

private final HttpExporter<Marshaler> delegate

marshaler

private final SpanReusableDataMarshaler marshaler

Constructor Details

OtlpHttpSpanExporter

OtlpHttpSpanExporter(HttpExporterBuilder<Marshaler> builder,
 HttpExporter<Marshaler> delegate,
 MemoryMode memoryMode)

Method Details

getDefault

public static OtlpHttpSpanExporter getDefault()

Returns a new OtlpHttpSpanExporter using the default values.

To load configuration values from environment variables and system properties, use opentelemetry-sdk-extension-autoconfigure.

Returns:

a new OtlpHttpSpanExporter instance.

builder

public static OtlpHttpSpanExporterBuilder builder()

Returns a new builder instance for this exporter.

Returns:

a new builder instance for this exporter.

toBuilder

public OtlpHttpSpanExporterBuilder toBuilder()

Returns a builder with configuration values equal to those for this exporter.

IMPORTANT: Be sure to shutdown() this instance if it will no longer be used.

Since:

1.29.0

export

public CompletableResultCode export(Collection<SpanData> spans)

Submits all the given spans in a single batch to the OpenTelemetry collector.

Specified by:

export in interface SpanExporter

Parameters:

spans - the list of sampled Spans to be exported.

Returns:

the result of the operation

flush

public CompletableResultCode flush()

The OTLP exporter does not batch spans, so this method will immediately return with success.

Specified by:

flush in interface SpanExporter

Returns:

always Success

shutdown

public CompletableResultCode shutdown()

Shutdown the exporter, releasing any resources and preventing subsequent exports.

Specified by:

shutdown in interface SpanExporter

Returns:

a CompletableResultCode which is completed when shutdown completes.

toString

public String toString()

Overrides:

toString in class Object