Struct OpenTelemetryPlugin 

pub struct OpenTelemetryPlugin {
    phase: Phase,
    collector: String,
    service_name: String,
    sampler: Sampler,
    ssl_verify: bool,
    timeout: Duration,
    client: Arc<OutboundClient>,
}

One node of the OpenTelemetry tracing pair.

Fields

phase: Phase

collector: String

OTLP/HTTP collector base URL (no trailing slash); traces POST to <collector>/v1/traces.

service_name: String

sampler: Sampler

ssl_verify: bool

timeout: Duration

client: Arc<OutboundClient>

Implementations

impl OpenTelemetryPlugin

pub fn from_config( config: &HashMap<String, Value>, resources: &Arc<PluginResources>, ) -> Result<Self, String>

Builds the plugin from node config.

Config keys:

Key	Type	Default	Description
phase	string	— (required)	start (before upstream) or end (after upstream).
endpoint / collector	string	http://localhost:4318	OTLP/HTTP collector base URL; traces POST to <collector>/v1/traces.
service_name	string	"featherbit"	service.name resource attribute reported on each span.
sampler.name	string	always_on	always_on, always_off, or trace_id_ratio.
sampler.options.fraction	number	1.0	Fraction of new traces to sample for trace_id_ratio, in 0.0..=1.0.
ssl_verify	bool	true	Verify the collector’s TLS certificate.
timeout	int (seconds)	3	Export request timeout (end node).

Fails fast on an unknown phase, an unknown sampler name, or a fraction outside 0.0..=1.0.

# start node — right after listener, before upstream
- id: otel-start
  type: opentelemetry
  config:
    phase: start
    service_name: my-gateway
    sampler: { name: trace_id_ratio, options: { fraction: 0.1 } }
# end node — after upstream, right before client
- id: otel-end
  type: opentelemetry
  config:
    phase: end
    endpoint: http://localhost:4318

fn run_start(&self, ctx: &mut Context)

START: extract or create the span, store it, and inject traceparent.

fn run_end(&self, ctx: &Context)

END: load the span and fire-and-forget the OTLP export when sampled.

Trait Implementations

impl Plugin for OpenTelemetryPlugin

fn plugin_type(&self) -> &str

Unique identifier for the plugin type (e.g., “proxy-rewrite”, “upstream”).

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, ctx: Context, _named_inputs: &'life1 HashMap<String, Value>, ) -> Pin<Box<dyn Future<Output = Result<PluginOutput, PluginExecutionError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Executes the plugin logic against the request/response context.