NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #2419 most downloaded on crates.io
Jaeger exporter for OpenTelemetry
Latest stable
0.22.0
Last release 3 years ago
no release in 18 months
Ships fairly regularly
a new release about every 3 months
Nearly every release is documented
notes for 23 of 23 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
23 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
*Breaking Change Affecting Exporter authors*:
https://github.com/open-telemetry/opentelemetry-rust/pull/1410 Add experimental synchronous gauge. This is behind the feature flag, and can be enabled by enabling the feature otel_unstable for opentelemetry crate.
https://github.com/open-telemetry/opentelemetry-rust/pull/1410 Guidelines to add new unstable/experimental features.
#1410 Add experimental synchronous gauge
#1471 Configure batch log record processor via OTEL_BLRP_* environment variables and via OtlpLogPipeline::with_batch_config
#1503 Make the documentation for In-Memory exporters visible.
#1526
Performance Improvement : Creating Spans and LogRecords are now faster, by avoiding expensive cloning of Resource for every Span/LogRecord.
Breaking #1313 #1350 Changes how Span links/events are stored to achieve performance gains. See below for details:
Behavior Change: When enforcing max_links_per_span, max_events_per_span
from SpanLimits, links/events are kept in the first-come order. The previous
"eviction" based approach is no longer performed.
Breaking Change Affecting Exporter authors:
SpanData now stores links as SpanLinks instead of EvictedQueue where
SpanLinks is a struct with a Vec of links and dropped_count.
SpanData now stores events as SpanEvents instead of EvictedQueue where
SpanEvents is a struct with a Vec of events and dropped_count.
Breaking Remove TextMapCompositePropagator #1373. Use TextMapCompositePropagator in opentelemetry API.
#1375 Fix metric collections during PeriodicReader shutdown
Breaking #1480 Remove fine grained BatchConfig configurations from BatchLogProcessorBuilder and BatchSpanProcessorBuilder. Use BatchConfigBuilder to construct a BatchConfig instance and pass it using BatchLogProcessorBuilder::with_batch_config or BatchSpanProcessorBuilder::with_batch_config.
Breaking #1480 Remove mutating functions from BatchConfig, use BatchConfigBuilder to construct a BatchConfig instance.
Breaking #1495 Remove Batch LogRecord&Span Processor configuration via non-standard environment variables. Use the following table to migrate from the no longer supported non-standard environment variables to the standard ones.
| No longer supported | Standard equivalent |
|---|---|
| OTEL_BLRP_SCHEDULE_DELAY_MILLIS | OTEL_BLRP_SCHEDULE_DELAY |
| OTEL_BLRP_EXPORT_TIMEOUT_MILLIS | OTEL_BLRP_EXPORT_TIMEOUT |
| OTEL_BSP_SCHEDULE_DELAY_MILLIS | OTEL_BSP_SCHEDULE_DELAY |
| OTEL_BSP_EXPORT_TIMEOUT_MILLIS | OTEL_BSP_EXPORT_TIMEOUT |
Breaking 1455 Make the LoggerProvider Owned
Logger now takes an Owned Logger instead of a Weak<LoggerProviderInner>LoggerProviderInner is no longer pub (crate)Logger.provider() now returns &LoggerProvider instead of an Option<LoggerProvider>1519 Performance improvements
when calling Counter::add() and UpDownCounter::add() with an empty set of attributes
(e.g. counter.Add(5, &[]))
Your coding agent can read these notes before it upgrades. Set up the MCP server →
opentelemetry dependency version to 0.23opentelemetry_sdk dependency version to 0.23opentelemetry-http dependency version to 0.12opentelemetry-semantic-conventions dependency version to 0.15This release should been seen as 1.0-rc4 following 1.0-rc3 in v0.20.0. Refer to CHANGELOG.md in individual creates for details on changes made in diff
This release should been seen as 1.0-rc4 following 1.0-rc3 in v0.20.0. Refer to CHANGELOG.md in individual creates for details on changes made in different creates.
opentelemetry crate now only carries the API types #1186. Use the opentelemetry_sdk crate for the SDK types.trace::noop::NoopSpan no longer implements Default and instead exposes a const DEFAULT value. #1270SpanBuilder attributes changed from OrderMap<Key, Value> to Vec<KeyValue> and with_attributes_map method is removed from SpanBuilder. This implies that OpenTelemetry API will no longer perform de-dup of attribute Keys. #1293. Please share feedback here, if you are affected.See individual crate changelogs for details.
This release should been seen as 1.0-rc2 following 1.0-rc1 in v0.18.0. Refer to CHANGELOG.md in individual creates for details on changes made in diff
This release should been seen as 1.0-rc2 following 1.0-rc1 in v0.18.0. Refer to CHANGELOG.md in individual creates for details on changes made in different creates.
Deprecate metrics ValueRecorder in favor of Histogram #728
OTEL_TRACES_SAMPLER_ARG in default sdk config #737schema_url to Tracer #743schema_url to Resource #775Span::set_attributes #638SpanExporter::force_flush and default implementation #845ValueRecorder in favor of Histogram #728IdGenerator to SDK, rename to RandomIdGenerator #742meter_with_version accepts optional parameter for version and schema_url #752Event and Link access patterns #757SpanKind display format impl to jaeger crate #758TraceStateError private #755Span::record_exception to Span::record_error #756StatusCode and message with Status #760TracerProvider::force_flush to SDK #658SpanBuilder::attributes [breaking] #799pin-project-lite #830serialize feature #738StatusCode::as_str #741Tracer::with_span #746opentelemetry to 0.19opentelemetry-http to 0.8opentelemetry-semantic-conventions to 0.11.SizeLimit error messages #938.JaegerRemoteSampler public, revise doc #975.Implement Serialize & Deserialize for Sampler, SpanLimits #622, #626
Serialize & Deserialize for Sampler, SpanLimits #622, #626&'static str and string in span methods #654String data in instrumentation library. #670std::fmt::Debug and 'static requirements from TracerProvider,
Tracer, and Span #664Tracer::invalid method #683TracerProvider::tracer and TracerProvider::versioned_tracer methods #682futures crate #684ShouldSample parameters #695service.name from OTEL_SERVICE_NAME and OTEL_RESOURCE_ATTRIBUTES #662TraceState::valid_key crashes #665with_batch_processor_config for jaeger pipline #869Add default resource in TracerProvider #571
TracerProvider #571get_tracer to tracer #586trace::noop module and update docs #587Hash impl for span context and allow spans to clone and export current state #592SpanRef public #600SpanProcessor::on_start take a mutable span #601label to attribute to align with otel specification #609Resource::get #579opentelemetry_semantic_conventions::trace and opentelemetry_semantic_conventions::resource into opentelemetry_semantic_conventions::attribute (which now contains all semantic attributes). trace and resource now only contain references to attributes which fall under their respective category.opentelemetry_semantic_conventions::metric to store metric semantic conventions.Expose the Error type to allow users to set custom error handlers #551
Unit into metrics module #564#[tokio::test] #552TraceState cannot insert new key-value pairs #567tokio feature to rt-tokio. Similar with async-stdAdding a dynamic dispatch to Aggregator Selector #497
global::force_flush_tracer_provider #512max_attributes_per_event and max_attributes_per_link #521Key type #491#[must_use] from set_tracer_provider #501default_sampler to sampler #509Upgrade note: exporter pipelines do not return an uninstall guard as of #444, use opentelemetry::shutdown_tracer_provider explicitly instead.
Upgrade note: exporter pipelines do not return an uninstall guard as of #444, use opentelemetry::global::shutdown_tracer_provider explicitly instead.
from_env and use environment variables to initialize the configurations by default #459jaeger span error reporting and spec compliance #489
Instrumentation library support #402
with_unit methods in metrics #431Send, Sync to AsyncInstrument in metrics #422Send, Sync to InstrumentCore in metrics #423http dependencies into a new opentelemetry-http crate #415tonic dependency #414localhost in the OTEL_EXPORTER_JAEGER_AGENT_HOST environment variable. #448from_env and use environment variables to initialize the configurations by default #459Add force_flush method to span processors #358
force_flush method to span processors #358force_flush and shutdown #362Display trait for Key and Value types #353Option from Array values #359ShouldSample's parent parameter to be Context #368trace module into TraceError #371#[must_use] to uninstall structs #372sdk::export #375start_from_context renamed to start_with_context #399build_with_context as full context is now stored in builder #399with_parent renamed to with_parent_context #399HistogramAggregator returning sum vs count #398with_collector_endpoint function less error prune #428Add support for baggage metadata #287
api prefix from modules #305mark_as_active_span and get_active_span functions into trace module #310SpanContext to SpanReference #299Box<dyn Error + Send + Sync + 'static> #284GenericProvider to GenericTracerProvider #313SpanStatus enum to Ok, Error, and Unset variants #315Display trait for Key and Value types #353SpanProcessor trait into sdk module #334is_recording is false and span is no-op after end #341ExportResult to use std::result::Result #347SpanExporter::export to take &mut self instead of &self #350u64 and bytes kv values #323&str #332surf_collector_client, reqwest_collector_client, reqwest_blocking_collector_client, isahc_collector_client)otel.status_code and otel.status_description values #383Add fields method to TextMapFormat #178
fields method to TextMapFormat #178tracestate in TraceContextPropagator #191TraceState to SpanContext #217from_env config option for BatchSpanProcessor #228Sampler::Probability to Sampler::TraceIdRatioBased #188HTTPTextPropagator to TextMapPropagator #192Provider to TracerProvider #206CorrelationContext into Baggage #208ShouldSample implementation to modify trace state #237!Send #239new constructor #240baggage header #246api to api::trace #255tonic feature to use version 0.3.x #258sdk::propagation #266SamplingDecision's NotRecord, Record and RecordAndSampled to
Drop RecordOnly and RecordAndSample #247Add custom span processors to Provider::Builder #166
Provider::Builder #166Carrier into Injector and Extractor #164ParentOrElse(AlwaysOn) #163Sampler interface to the SDK #169Resources to jaeger process tags #215New ParentOrElse sampler for fallback logic if parent is not sampled. #128
ParentOrElse sampler for fallback logic if parent is not sampled. #128record_exception and record_exception_with_stacktrace methods to Span #152Always is now AlwaysOn. Never is now AlwaysOff. Probability now ignores parent
sampled state.base64 and binary_propagator have been moved to experimental module. #134Correlation-Context header has been updated to otcorrelations #145B3Propagator has been updated to more closely follow the spec #148Add http and tonic features to impl Carrier for common types.
http and tonic features to impl Carrier for common types.span_id from sampling parameters when implementing custom samplers.Context Send + Sync in #127span.kind tag if it has been set as an attribute #140Derive Clone for B3Propagator, SamplingResult, and SpanBuilder
Clone for B3Propagator, SamplingResult, and SpanBuilderFrom<T> for common Key and Value typestracer methodResource APIContext APICorrelations APIHttpTextCompositePropagator for composing HttpTextPropagatorsGlobalPropagator for globally configuring a propagatorTraceContextExt to provide methods for working with trace data in a contextEvictedQueue constructorSpan are Send and Sync when used in globalKey and Value method signatures to remove Cow referencesstart now uses the implicit current context instead of an explicit span context.
start_with_context may be used to specify a context if desired.with_span now accepts a span for naming consistency and managing the active state of a more
complex span (likely produced by a builder), and the previous functionality that accepts a
&str has been renamed to in_span, both of which now yield a context to the provided closure.get_active_span now accepts a closureInstrument trait has been renamed to FutureExt to avoid clashing with metric instruments,
and instead accepts contexts via with_context.get_context method has been renamed to span_context to avoid ambiguity.HttpTextPropagators inject the current context instead of an explicit span context. The context
can be specified with inject_context.SpanData's context has been renamed to span_contextTraceparent header to traceparentTracerGenerics methods have been folded in to the Tracer trait so it is longer neededmark_span_as_inactive has been removedas_any methodmark_as_active, mark_as_inactive, and as_any have been removedfrom_env and use environment variables to initialize the configurations by default #459ureq from reqwest to fix #106Update Span's add_event and add_event_with_timestamp to accept attributes.
trace_id to SpanBuilderattributes to Events.Span's add_event and add_event_with_timestamp to accept attributes.Linksstatus_message to Span and SpanDataSpanStatus to StatusCodeEvictedQueue internals from LIFO to FIFOEvictedHashMapshutdown correctly when span processors and exporters are droppedas_any method on exporterSwitch to SpanId and TraceId from u64 and u128
SpanId and TraceId from u64 and u128&mut self requirements for Span APIMake trace and metrics features optional
Semantic conventions for trace and resource.
One column per quarter.