All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- 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)
- 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)
- 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 usingtime_ns()
at the moment when the aggregation object is created (#4137)
- 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
insdk/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
andnet
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)
- fix namespace exclusion that resulted in dropping
- 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
andInstrumentationScope
(#4015) - Fix inaccessible
SCHEMA_URL
constants inopentelemetry-semantic-conventions
(#4069)
- 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
, andMetricInstruments
are deprecated.- Attribute and metric definitions are now grouped by the namespace.
- Stable attributes and metrics are moved to
opentelemetry.semconv.attributes
andopentelemetry.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] (#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] (#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)
- 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 ofException
inrecord_exception
(#3354) - Make span.record_exception more robust (#3778)
- Fix license field in pyproject.toml files (#3803)
- 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
ignorespreferred_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
andcode.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)
- 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)
- 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)
- Modify Prometheus exporter to translate non-monotonic Sums into Gauges (#3306)
- 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)
- 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)
- 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)
- 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)
- 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)
- 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)
- 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 toLogRecord.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
andpreferred_aggregation
forConsoleMetricExporter
(#2911) - Add support for setting OTLP export protocol with env vars, as defined in the specifications (#2893)
- Add force_flush to span exporters (#2919)
- 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)
- Fix instrument name and unit regexes (#2796)
- Add optional sessions parameter to all Exporters leveraging requests.Session (#2783
- Add min/max fields to Histogram (#2759)
opentelemetry-exporter-otlp-proto-http
Add support for OTLP/HTTP log exporter (#2462)- Fix yield of
None
-valued points (#2745) - Add missing
to_json
methods (#2722 - Fix type hints for textmap
Getter
andSetter
(#2657) - Fix LogEmitterProvider.force_flush hanging randomly (#2714)
- narrow protobuf dependencies to exclude protobuf >= 4 (#2720)
- Specify worker thread names (#2724)
- Loosen dependency on
backoff
for newer Python versions (#2726) - fix: frozenset object has no attribute items (#2727)
- fix: create suppress HTTP instrumentation key in opentelemetry context (#2729)
- Support logs SDK auto instrumentation enable/disable with env (#2728)
- fix: update entry point object references for metrics (#2731)
- Allow set_status to accept the StatusCode and optional description (#2735)
- Configure auto instrumentation to support metrics (#2705)
- Add entrypoint for metrics exporter (#2748)
- Fix Jaeger propagator usage with NonRecordingSpan (#2762)
- Add
opentelemetry.propagate
module andopentelemetry.propagators
package to the API reference documentation (#2785)
- Fix LoggingHandler to handle LogRecord with exc_info=False (#2690)
- Make metrics components public (#2684)
- Update to semantic conventions v1.11.0 (#2669)
- Update opentelemetry-proto to v0.17.0 (#2668)
- Add CallbackOptions to observable instrument callback params (#2664)
- Add timeouts to metric SDK (#2653)
- Add variadic arguments to metric exporter/reader interfaces (#2654)
- Added a
opentelemetry.sdk.resources.ProcessResourceDetector
that adds the 'process.runtime.{name,version,description}' resource attributes when used with theopentelemetry.sdk.resources.get_aggregated_resources
API (#2660) - Move Metrics API behind internal package (#2651)
- 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 toNoOpCounter
,NoOpHistogram
,NoOpObservableCounter
,NoOpObservableGauge
,NoOpObservableUpDownCounter
,NoOpUpDownCounter
(#2616) - Deprecate InstrumentationLibraryInfo and Add InstrumentationScope (#2583)
- 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)
- 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)
- Update opentelemetry-proto to v0.12.0. Note that this update removes deprecated status codes. (#2415)
- 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
andNoOpTracerProvider
. Marking_DefaultTracer
and_DefaultTracerProvider
as deprecated. (#2363) - [exporter/opentelemetry-exporter-otlp-proto-grpc] Add Sum to OTLPMetricExporter (#2370)
- [api] Rename
_DefaultMeter
and_DefaultMeterProvider
toNoOpMeter
andNoOpMeterProvider
. (#2383) - [exporter/opentelemetry-exporter-otlp-proto-grpc] Add Gauge to OTLPMetricExporter (#2408)
- [logs] prevent None from causing problems (#2410)
- 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
toinstall_requires
(#2334) - Add otlp entrypoint for log exporter (#2322)
- Support insecure configuration for OTLP gRPC exporter (#2350)
- 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)
- Fix parental trace relationship for opentracing
follows_from
reference (#2180)
- 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)
- 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
: AddHttpTestBase
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
: Addopentelemetry-otlp-proto-http
as dependency (#2147)- Fix validity calculation for trace and span IDs (#2145)
- Add
schema_url
toTracerProvider.get_tracer
(#2154) - Make baggage implementation w3c spec complaint (#2167)
- Add name to
BatchSpanProcessor
worker thread (#2186)
- 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 distros use its default implementation (#1937)- Add Trace ID validation to meet TraceID spec (#1992)
- Fixed Python 3.10 incompatibility in
opentelemetry-opentracing-shim
tests (#2018) opentelemetry-sdk
added support forOTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT
(#2044)opentelemetry-sdk
Fixed bugs (#2041, #2042 & #2045) in Span Limits (#2044)opentelemetry-sdk
Add support forOTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT
env var (#2056)opentelemetry-sdk
Treat limit even vars set to empty values as unset/unlimited. (#2054)opentelemetry-api
Attribute keys must be non-empty strings. (#2057)
- Fix opentelemetry-bootstrap dependency script. (#1987)
- Moved
opentelemetry-instrumentation
to core repository. (#1959) - Add support for OTLP Exporter Protobuf over HTTP (#1868)
- Dropped attributes/events/links count available exposed on ReadableSpans. (#1893)
- Added dropped count to otlp, jaeger and zipkin exporters. (#1893)
- Give OTLPHandler the ability to process attributes (#1952)
- Add global LogEmitterProvider and convenience function get_log_emitter (#1901)
- Add OTLPHandler for standard library logging module (#1903)
- Updated
opentelemetry-opencensus-exporter
to useservice_name
of spans instead of resource (#1897) - Added descriptions to the env variables mentioned in the opentelemetry-specification (#1898)
- Ignore calls to
Span.set_status
withStatusCode.UNSET
and also if previous status already hadStatusCode.OK
. (#1902) - Attributes for
Link
andResource
are immutable as they are forEvent
, which means any attempt to modify attributes directly will result in aTypeError
exception. (#1909) - Added
BoundedAttributes
to the API to make it available forLink
which is defined in the API. MarkedBoundedDict
in the SDK as deprecated as a result. (#1915) - Fix OTLP SpanExporter to distinguish spans based off Resource and InstrumentationInfo (#1927)
- Updating dependency for opentelemetry api/sdk packages to support major version instead of pinning to specific versions. (#1933)
opentelemetry-semantic-conventions
Generate semconv constants update for OTel Spec 1.5.0 (#1946)
- Updated
opentelementry-opentracing-shim
ScopeShim
to report exceptions in opentelemetry specification format, rather than opentracing spec format. (#1878)
- Allow span limits to be set programmatically via TracerProvider. (#1877)
- Added support for CreateKey functionality. (#1853)
- Updated get_tracer to return an empty string when passed an invalid name (#1854)
- Changed AttributeValue sequences to warn mypy users on adding None values to array (#1855)
- Fixed exporter OTLP header parsing to match baggage header formatting. (#1869)
- Added optional
schema_url
field toResource
class (#1871) - Update protos to latest version release 0.9.0 (#1873)
- Added example for running Django with auto instrumentation. (#1803)
- Added
B3SingleFormat
andB3MultiFormat
propagators to theopentelemetry-propagator-b3
package. (#1823) - Added support for OTEL_SERVICE_NAME. (#1829)
- Lazily read/configure limits and allow limits to be unset. (#1839)
- Added support for OTEL_EXPORTER_JAEGER_TIMEOUT (#1863)
- Fixed OTLP gRPC exporter silently failing if scheme is not specified in endpoint. (#1806)
- Rename CompositeHTTPPropagator to CompositePropagator as per specification. (#1807)
- Propagators use the root context as default for
extract
and do not modify the context if extracting from carrier does not work. (#1811) - Fixed
b3
propagator entrypoint to point toB3SingleFormat
propagator. (#1823) - Added
b3multi
propagator entrypoint to point toB3MultiFormat
propagator. (#1823) - Improve warning when failing to decode byte attribute (#1810)
- Fixed inconsistency in parent_id formatting from the ConsoleSpanExporter (#1833)
- Include span parent in Jaeger gRPC export as
CHILD_OF
reference ([#1809])(#1809) - Fixed sequence values in OTLP exporter not translating (#1818)
- Update transient errors retry timeout and retryable status codes (#1842)
- Apply validation of attributes to
Resource
, move attribute related logic to separate package. (#1834) - Fix start span behavior when excess links and attributes are included (#1856)
- Moved
opentelemetry-instrumentation
to contrib repository. (#1797)
- Added
py.typed
file to every package. This should resolve a bunch of mypy errors for users. (#1720) - Add auto generated trace and resource attributes semantic conventions (#1759)
- Added
SpanKind
toshould_sample
parameters, suggest using parent span context's tracestate instead of manually passed in tracestate inshould_sample
(#1764) - Added experimental HTTP back propagators. (#1762)
- Zipkin exporter: Add support for timeout and implement shutdown (#1799)
- Adjust
B3Format
propagator to be spec compliant by not modifying context when propagation headers are not present/invalid/empty (#1728) - Silence unnecessary warning when creating a new Status object without description. (#1721)
- Update bootstrap cmd to use exact version when installing instrumentation packages. (#1722)
- Fix B3 propagator to never return None. (#1750)
- Added ProxyTracerProvider and ProxyTracer implementations to allow fetching provider and tracer instances before a global provider is set up. (#1726)
- Added
__contains__
toopentelementry.trace.span.TraceState
. (#1773) opentelemetry-opentracing-shim
Fix an issue in the shim where a Span was being wrapped in a NonRecordingSpan when it wasn't necessary. (#1776)- OTLP Exporter now uses the scheme in the endpoint to determine whether to establish a secure connection or not. (#1771)
- Document how to work with fork process web server models(Gunicorn, uWSGI etc...) (#1609)
- Add
max_attr_value_length
support to Jaeger exporter (#1633) - Moved
use_span
from Tracer toopentelemetry.trace.use_span
. (#1668) opentelemetry.trace.use_span()
will now overwrite previously set status on span in case an exception is raised inside the context manager andset_status_on_exception
is set toTrue
. (#1668)- Add
udp_split_oversized_batches
support to jaeger exporter (#1500)
- remove
service_name
from constructor of jaeger and opencensus exporters and use of env variableOTEL_PYTHON_SERVICE_NAME
([#1669])(#1669) - Rename
IdsGenerator
toIdGenerator
(#1651) - Make TracerProvider's resource attribute private (#1652)
- Rename Resource's
create_empty
toget_empty
(#1653) - Renamed
BatchExportSpanProcessor
toBatchSpanProcessor
andSimpleExportSpanProcessor
toSimpleSpanProcessor
(#1656) - Rename
DefaultSpan
toNonRecordingSpan
(#1661) - Fixed distro configuration with
OTEL_TRACES_EXPORTER
env var set tootlp
(#1657) - Moving
Getter
,Setter
andTextMapPropagator
out ofopentelemetry.trace.propagation
and intoopentelemetry.propagators
(#1662) - Rename
BaggagePropagator
toW3CBaggagePropagator
(#1663) - Rename
JaegerSpanExporter
toJaegerExporter
and renameZipkinSpanExporter
toZipkinExporter
(#1664) - Expose
StatusCode
from theopentelemetry.trace
module (#1681) - Status now only sets
description
whenstatus_code
is set toStatusCode.ERROR
(#1673) - Update OTLP exporter to use OTLP proto
0.7.0
(#1674) - Remove time_ns from API and add a warning for older versions of Python (#1602)
- Hide implementation classes/variables in api/sdk (#1684)
- Cleanup OTLP exporter compression options, add tests (#1671)
- Initial documentation for environment variables (#1680)
- Change Zipkin exporter to obtain service.name from span (#1696)
- Split up
opentelemetry-exporter-jaeger
package intoopentelemetry-exporter-jaeger-proto-grpc
andopentelemetry-exporter-jaeger-thrift
packages to reduce dependencies for each one. (#1694) - Added
opentelemetry-exporter-otlp-proto-grpc
and changedopentelemetry-exporter-otlp
to install it as a dependency. This will allow for the next package/protocol to also be in its own package. (#1695) - Change Jaeger exporters to obtain service.name from span (#1703)
- Fixed an unset
OTEL_TRACES_EXPORTER
resulting in an error (#1707) - Split Zipkin exporter into
opentelemetry-exporter-zipkin-json
andopentelemetry-exporter-zipkin-proto-http
packages to reduce dependencies. Theopentelemetry-exporter-zipkin
installs both. (#1699) - Make setters and getters optional (#1690)
- Removed unused
get_hexadecimal_trace_id
andget_hexadecimal_span_id
methods. (#1675) - Remove
OTEL_EXPORTER_*_ INSECURE
env var (#1682) - Removing support for Python 3.5 (#1706)
- remove
service_name
from constructor of jaeger and opencensus exporters and use of env variableOTEL_PYTHON_SERVICE_NAME
([#1669])(#1669) - Rename
IdsGenerator
toIdGenerator
(#1651)
- Removing support for Python 3.5 (#1706)
- Add urllib to opentelemetry-bootstrap target list (#1584)
- Tracer provider environment variables are now consistent with the rest (#1571)
- Rename
TRACE_
toTRACES_
for environment variables (#1595) - Limits for Span attributes, events and links have been updated to 128 (1597)
- Read-only Span attributes have been moved to ReadableSpan class (#1560)
BatchExportSpanProcessor
flushes export queue when it reachesmax_export_batch_size
(#1521)
- Added
end_on_exit
argument tostart_as_current_span
(#1519) - Add
Span.set_attributes
method to set multiple values with one call (#1520) - Make sure Resources follow semantic conventions (#1480)
- Allow missing carrier headers to continue without raising AttributeError (#1545)
- Add support for OTLP v0.6.0 (#1472)
- Add protobuf via gRPC exporting support for Jaeger (#1471)
- Add support for Python 3.9 (#1441)
- Added the ability to disable instrumenting libraries specified by OTEL_PYTHON_DISABLED_INSTRUMENTATIONS env variable, when using opentelemetry-instrument command. (#1461)
- Add
fields
to propagators (#1374) - Add local/remote samplers to parent based sampler (#1440)
- Add support for OTELSPAN{ATTRIBUTE_COUNT_LIMIT,EVENT_COUNT_LIMIT,LINK_COUNT_LIMIT} (#1377)
- Return
None
forDictGetter
if key not found (#1449) - Added support for Jaeger propagator (#1219)
- Remove dependency on SDK from
opentelemetry-instrumentation
package. Theopentelemetry-sdk
package now registers an entrypointopentelemetry_configurator
to allowopentelemetry-instrument
to load the configuration for the SDK (#1420) opentelemetry-exporter-zipkin
Add support for array attributes in Span and Resource exports (#1285)- Added
__repr__
forDefaultSpan
, addedtrace_flags
to__repr__
ofSpanContext
(#1485) opentelemetry-sdk
Add support for OTEL_TRACE_SAMPLER and OTEL_TRACE_SAMPLER_ARG env variables (#1496)- Adding
opentelemetry-distro
package to add default configuration for span exporter to OTLP (#1482)
opentelemetry-exporter-zipkin
Updated zipkin exporter status code and error tag (#1486)- Recreate span on every run of a
start_as_current_span
-decorated function (#1451) opentelemetry-exporter-otlp
Headers are now passed in as tuple as metadata, instead of a string, which was incorrect. (#1507)opentelemetry-exporter-jaeger
Updated Jaeger exporter status code tag (#1488)opentelemetry-api
opentelemety-sdk
Movedidsgenerator
into sdk (#1514)opentelemetry-sdk
The B3Format propagator has been moved into its own package:opentelemetry-propagator-b3
(#1513)- Update default port for OTLP exporter from 55680 to 4317 (#1516)
opentelemetry-exporter-zipkin
Update boolean attribute value transformation (#1509)- Move opentelemetry-opentracing-shim out of instrumentation folder (#1533)
opentelemetry-sdk
The JaegerPropagator has been moved into its own package:opentelemetry-propagator-jaeger
(#1525)opentelemetry-exporter-jaeger
,opentelemetry-exporter-zipkin
Update InstrumentationInfo tag keys for Jaeger and Zipkin exporters (#1535)opentelemetry-sdk
Remove rate property setter from TraceIdRatioBasedSampler (#1536)- Fix TraceState to adhere to specs (#1502)
- Update Resource
merge
key conflict precedence (#1544)
opentelemetry-api
Remove ThreadLocalRuntimeContext since python3.4 is not supported.
- Add meter reference to observers (#1425)
- Add optional parameter to
record_exception
method (#1314) - Add pickle support to SpanContext class (#1380)
- Add instrumentation library name and version to OTLP exported metrics (#1418)
- Add Gzip compression for exporter (#1141)
- Support for v2 api protobuf format (#1318)
- Add IDs Generator as Configurable Property of Auto Instrumentation (#1404)
- Added support for
OTEL_EXPORTER
to theopentelemetry-instrument
command (#1036)
- Change temporality for Counter and UpDownCounter (#1384)
- OTLP exporter: Handle error case when no credentials supplied (#1366)
- Update protobuf versions (#1356)
- Add missing references to instrumented packages (#1416)
- Instrumentation Package depends on the OTel SDK (#1405)
- Allow samplers to modify tracestate (#1319)
- Update exception handling optional parameters, add escaped attribute to record_exception (#1365)
- Rename
MetricRecord
toExportRecord
(#1367) - Rename
Record
toAccumulation
(#1373) - Rename
Meter
toAccumulator
(#1372) - Fix
ParentBased
sampler for implicit parent spans. Fix alsotrace_state
erasure for dropped spans or spans sampled by theTraceIdRatioBased
sampler. (#1394)
- Add Env variables in OTLP exporter (#1101)
- Add support for Jaeger Span Exporter configuration by environment variables and
change JaegerSpanExporter constructor parameters (#1114)
- Updating status codes to adhere to specs (#1282)
- Set initial checkpoint timestamp in aggregators (#1237)
- Make
SpanProcessor.on_start
accept parent Context (#1251) - Fix b3 propagator entrypoint (#1265)
- Allow None in sequence attributes values (#998)
- Samplers to accept parent Context (#1267)
- Span.is_recording() returns false after span has ended (#1289)
- Allow samplers to modify tracestate (#1319)
- Remove TracerProvider coupling from Tracer init (#1295)
- Add optional parameter to
record_exception
method (#1242) - Add support for
OTEL_PROPAGATORS
(#1123) - Add keys method to TextMap propagator Getter (#1196)
- Add timestamps to OTLP exporter (#1199)
- Add Global Error Handler (#1080)
- Add support for
OTEL_BSP_MAX_QUEUE_SIZE
,OTEL_BSP_SCHEDULE_DELAY_MILLIS
,OTEL_BSP_MAX_EXPORT_BATCH_SIZE
andOTEL_BSP_EXPORT_TIMEOUT_MILLIS
environment variables (#1105) - Adding Resource to MeterRecord (#1209) s
- Store
int
s asint
s in the global Configuration object (#1118) - Allow for Custom Trace and Span IDs Generation -
IdsGenerator
for TracerProvider (#1153) - Update baggage propagation header (#1194)
- Make instances of SpanContext immutable (#1134)
- Parent is now always passed in via Context, instead of Span or SpanContext (#1146)
- Update OpenTelemetry protos to v0.5.0 (#1143)
- Zipkin exporter now accepts a
max_tag_value_length
attribute to customize the maximum allowed size a tag value can have. (#1151) - Fixed OTLP events to Zipkin annotations translation. (#1161)
- Fixed bootstrap command to correctly install opentelemetry-instrumentation-falcon instead of opentelemetry-instrumentation-flask. (#1138)
- Update sampling result names (#1128)
- Event attributes are now immutable (#1195)
- Renaming metrics Batcher to Processor (#1203)
- Protect access to Span implementation (#1188)
start_as_current_span
anduse_span
can now optionally auto-record any exceptions raised inside the context manager. (#1162)
- Add instrumentation info to exported spans (#1095)
- Add metric OTLP exporter (#835)
- Add type hints to OTLP exporter (#1121)
- Add support for OTEL_EXPORTER_ZIPKIN_ENDPOINT env var. As part of this change, the
configuration of the ZipkinSpanExporter exposes a
url
argument to replacehost_name
,port
,protocol
,endpoint
. This brings this implementation inline with other implementations. (#1064) - Zipkin exporter report instrumentation info. (#1097)
- Add status mapping to tags (#1111)
- Report instrumentation info (#1098)
- Add support for http metrics (#1116)
- Populate resource attributes as per semantic conventions (#1053)
- Refactor
SpanContext.is_valid
from a method to a data attribute (#1005) - Moved samplers from API to SDK (#1023)
- Change return value type of
correlationcontext.get_correlations
to immutableMappingProxyType
(#1024) - Sampling spec changes (#1034)
- Remove lazy Event and Link API from Span interface (#1045)
- Rename CorrelationContext to Baggage (#1060)
- Rename HTTPTextFormat to TextMapPropagator. This change also updates
get_global_httptextformat
andset_global_httptextformat
toget_global_textmap
andset_global_textmap
(#1085) - Fix api/sdk setup.cfg to include missing python files (#1091)
- Improve BatchExportSpanProcessor (#1062)
- Rename Resource labels to attributes (#1082)
- Rename members of
trace.sampling.Decision
enum (#1115) - Merge
OTELResourceDetector
result when creating resources (#1096)
- Drop support for Python 3.4 (#1099)
- Implement Views in metrics SDK (#596)
- Update environment variable names, prefix changed from
OPENTELEMETRY
toOTEL
(#904) - Stop TracerProvider and MeterProvider from being overridden (#959)
- Update default port to 55680 (#977)
- Add proper length zero padding to hex strings of traceId, spanId, parentId sent on the wire, for compatibility with jaeger-collector (#908)
- Send start_timestamp and convert labels to strings (#937)
- Renamed several packages (#953)
- Thrift URL for Jaeger exporter doesn't allow HTTPS (hardcoded to HTTP) (#978)
- Change reference names to opentelemetry-instrumentation-opentracing-shim (#969)
- Changed default Sampler to
ParentOrElse(AlwaysOn)
(#960) - Update environment variable names, prefix changed from
OPENTELEMETRY
toOTEL
(#904) - Update environment variable
OTEL_RESOURCE
toOTEL_RESOURCE_ATTRIBUTES
as per the specification
- Add support for resources and resource detector (#853)
- Return INVALID_SPAN if no TracerProvider set for get_current_span (#751)
- Rename record_error to record_exception (#927)
- Update span exporter to use OpenTelemetry Proto v0.4.0 (#872)
- Adding trace.get_current_span, Removing Tracer.get_current_span (#552)
- Add SumObserver, UpDownSumObserver and LastValueAggregator in metrics (#789)
- Add start_pipeline to MeterProvider (#791)
- Initial release of opentelemetry-ext-otlp, opentelemetry-proto
- Move stateful & resource from Meter to MeterProvider (#751)
- Rename Measure to ValueRecorder in metrics (#761)
- Rename Observer to ValueObserver (#764)
- Log a warning when replacing the global Tracer/Meter provider (#856)
- bugfix: byte type attributes are decoded before adding to attributes dict (#775)
- Rename opentelemetry-auto-instrumentation to opentelemetry-instrumentation,
and console script
opentelemetry-auto-instrumentation
toopentelemetry-instrument
- Add a new bootstrap command that enables automatic instrument installations. (#650)
- Handle boolean, integer and float values in Configuration (#662)
- bugfix: ensure status is always string (#640)
- Transform resource to tags when exporting (#707)
- Rename otcollector to opencensus (#695)
- Transform resource to tags when exporting (#645)
ext/boto
: Could not serialize attribute aws.region to tag when exporting via jaeger Serialize tuple type values by coercing them into a string, since Jaeger does not support tuple types. (#865)- Validate span attribute types in SDK (#678)
- Specify to_json indent from arguments (#718)
- Span.resource will now default to an empty resource (#724)
- bugfix: Fix error message (#729)
- deep copy empty attributes (#714)
- Add reset for the global configuration object, for testing purposes (#636)
- Add support for programmatic instrumentation (#579)
- tracer.get_tracer now optionally accepts a TracerProvider (#602)
- Configuration object can now be used by any component of opentelemetry, including 3rd party instrumentations (#563)
- bugfix: configuration object now matches fields in a case-sensitive manner (#583)
- bugfix: configuration object now accepts all valid python variable names (#583)
- bugfix: configuration undefined attributes now return None instead of raising an AttributeError. (#583)
- bugfix: 'debug' field is now correct (#549)
- bugfix: enable auto-instrumentation command to work for custom entry points (e.g. flask_run) (#567)
- Exporter API: span parents are now always spancontext (#548)
- Console span exporter now prints prettier, more legible messages (#505)
- bugfix: B3 propagation now retrieves parentSpanId correctly (#621)
- bugfix: a DefaultSpan now longer causes an exception when used with tracer (#577)
- move last_updated_timestamp into aggregators instead of bound metric instrument (#522)
- bugfix: suppressing instrumentation in metrics to eliminate an infinite loop of telemetry (#529)
- bugfix: freezing span attribute sequences, reducing potential user errors (#529)
- Add support for lazy events and links (#474)
- Adding is_remote flag to SpanContext, indicating when a span is remote (#516)
- Adding a solution to release metric handles and observers (#435)
- Initial release: opentelemetry-instrumentation
- Metrics API no longer uses LabelSet (#527)
- Allow digit as first char in vendor specific trace state key (#511)
- Exporting to collector now works (#508)
- Adding Correlation Context API/SDK and propagator (#471)
- Adding a global configuration module to simplify setting and getting globals (#466)
- Adding named meters, removing batchers (#431)
- Adding attach/detach methods as per spec (#429)
- Adding OT Collector metrics exporter (#454)
- Initial release opentelemetry-ext-otcollector
- Rename metric handle to bound metric instrument (#470)
- Moving resources to sdk (#464)
- Implementing propagators to API to use context (#446)
- Renaming TraceOptions to TraceFlags (#450)
- Renaming TracerSource to TracerProvider (#441)
- Improve validation of attributes (#460)
- Re-raise errors caught in opentelemetry.sdk.trace.Tracer.use_span() (#469)
- Implement observer instrument (#425)
- Added named Tracers (#301)
- Add int and valid sequenced to AttributeValue type (#368)
- Add ABC for Metric (#391)
- Metrics export pipeline, and stdout exporter (#341)
- Adding Context API Implementation (#395)
- Adding trace.get_tracer function (#430)
- Add runtime validation for set_attribute (#348)
- Add support for B3 ParentSpanID (#286)
- Implement MinMaxSumCount aggregator (#422)
- Initial release opentelemetry-ext-zipkin, opentelemetry-ext-prometheus
- Separate Default classes from interface descriptions (#311)
- Export span status (#367)
- Export span kind (#387)
- Set status for ended spans (#297 and #358)
- Use module loggers (#351)
- Protect start_time and end_time from being set manually by the user (#363)
- Set status in start_as_current_span (#377)
- Implement force_flush for span processors (#389)
- Set sampled flag on sampling trace (#407)
- Add io and formatter options to console exporter (#412)
- Clean up ProbabilitySample for 64 bit trace IDs (#238)
- Remove monotonic and absolute metric instruments (#410)
- Add metrics exporters (#192)
- Implement extract and inject support for HTTP_HEADERS and TEXT_MAP formats (#256)
- Multiple tracing API/SDK changes
- Multiple metrics API/SDK changes
- Remove option to create unstarted spans from API (#290)
- W3C TraceContext fixes and compliance tests (#228)
- Sampler API/SDK (#225)
- Initial release: opentelemetry-ext-jaeger, opentelemetry-opentracing-shim
- Multiple metrics API/SDK changes
- Multiple tracing API/SDK changes
- Multiple context API changes
- Multiple bugfixes and improvements
-
Initial release api/sdk
-
Use Attribute rather than boundattribute in logrecord (#3567)
-
Fix flush error when no LoggerProvider configured for LoggingHandler (#3608)
-
Fix
OTLPMetricExporter
ignorespreferred_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
andcode.filepath
to all logs (#3645) -
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)
-
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 ofException
inrecord_exception
(#3354) -
Make span.record_exception more robust (#3778)
-
Fix license field in pyproject.toml files (#3803)