Changes

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

Changes

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

##Changes

• 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 otlp entrypoint for log exporter
  (#2322)

Happy Holidays 🎅 ☃️

Highlights

• Experimental release for logging SDK 🎉 (https://github.com/open-telemetry/opentelemetry-python/tree/main/opentelemetry-sdk/src/opentelemetry/sdk/_logs)
• Python 3.10 is now officially supported 🎉

Changelog

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

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

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

• Upgrade GRPC/protobuf related dependency and regenerate otlp protobufs (#2201)
• Propagation: only warn about oversized baggage headers when headers exist (#2212)
• Migrate instrumentation and disro to contrib (#2196)

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

Added

• Add Trace ID validation to meet TraceID spec (#1992)
• opentelemetry-sdk added support for OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT (#2044)
• opentelemetry-sdk Add support for OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT env var (#2056)

Changed

• 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)
• opentelemetry-sdk Treat limit even vars set to empty values as unset/unlimited. (#2054)
• opentelemetry-api Attribute keys must be non-empty strings. (#2057)

Fixed

• Fix documentation on well known exporters and variable OTEL_TRACES_EXPORTER which were misnamed (#2023)
• Fixed Python 3.10 incompatibility in opentelemetry-opentracing-shim tests (#2018)
• opentelemetry-sdk Fixed bugs (#2041, #2042 & #2045) in Span Limits (#2044)

Hotfix to address https://github.com/open-telemetry/opentelemetry-python/issues/1988

Added

• opentelemetry-semantic-conventions Generate semconv constants update for OTel Spec 1.5.0 (#1946)
• Moved opentelemetry-instrumentation to core repository. (#1959)
• Dropped attributes/events/links count available exposed on ReadableSpans. (#1893)
• Added dropped count to otlp, jaeger and zipkin exporters. (#1893)

Changed

• Updated opentelemetry-opencensus-exporter to use service_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 with StatusCode.UNSET and also if previous status already had StatusCode.OK. (#1902)
• Attributes for Link and Resource are immutable as they are for Event, which means any attempt to modify attributes directly will result in a TypeError exception. (#1909)
• Added BoundedAttributes to the API to make it available for Link which is defined in the API. Marked BoundedDict 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)

Fixed

• Updated opentelementry-opentracing-shim ScopeShim to report exceptions in opentelemetry specification format, rather than opentracing spec format. (#1878)

Added

• Allow span limits to be set programatically via TracerProvider. (#1877)

Changed

• 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 to Resource class (#1871)
• Update protos to latest version release 0.9.0 (#1873)

Added

• Added example for running Django with auto instrumentation. (#1803)
• Added B3SingleFormat and B3MultiFormat propagators to the opentelemetry-propagator-b3 package. (#1823)
• Added support for OTEL_SERVICE_NAME. (#1829)

Changed

• 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 to B3SingleFormat propagator. (#1823)
• Added b3multi propagator entrypoint to point to B3MultiFormat 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])(https://github.com/open-telemetry/opentelemetry-python/pull/1809)
• Fixed sequence values in OTLP exporter not translating (#1818)

Removed

• Moved opentelemetry-instrumentation to contrib repository. (#1797)

1.1.0 - 2021-04-20

Added

• 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 to should_sample parameters, suggest using parent span context's tracestate
  instead of manually passed in tracestate in should_sample (#1764)
• Added experimental HTTP back propagators. (#1762)

Changed

• 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__ to opentelementry.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)

This release adds the experimental metrics API/SDK and will include the following packages:

  opentelemetry-exporter-prometheus
  opentelemetry-api
  opentelemetry-sdk
  opentelemetry-exporter-otlp-proto-grpc
  opentelemetry-exporter-otlp

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 Opentelemetry components listed below:
opentelemetry-distro
opentelemetry-exporter-opencensus
opentelemetry-instrumentation
opentelemetry-opentracing-shim

Added

• Add urllib to opentelemetry-bootstrap target list ([#1584])(https://github.com/open-telemetry/opentelemetry-python/pull/1584)

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