NOTE: As part of this release, all old versions have been removed for packages prefixed with opentelemetry-ext-

1.0.0 - 2021-03-26

Added

• 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 to opentelemetry.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 and set_status_on_exception is set to True. (#1668)
• Add udp_split_oversized_batches support to jaeger exporter (#1500)

Changed

• remove service_name from constructor of jaeger and opencensus exporters and use of env variable OTEL_PYTHON_SERVICE_NAME ([#1669])(https://github.com/open-telemetry/opentelemetry-python/pull/1669)
• Rename IdsGenerator to IdGenerator (#1651)
• Make TracerProvider's resource attribute private (#1652)
• Rename Resource's create_empty to get_empty (#1653)
• Renamed BatchExportSpanProcessor to BatchSpanProcessor and SimpleExportSpanProcessor to SimpleSpanProcessor (#1656)
• Rename DefaultSpan to NonRecordingSpan (#1661)
• Fixed distro configuration with OTEL_TRACES_EXPORTER env var set to otlp (#1657)
• Moving Getter, Setter and TextMapPropagator out of opentelemetry.trace.propagation and into opentelemetry.propagators (#1662)
• Rename BaggagePropagator to W3CBaggagePropagator (#1663)
• Rename JaegerSpanExporter to JaegerExporter and rename ZipkinSpanExporter to ZipkinExporter (#1664)
• Expose StatusCode from the opentelemetry.trace module (#1681)
• Status now only sets description when status_code is set to StatusCode.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 into opentelemetry-exporter-jaeger-proto-grpc and opentelemetry-exporter-jaeger-thrift packages to reduce dependencies for each one. (#1694)
• Added opentelemetry-exporter-otlp-proto-grpc and changed opentelemetry-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 and opentelemetry-exporter-zipkin-proto-http packages to reduce dependencies. The opentelemetry-exporter-zipkin installs both. (#1699)
• Make setters and getters optional (#1690)

Removed

• Removed unused get_hexadecimal_trace_id and get_hexadecimal_span_id methods. (#1675)
• Remove OTEL_EXPORTER_*_ INSECURE env var (#1682)
• Removing support for Python 3.5 (#1706)

0.19b0 - 2021-03-26

Changed

• remove service_name from constructor of jaeger and opencensus exporters and use of env variable OTEL_PYTHON_SERVICE_NAME ([#1669])(https://github.com/open-telemetry/opentelemetry-python/pull/1669)
• Rename IdsGenerator to IdGenerator (#1651)

Removed

• Removing support for Python 3.5 (#1706)

Release only affects core Opentelemetry components listed below: opentelemetry-api opentelemetry-sdk opentelemetry-exporter-otlp opentelemetry-exporter-jaeger opentelemetry-exporter-zipkin opentelemetry-proto opentelemetry-propagator-b3 opentelemetry-propagator-jaeger

Changed

• Tracer and Meter provider environment variables are now consistent with the rest (#1571])
• Rename TRACE_ to TRACES_ for environment variables (#1595])
• Read-only Span attributes have been moved to ReadableSpan class (#1560)

Added

• Added end_on_exit argument to start_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)

Removed

• Remove Configuration (#1523)
• Remove Metrics as part of stable, marked as experimental (#1568)

Added

• 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 OTEL_SPAN_{ATTRIBUTE_COUNT_LIMIT,EVENT_COUNT_LIMIT,LINK_COUNT_LIMIT} (#1377)
• Return None for DictGetter if key not found (#1449)
• Added support for Jaeger propagator (#1219)
• Remove dependency on SDK from opentelemetry-instrumentation package. The opentelemetry-sdk package now registers an entrypoint opentelemetry_configurator to allow opentelemetry-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__ for DefaultSpan, added trace_flags to __repr__ of SpanContext (#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)

Changed

• 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 Moved idsgenerator 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)

Removed

• opentelemetry-api Remove ThreadLocalRuntimeContext since python3.4 is not supported. (#1482)

opentelemetry-sdk

• Add meter reference to observers to fix #1424

One major change done as part of this release was to move the instrumentation out of the core repo and into the contrib repo. This change should not impact users of the published packages, but the release notes for instrumentation packages will now be available in the contrib repo.

opentelemetry-api

🚀 Enhancements

• Add optional parameter to record_exception method (#1314)
• Add pickle support to SpanContext class (#1380)

opentelemetry-instrumentation

🚀 Enhancements

• Added support for OTEL_EXPORTER to the opentelemetry-instrument command (#1036)
• Add IDs Generator as Configurable Property of Auto Instrumentation (#1404)
• Add missing references to instrumented packages (#1416)
• Instrumentation Package depends on the OTel SDK (#1405)

opentelemetry-proto

💥 Breaking Changes

• Update protobuf versions (#1356)

opentelemetry-sdk

💥 Breaking Changes

• Rename MetricRecord class to ExportRecord (#1367)
• Rename Record class to Accumulation (#1373)
• Rename Meter class to Accumulator (#1372)

🚀 Enhancements)

• Add optional parameter to record_exception method (#1314)

• Update exception handling optional parameters, add escaped attribute to record_exception (#1365)

• Allow samplers to modify tracestate (#1319)
• Fix ParentBased sampler for implicit parent spans. Fix also trace_state erasure for dropped spans or spans sampled by the TraceIdRatioBased sampler. (#1394)

opentelemetry-exporter-jaeger

🚀 Enhancements

• Fix Jaeger exporter to correctly translate span.kind attribute (#1329)

opentelemetry-exporter-opencensus

💥 Breaking Changes

• Update protobuf versions (#1356)

opentelemetry-exporter-otlp

🚀 Enhancements

• Add Gzip compression for exporter (#1141)
• Handle error case when no credentials supplied (#1366)
• Change temporality for Counter and UpDownCounter (#1384)
• Add instrumentation library name and version to OTLP exported metrics (#1418)

opentelemetry-exporter-zipkin

🚀 Enhancements

• Support for v2 api protobuf format (#1318)

opentelemetry-api

💥 Breaking Changes

• Updating status codes to adhere to spec (#1282)

🚀 Enhancements

• Add keys method to TextMap propagator Getter (#1196)
• Fix ConsoleSpanExporter exception (#1246)
• Updating limits for attributes, events, links (#1249)

opentelemetry-sdk

💥 Breaking Changes

• Updating status codes to adhere to specs (#1282)
• Split up metric instrument constructors (#1254)

🚀 Enhancements

• Allow None in sequence attributes values (#998)
• Set initial checkpoint timestamp in aggregators (#1237)
• Span.is_recording() returns false after span has ended (#1289)
• Fix b3 propagator entrypoint (#1265)
• Samplers to accept parent Context (#1267)
• Add keys method to TextMap propagator Getter (#1196)
• Make SpanProcessor.on_start accept parent Context (#1251)
• Remove TracerProvider coupling from Tracer init (#1295)

opentelemetry-exporter-datadog

🚀 Enhancements

• Make SpanProcessor.on_start accept parent Context (#1251)

opentelemetry-exporter-jaeger

🚀 Enhancements

• Add support for Jaeger Span Exporter configuration by environment variables and change JaegerSpanExporter constructor parameters (#1114)

opentelemetry-exporter-otlp

🚀 Enhancements

• Add Env variables in OTLP exporter (#1101)
• Do not use bound instruments in OTLP exporter (#1237)

opentelemetry-instrumentation-django

🚀 Enhancements

• Django instrumentation is now enabled by default but can be disabled by setting OTEL_PYTHON_DJANGO_INSTRUMENT to False (#1239)
• Span name resolves correctly for paths that also require a query parameter to match (#1309)
• Added capture of http.route (#1226)
• Add support for tracking http metrics (#1230)
• Record span status and http.status_code attribute on exception (#1257)

opentelemetry-instrumentation-flask

🚀 Enhancements

• Use url.rule instead of request.endpoint for span name (#1260)

opentelemetry-instrumentation-grpc

🚀 Enhancements

• Rewrite gRPC server interceptor (#1171)

opentelemetry-instrumentation-requests

🚀 Enhancements

• Add support for tracking http metrics (#1116)

opentelemetry-api

💥 Breaking Changes

• Update baggage propagation header (#1194)
• Parent is now always passed in via Context, intead of Span or SpanContext (#1146)

🚀 Enhancements

• Add support for OTEL_PROPAGATORS (#1123)
• Store ints as ints in the global Configuration object (#1118)
• Make instances of SpanContext immutable (#1134)
• Allow for Custom Trace and Span IDs Generation - IdsGenerator for TracerProvider (#1153)

opentelemetry-sdk

💥 Breaking Changes

• Update sampling result names (#1128)
• Renaming metrics Batcher to Processor (#1203)
• Parent is now always passed in via Context, intead of Span or SpanContext (#1146)

🚀 Enhancements

• Add timestamps to aggregators (#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 and OTEL_BSP_EXPORT_TIMEOUT_MILLIS environment variables (#1105)
• Allow for Custom Trace and Span IDs Generation - IdsGenerator for TracerProvider (#1153)
• Event attributes are now immutable (#1195)
• Protect access to Span implementation (#1188)
• start_as_current_span and use_span can now optionally auto-record any exceptions raised inside the context manager. (#1162)
• Adding Resource to MeterRecord (#1209)

opentelemetry-exporter-datadog

🚀 Enhancements

• Add support for span resource labels and service name (#1074)

opentelemetry-exporter-otlp

💥 Breaking Changes

• Update OpenTelemetry protos to v0.5.0 (#1143)

🚀 Enhancements

• Add support for span resource labels and service name (#1074)
• Add timestamps to OTLP exporter (#1199)

opentelemetry-exporter-zipkin

🚀 Enhancements

• Add support for span resource labels and service name (#1074)
• Zipkin exporter now accepts a max_tag_value_length attribute to customize the maximum allowed size a tag value can have. (#1151)

opentelemetry-instrumentation-celery

🚀 Enhancements

• Span operation names now include the task type. (#1135)
• Added automatic context propagation. (#1135)

opentelemetry-instrumentation-django

🚀 Enhancements

• Changed span name extraction from request to comply semantic convention (#992)
• Added support for OTEL_PYTHON_DJANGO_TRACED_REQUEST_ATTRS (#1154)

opentelemetry-instrumentation-falcon

🚀 Enhancements

• Added support for OTEL_PYTHON_FALCON_TRACED_REQUEST_ATTRS (#1158)

opentelemetry-instrumentation-pymysql

🚀 Enhancements

• Bumped version from 0.9.3 to 0.10.1 (#1228)

opentelemetry-instrumentation-system-metrics

🐛 Bug Fixes

• Fix issue when specific metrics are not available in certain OS (#1207)

opentelemetry-instrumentation-tornado

🚀 Enhancements

• Added support for OTEL_PYTHON_TORNADO_TRACED_REQUEST_ATTRS (#1178)

opentelemetry-instrumentation

🚀 Enhancements

• Add support for http metrics (#1116)

🐛 Bug Fixes

• Fixed boostrap command to correctly install opentelemetry-instrumentation-falcon instead of opentelemetry-instrumentation-flask (#1138)

The 0.13b0 version officially drops support for Python 3.4 (#1099)

opentelemetry-api

💥 Breaking Changes

• Refactor SpanContext.is_valid from a method to a data attribute (#1005)
• Moved samplers from API to SDK (#1023)
• Change is_recording_events to is_recording (#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 and set_global_httptextformat to get_global_textmap and set_global_textmap (#1085)

🐛 Bug Fixes

• Change return value type of correlationcontext.get_correlations to immutable MappingProxyType (#1024)
• Fix api/sdk setup.cfg to include missing python files (#1091)

opentelemetry-sdk

💥 Breaking Changes

• Moved samplers from API to SDK (#1023)
• Sampling spec changes (#1034)
• Remove lazy Event and Link API from Span interface (#1045)
• Rename Resource labels to attributes (#1082)
• Rename members of trace.sampling.Decision enum (#1115)

🚀 Enhancements

• Improve BatchExportSpanProcessor (#1062)
• Populate resource attributes as per semantic conventions (#1053)

🐛 Bug Fixes

• Fix api/sdk setup.cfg to include missing python files (#1091)

opentelemetry-exporter-jaeger

🚀 Enhancements

• Report instrumentation info (#1098)

opentelemetry-exporter-otlp

🚀 Enhancements

• Add instrumentation info to exported spans (#1095)
• Add metric OTLP exporter (#835)

opentelemetry-exporter-zipkin

🚀 Enhancements

• Add support for OTEL_EXPORTER_ZIPKIN_ENDPOINT env var. As part of this change, the configuration of the ZipkinSpanExporter exposes a url argument to replace host_name, port, protocol, endpoint. This brings this implementation inline with other implementations. (#1064)
• Zipkin exporter report instrumentation info. (#1097)

opentelemetry-instrumentation-aiohttp-client

🚀 Enhancements

• Updating span name to match semantic conventions (#972)

opentelemetry-instrumentation-dbapi

🐛 Bug Fixes

• cursors and connections now produce spans when used with context managers (#1028)

opentelemetry-instrumentation-falcon

🚀 Enhancements

• Initial release. Added instrumentation for Falcon 2.0+

opentelemetry-instrumentation-tornado

🚀 Enhancements

• Initial release. Supports Tornado 6.x on Python 3.5 and newer

Added

• Implement Views in metrics SDK (#596)

Changed

• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#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 to OTEL (#904)
• Update environment variable OTEL_RESOURCE to OTEL_RESOURCE_ATTRIBUTES as per the specification

Added

• Add support for resources and resource detector (#853)

Changed

• 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)

Changed

• Regenerate proto code and add pyi stubs (#823)
• Rename CounterAggregator -> SumAggregator (#816)

Added

• 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

Changed

• 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 to opentelemetry-instrument