v1.30.0: Version 1.30.0/0.51b0

Compare Source

• Always setup logs sdk, OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED only controls python logging module handler setup (#​4340)
• Add attributes field in metrics.get_meter wrapper function (#​4364)
• Add Python 3.13 support (#​4353)
• sdk: don't log or print warnings when the SDK has been disabled (#​4371)
• Fix span context manager typing by using ParamSpec from typing_extensions (#​4389)
• Fix serialization of None values in logs body to match 1.31.0+ data model (#​4400)
• [BREAKING] semantic-conventions: Remove opentelemetry.semconv.attributes.network_attributes.NETWORK_INTERFACE_NAME introduced by mistake in the wrong module. (#​4391)
• Add support for explicit bucket boundaries advisory for Histograms (#​4361)
• semantic-conventions: Bump to 1.30.0 (#​4337)

v1.29.0

Compare Source

• Fix crash exporting a log record with None body
  (#​4276)
• Fix metrics export with exemplar and no context and filtering observable instruments
  (#​4251)
• Fix recursion error with sdk disabled and handler added to root logger
  (#​4259)
• sdk: setup EventLogger when OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED is set
  (#​4270)
• api: fix logging of duplicate EventLogger setup warning
  (#​4299)
• sdk: fix setting of process owner in ProcessResourceDetector
  (#​4311)
• sdk: fix serialization of logs severity_number field to int
  (#​4324)
• Remove TestBase.assertEqualSpanInstrumentationInfo method, use assertEqualSpanInstrumentationScope instead
  (#​4310)
• sdk: instantiate lazily ExemplarBuckets in ExemplarReservoirs
  (#​4260)
• semantic-conventions: Bump to 1.29.0
  (#​4337)

v1.28.2: Version 1.28.2/0.49b2

Compare Source

This is a patch release on the previous 1.28.1/0.49b1 release, fixing the issue(s) below.

• Fix crash exporting a log record with None body (#​4276)
• sdk: setup EventLogger when OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED is set (#​4270)

v1.28.1: Version 1.28.1/0.49b1

Compare Source

This is a patch release on the previous 1.28.0/0.49b0 release, fixing the issue(s) below.

• Fix metrics export with exemplar and no context and filtering observable instruments (#​4251)
• Fix recursion error with sdk disabled and handler added to root logger (#​4259)

v1.28.0

Compare Source

• Removed superfluous py.typed markers and added them where they were missing
  (#​4172)
• Include metric info in encoding exceptions
  (#​4154)
• sdk: Add support for log formatting
  (#​4137)
• sdk: Add Host resource detector
  (#​4182)
• sdk: Implementation of exemplars
  (#​4094)
• Implement events sdk
  (#​4176)
• Update semantic conventions to version 1.28.0
  (#​4218)
• Add support to protobuf 5+ and drop support to protobuf 3 and 4
  (#​4206)
• Update environment variable descriptions to match signal
  (#​4222)
• Record logger name as the instrumentation scope name
  (#​4208)
• Fix memory leak in exporter and reader
  (#​4224)
• Drop OTEL_PYTHON_EXPERIMENTAL_DISABLE_PROMETHEUS_UNIT_NORMALIZATION environment variable
  (#​4217)
• Improve compatibility with other logging libraries that override
  LogRecord.getMessage() in order to customize message formatting
  (#​4216)

v1.27.0

Compare Source

• Implementation of Events API
  (#​4054)
• Make log sdk add exception.message to logRecord for exceptions whose argument
  is an exception not a string message
  (#​4122)
• Fix use of link.attributes.dropped, which may not exist
  (#​4119)
• Running mypy on SDK resources
  (#​4053)
• Added py.typed file to top-level module
  (#​4084)
• Drop Final annotation from Enum in semantic conventions
  (#​4085)
• Update log export example to not use root logger (#​4090)
• sdk: Add OS resource detector
  (#​3992)
• sdk: Accept non URL-encoded headers in OTEL_EXPORTER_OTLP_*HEADERS to match other languages SDKs
  (#​4103)
• Update semantic conventions to version 1.27.0
  (#​4104)
• Add support to type bytes for OTLP AnyValue
  (#​4128)
• Export ExponentialHistogram and ExponentialHistogramDataPoint
  (#​4134)
• Implement Client Key and Certificate File Support for All OTLP Exporters
  (#​4116)
• Remove _start_time_unix_nano attribute from _ViewInstrumentMatch in favor
  of using time_ns() at the moment when the aggregation object is created
  (#​4137)

v1.26.0

Compare Source

• Standardizing timeout calculation in measurement consumer collect to nanoseconds
  (#​4074)
• optional scope attributes for logger creation
  (#​4035)
• optional scope attribute for tracer creation
  (#​4028)
• OTLP exporter is encoding invalid span/trace IDs in the logs fix
  (#​4006)
• Update sdk process resource detector process.command_args attribute to also include the executable itself
  (#​4032)
• Fix start_time_unix_nano for delta collection for explicit bucket histogram aggregation
  (#​4009)
• Fix start_time_unix_nano for delta collection for sum aggregation
  (#​4011)
• Update opentracing and opencesus docs examples to not use JaegerExporter
  (#​4023)
• Do not execute Flask Tests in debug mode
  (#​3956)
• When encountering an error encoding metric attributes in the OTLP exporter, log the key that had an error.
  (#​3838)
• Fix ExponentialHistogramAggregation
  (#​3978)
• Log a warning when a LogRecord in sdk/log has dropped attributes
  due to reaching limits
  (#​3946)
• Fix RandomIdGenerator can generate invalid Span/Trace Ids
  (#​3949)
• Add Python 3.12 to tox
  (#​3616)
• Improve resource field structure for LogRecords
  (#​3972)
• Update Semantic Conventions code generation scripts:
  • fix namespace exclusion that resulted in dropping os and net namespaces.
  • add Final decorator to constants to prevent collisions
  • enable mypy and fix detected issues
  • allow to drop specific attributes in preparation for Semantic Conventions v1.26.0
    (#​3973)
• Update semantic conventions to version 1.26.0.
  (#​3964)
• Use semconv exception attributes for record exceptions in spans
  (#​3979)
• Fix _encode_events assumes events.attributes.dropped exists
  (#​3965)
• Validate links at span creation
  (#​3991)
• Add attributes field in MeterProvider.get_meter and InstrumentationScope
  (#​4015)
• Fix inaccessible SCHEMA_URL constants in opentelemetry-semantic-conventions
  (#​4069)

v1.25.0

Compare Source

• Fix class BoundedAttributes to have RLock rather than Lock
  (#​3859)
• Remove thread lock by loading RuntimeContext explicitly.
  (#​3763)
• Update proto version to v1.2.0
  (#​3844)
• Add to_json method to ExponentialHistogram
  (#​3780)
• Bump mypy to 1.9.0
  (#​3795)
• Fix exponential histograms
  (#​3798)
• Fix otlp exporter to export log_record.observed_timestamp
  (#​3785)
• Add capture the fully qualified type name for raised exceptions in spans
  (#​3837)
• Prometheus exporter sort label keys to prevent duplicate metrics when user input changes order
  (#​3698)
• Update semantic conventions to version 1.25.0.
  Refactor semantic-convention structure:
  • SpanAttributes, ResourceAttributes, and MetricInstruments are deprecated.
  • Attribute and metric definitions are now grouped by the namespace.
  • Stable attributes and metrics are moved to opentelemetry.semconv.attributes
    and opentelemetry.semconv.metrics modules.
  • Stable and experimental attributes and metrics are defined under
    opentelemetry.semconv._incubating import path.
    (#​3586)
• Rename test objects to avoid pytest warnings
  ([#​3823] (https://github.com/open-telemetry/opentelemetry-python/pull/3823))
• Add span flags to OTLP spans and links
  (#​3881)
• Record links with invalid SpanContext if either attributes or TraceState are not empty
  (#​3917)
• Add OpenTelemetry trove classifiers to PyPI packages
  ([#​3913] (https://github.com/open-telemetry/opentelemetry-python/pull/3913))
• Fix prometheus metric name and unit conversion
  (#​3924)
  • this is a breaking change to prometheus metric names so they comply with the
    specification.
  • you can temporarily opt-out of the unit normalization by setting the environment variable
    OTEL_PYTHON_EXPERIMENTAL_DISABLE_PROMETHEUS_UNIT_NORMALIZATION=true
  • common unit abbreviations are converted to Prometheus conventions (s -> seconds),
    following the collector's implementation
  • repeated _ are replaced with a single _
  • unit annotations (enclosed in curly braces like {requests}) are stripped away
  • units with slash are converted e.g. m/s -> meters_per_second.
  • The exporter's API is not changed
• Add parameters for Distros and configurators to configure autoinstrumentation in addition to existing environment variables.
  (#​3864)

v1.24.0

Compare Source

• Make create_gauge non-abstract method
  (#​3817)
• Make tracer.start_as_current_span() decorator work with async functions
  (#​3633)
• Fix python 3.12 deprecation warning
  (#​3751)
• bump mypy to 0.982
  (#​3776)
• Add support for OTEL_SDK_DISABLED environment variable
  (#​3648)
• Fix ValueError message for PeriodicExportingMetricsReader
  (#​3769)
• Use BaseException instead of Exception in record_exception
  (#​3354)
• Make span.record_exception more robust
  (#​3778)
• Fix license field in pyproject.toml files
  (#​3803)

v1.23.0

Compare Source

• Use Attribute rather than boundattribute in logrecord
  (#​3567)
• Fix flush error when no LoggerProvider configured for LoggingHandler
  (#​3608)
• Add Span.add_link() method to add link after span start
  (#​3618)
• Fix OTLPMetricExporter ignores preferred_aggregation property
  (#​3603)
• Logs: set observed_timestamp field
  (#​3565)
• Add missing Resource SchemaURL in OTLP exporters
  (#​3652)
• Fix loglevel warning text
  (#​3566)
• Prometheus Exporter string representation for target_info labels
  (#​3659)
• Logs: ObservedTimestamp field is missing in console exporter output
  (#​3564)
• Fix explicit bucket histogram aggregation
  (#​3429)
• Add code.lineno, code.function and code.filepath to all logs
  (#​3675)
• Add Synchronous Gauge instrument
  (#​3462)
• Drop support for 3.7
  (#​3668)
• Include key in attribute sequence warning
  (#​3639)
• Upgrade markupsafe, Flask and related dependencies to dev and test
  environments (#​3609)
• Handle HTTP 2XX responses as successful in OTLP exporters
  (#​3623)
• Improve Resource Detector timeout messaging
  (#​3645)
• Add Proxy classes for logging
  (#​3575)
• Remove dependency on 'backoff' library
  (#​3679)

v1.22.0

Compare Source

• Prometheus exporter sanitize info metric
  (#​3572)
• Remove Jaeger exporters
  (#​3554)
• Log stacktrace on UNKNOWN status OTLP export error
  (#​3536)
• Fix OTLPExporterMixin shutdown timeout period
  (#​3524)
• Handle taskName logrecord attribute
  (#​3557)

v1.21.0

Compare Source

• Fix SumAggregation
   (#​3390)
• Fix handling of empty metric collection cycles
  (#​3335)
• Fix error when no LoggerProvider configured for LoggingHandler
  (#​3423)
• Make opentelemetry_metrics_exporter entrypoint support pull exporters
  (#​3428)
• Allow instrument names to have '/' and up to 255 characters
  (#​3442)
• Do not load Resource on sdk import
  (#​3447)
• Update semantic conventions to version 1.21.0
  (#​3251)
• Add missing schema_url in global api for logging and metrics
  (#​3251)
• Prometheus exporter support for auto instrumentation
  (#​3413)
• Implement Process Resource detector
  (#​3472)

v1.20.0

Compare Source

• Modify Prometheus exporter to translate non-monotonic Sums into Gauges
  (#​3306)

v1.19.0

Compare Source

• Drop setuptools runtime requirement.
  (#​3372)
• Update the body type in the log
  ($3343)
• Add max_scale option to Exponential Bucket Histogram Aggregation
  (#​3323)
• Use BoundedAttributes instead of raw dict to extract attributes from LogRecord
  (#​3310)
• Support dropped_attributes_count in LogRecord and exporters
  (#​3351)
• Add unit to view instrument selection criteria
  (#​3341)
• Upgrade opentelemetry-proto to 0.20 and regen
  #​3355)
• Include endpoint in Grpc transient error warning
  #​3362)
• Fixed bug where logging export is tracked as trace
  #​3375)
• Default LogRecord observed_timestamp to current timestamp
  #​3377)

v1.18.0

Compare Source

• Select histogram aggregation with an environment variable
  (#​3265)
• Move Protobuf encoding to its own package
  (#​3169)
• Add experimental feature to detect resource detectors in auto instrumentation
  (#​3181)
• Fix exporting of ExponentialBucketHistogramAggregation from opentelemetry.sdk.metrics.view
  (#​3240)
• Fix headers types mismatch for OTLP Exporters
  (#​3226)
• Fix suppress instrumentation for log batch processor
  (#​3223)
• Add speced out environment variables and arguments for BatchLogRecordProcessor
  (#​3237)
• Add benchmark tests for metrics
  (#​3267)

v1.17.0

Compare Source

• Implement LowMemory temporality
  (#​3223)
• PeriodicExportingMetricReader will continue if collection times out
  (#​3100)
• Fix formatting of ConsoleMetricExporter.
  (#​3197)
• Fix use of built-in samplers in SDK configuration
  (#​3176)
• Implement shutdown procedure forOTLP grpc exporters
  (#​3138)
• Add exponential histogram
  (#​2964)
• Add OpenCensus trace bridge/shim
  (#​3210)

v1.16.0

Compare Source

• Change __all__ to be statically defined.
  (#​3143)
• Remove the ability to set a global metric prefix for Prometheus exporter
  (#​3137)
• Adds environment variables for log exporter
  (#​3037)
• Add attribute name to type warning message.
  (3124)
• Add db metric name to semantic conventions
  (#​3115)
• Fix User-Agent header value for OTLP exporters to conform to RFC7231 & RFC7230
  (#​3128)
• Fix validation of baggage values
  (#​3058)
• Fix capitalization of baggage keys
  (#​3151)
• Bump min required api version for OTLP exporters
  (#​3156)
• deprecate jaeger exporters
  (#​3158)
• Create a single resource instance
  (#​3118)

v1.15.0

Compare Source

• PeriodicExportingMetricsReader with +Inf interval
  to support explicit metric collection
  (#​3059)
• Regenerate opentelemetry-proto to be compatible with protobuf 3 and 4
  (#​3070)
• Rename parse_headers to parse_env_headers and improve error message
  (#​2376)
• Add url decode values from OTEL_RESOURCE_ATTRIBUTES
  (#​3046)
• Fixed circular dependency issue with custom samplers
  (#​3026)
• Add missing entry points for OTLP/HTTP exporter
  (#​3027)
• Update logging to include logging api as per specification
  (#​3038)
• Fix: Avoid generator in metrics _ViewInstrumentMatch.collect()
  (#​3035
• [exporter-otlp-proto-grpc] add user agent string
  (#​3009)

v1.14.0

Compare Source

• Add logarithm and exponent mappings
  (#​2960)
• Add and use missing metrics environment variables
  (#​2968)
• Enabled custom samplers via entry points
  (#​2972)
• Update log symbol names
  (#​2943)
• Update explicit histogram bucket boundaries
  (#​2947)
• exporter-otlp-proto-http: add user agent string
  (#​2959)
• Add http-metric instrument names to semantic conventions
  (#​2976)
• [exporter/opentelemetry-exporter-otlp-proto-http] Add OTLPMetricExporter
  (#​2891)
• Add support for py3.11
  (#​2997)
• Fix a bug with exporter retries for with newer versions of the backoff library
  (#​2980)

v1.13.0

Compare Source

• Add a configurable max_export_batch_size to the gRPC metrics exporter
  (#​2809)
• Remove support for 3.6
  (#​2763)
• Update PeriodicExportingMetricReader to never call export() concurrently
  (#​2873)
• Add param for indent size to LogRecord.to_json()
  (#​2870)
• Fix: Remove LogEmitter.flush() to align with OTel Log spec
  (#​2863)
• Bump minimum required API/SDK version for exporters that support metrics
  (#​2918)
• Fix metric reader examples + added preferred_temporality and preferred_aggregation
  for ConsoleMetricExporter
  (#​2911)
• Add support for setting OTLP export protocol with env vars, as defined in the
  specifications
  (#​2893)
• Add force_flush to span exporters
  (#​2919)

v1.12.0

Compare Source

• Add force_flush method to metrics exporter
  (#​2852)
• Change tracing to use Resource.to_json()
  (#​2784)
• Fix get_log_emitter instrumenting_module_version args typo
  (#​2830)
• Fix OTLP gRPC exporter warning message
  (#​2781)
• Fix tracing decorator with late configuration
  (#​2754)
• Fix --insecure of CLI argument
  (#​2696)
• Add temporality and aggregation configuration for metrics exporters,
  use OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE only for OTLP metrics exporter
  (#​2843)
• Instrument instances are always created through a Meter
  (#​2844)

v1.11.1

Compare Source

• Add parameter to MetricReader constructor to select aggregation per instrument kind
  (#​2638)
• Add parameter to MetricReader constructor to select temporality per instrument kind
  (#​2637)
• Fix unhandled callback exceptions on async instruments
  (#​2614)
• Rename DefaultCounter, DefaultHistogram, DefaultObservableCounter,
  DefaultObservableGauge, DefaultObservableUpDownCounter, DefaultUpDownCounter
  instruments to NoOpCounter, NoOpHistogram, NoOpObservableCounter,
  NoOpObservableGauge, NoOpObservableUpDownCounter, NoOpUpDownCounter
  (#​2616)
• Deprecate InstrumentationLibraryInfo and Add InstrumentationScope
  (#​2583)

v1.11.0

Compare Source

• Rename API Measurement for async instruments to Observation
  (#​2617)
• Add support for zero or more callbacks
  (#​2602)
• Fix parsing of trace flags when extracting traceparent
  (#​2577)
• Add default aggregation
  (#​2543)
• Fix incorrect installation of some exporter “convenience” packages into
  “site-packages/src”
  (#​2525)
• Capture exception information as part of log attributes
  (#​2531)
• Change OTLPHandler to LoggingHandler
  (#​2528)
• Fix delta histogram sum not being reset on collection
  (#​2533)
• Add InMemoryMetricReader to metrics SDK
  (#​2540)
• Drop the usage of name field from log model in OTLP
  (#​2565)
• Update opentelemetry-proto to v0.15.0
  (#​2566)
• Remove enable_default_view option from sdk MeterProvider
  (#​2547)
• Update otlp-proto-grpc and otlp-proto-http exporters to have more lax requirements for backoff lib
  (#​2575)
• Add min/max to histogram point
  (#​2581)
• Update opentelemetry-proto to v0.16.0
  (#​2619)

v1.10.0

Compare Source

• Docs rework: non-API docs are
  moving to
  opentelemetry.io. For details, including a list of
  pages that have moved, see
  #​2453, and
  #​2498.
• opentelemetry-exporter-otlp-proto-grpc update SDK dependency to ~1.9.
  (#​2442)
• bugfix(auto-instrumentation): attach OTLPHandler to root logger
  (#​2450)
• Bump semantic conventions from 1.6.1 to 1.8.0
  (#​2461)
• fix exception handling in get_aggregated_resources
  (#​2464)
• Fix OTEL_EXPORTER_OTLP_ENDPOINT usage in OTLP HTTP trace exporter
  (#​2493)
• [exporter/opentelemetry-exporter-prometheus] restore package using the new metrics API
  (#​2321)

v1.9.1

Compare Source

• Update opentelemetry-proto to v0.12.0. Note that this update removes deprecated status codes.
  (#​2415)

v1.9.0

Compare Source

• Fix SpanLimits global span limit defaulting when set to 0
  (#​2398)
• Add Python version support policy
  (#​2397)
• Decode URL-encoded headers in environment variables
  (#​2312)
• [exporter/opentelemetry-exporter-otlp-proto-grpc] Add OTLPMetricExporter
  (#​2323)
• Complete metric exporter format and update OTLP exporter
  (#​2364)
• [api] Add NoOpTracer and NoOpTracerProvider. Marking _DefaultTracer and _DefaultTracerProvider as deprecated.
  (#​2363)
• [exporter/opentelemetry-exporter-otlp-proto-grpc] Add Sum to OTLPMetricExporter
  (#​2370)
• [api] Rename _DefaultMeter and _DefaultMeterProvider to NoOpMeter and NoOpMeterProvider.
  (#​2383)
• [exporter/opentelemetry-exporter-otlp-proto-grpc] Add Gauge to OTLPMetricExporter
  (#​2408)
• [logs] prevent None from causing problems
  (#​2410)

v1.8.0

Compare Source

• Adds Aggregation and instruments as part of Metrics SDK
  (#​2234)
• Update visibility of OTEL_METRICS_EXPORTER environment variable
  (#​2303)
• Adding entrypoints for log emitter provider and console, otlp log exporters
  (#​2253)
• Rename ConsoleExporter to ConsoleLogExporter
  (#​2307)
• Adding OTEL_LOGS_EXPORTER environment variable
  (#​2320)
• Add setuptools to install_requires
  (#​2334)
• Add otlp entrypoint for log exporter
  (#​2322)
• Support insecure configuration for OTLP gRPC exporter
  (#​2350)

v1.7.1

Compare Source

• Add support for Python 3.10
  (#​2207)
• remove X-B3-ParentSpanId for B3 propagator as per OpenTelemetry specification
  (#​2237)
• Populate auto.version in Resource if using auto-instrumentation
  (#​2243)
• Return proxy instruments from ProxyMeter
  (#​2169)
• Make Measurement a concrete class
  (#​2153)
• Add metrics API
  (#​1887)
• Make batch processor fork aware and reinit when needed
  (#​2242)
• opentelemetry-sdk Sanitize env var resource attribute pairs
  (#​2256)
• opentelemetry-test start releasing to pypi.org
  (#​2269)

v1.7.0: opentelemetry v1.7.0 & v0.26b0

Compare Source

This version was partially released. Please use 1.7.1 & 0.26b1 instead.

v1.6.2

Compare Source

• Fix parental trace relationship for opentracing follows_from reference
  (#​2180)

v1.6.1

Compare Source

• Fix ReadableSpan property types attempting to create a mapping from a list
  (#​2215)
• Upgrade GRPC/protobuf related dependency and regenerate otlp protobufs
  (#​2201)
• Propagation: only warn about oversized baggage headers when headers exist
  (#​2212)

v1.6.0

Compare Source

• Fix race in set_tracer_provider()
  (#​2182)
• Automatically load OTEL environment variables as options for opentelemetry-instrument
  (#​1969)
• opentelemetry-semantic-conventions Update to semantic conventions v1.6.1
  (#​2077)
• Do not count invalid attributes for dropped
  (#​2096)
• Fix propagation bug caused by counting skipped entries
  (#​2071)
• Add entry point for exporters with default protocol
  (#​2093)
• Renamed entrypoints otlp_proto_http_span, otlp_proto_grpc_span, console_span to remove
  redundant _span suffix.
  (#​2093)
• Do not skip sequence attribute on decode error
  (#​2097)
• opentelemetry-test: Add HttpTestBase to allow tests with actual TCP sockets
  (#​2101)
• Fix incorrect headers parsing via environment variables
  (#​2103)
• Add support for OTEL_ATTRIBUTE_COUNT_LIMIT
  (#​2139)
• Attribute limits no longer apply to Resource attributes
  (#​2138)
• opentelemetry-exporter-otlp: Add opentelemetry-otlp-proto-http as dependency
  (#​2147)
• Fix validity calculation for trace and span IDs
  (#​2145)
• Add schema_url to TracerProvider.get_tracer
  (#​2154)
• Make baggage implementation w3c spec complaint
  (#​2167)
• Add name to BatchSpanProcessor worker thread
  (#​2186)

v1.5.0

Compare Source

• Add pre and post instrumentation entry points
  (#​1983)
• Fix documentation on well known exporters and variable OTEL_TRACES_EXPORTER which were misnamed
  (#​2023)
• opentelemetry-sdk get_aggregated_resource() returns default resource and service name
  whenever called
  (#​2013)
• opentelemetry-distro & opentelemetry-sdk Moved Auto Instrumentation Configurator code to SDK
  to let dist