Struct OtlpStdoutSpanExporter

pub struct OtlpStdoutSpanExporter { /* private fields */ }

A span exporter that writes spans to stdout in OTLP format

This exporter implements the OpenTelemetry SpanExporter trait and writes spans to stdout in OTLP format with Protobuf serialization and GZIP compression.

Features

• Configurable GZIP compression level (0-9)
• Environment variable support for service name and headers
• Efficient batching of spans
• Base64 encoding of compressed data

Example

use opentelemetry_sdk::runtime;
use otlp_stdout_span_exporter::OtlpStdoutSpanExporter;

// Create an exporter with maximum compression
let exporter = OtlpStdoutSpanExporter::builder()
    .compression_level(9)
    .build();

Implementations

impl OtlpStdoutSpanExporter

pub fn builder() -> OtlpStdoutSpanExporterBuilder

Create a new OtlpStdoutSpanExporter with default configuration.

This uses a GZIP compression level of 6 unless overridden by an environment variable.

Output Type

The output type is determined in the following order:

1. The OTLP_STDOUT_SPAN_EXPORTER_OUTPUT_TYPE environment variable if set (“pipe” or “stdout”)
2. Constructor parameter (pipe)
3. Default (stdout)

Example

use otlp_stdout_span_exporter::OtlpStdoutSpanExporter;

let exporter = OtlpStdoutSpanExporter::default();

Trait Implementations

impl Debug for OtlpStdoutSpanExporter

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for OtlpStdoutSpanExporter

fn default() -> OtlpStdoutSpanExporter

Returns the “default value” for a type.

impl SpanExporter for OtlpStdoutSpanExporter

fn export( &self, batch: Vec<SpanData>, ) -> impl Future<Output = Result<(), OTelSdkError>> + Send

Export spans to stdout in OTLP format

This function:

1. Converts spans to OTLP format
2. Serializes them to protobuf
3. Compresses the data with GZIP
4. Base64 encodes the result
5. Writes a JSON object to stdout

Arguments

• batch - A vector of spans to export

Returns

Returns a resolved future with Ok(()) if the export was successful, or a TraceError if it failed

fn shutdown(&mut self) -> Result<(), OTelSdkError>

Shuts down the exporter

This is a no-op for stdout export as no cleanup is needed.

Returns

Returns Ok(()) as there is nothing to clean up.

fn force_flush(&mut self) -> Result<(), OTelSdkError>

Force flushes any pending spans

This is a no-op for stdout export as spans are written immediately.

Returns

Returns Ok(()) as there is nothing to flush.

fn set_resource(&mut self, resource: &Resource)

Sets the resource for this exporter.

This method stores a clone of the provided resource to be used when exporting spans. The resource represents the entity producing telemetry and will be included in the exported trace data.

Arguments

• resource - The resource to associate with this exporter