opentelemetry v1.3.0 & v0.22b0

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)

opentelemetry v1.2.0 & v0.21b0

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])(#1809)
• Fixed sequence values in OTLP exporter not translating (#1818)

Removed

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

opentelemetry v1.1.0 & v0.20b0

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)

opentelemetry v1.10a0

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

opentelemetry v1.0.0 & v0.19b0

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])(#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])(#1669)
• Rename IdsGenerator to IdGenerator
  (#1651)

Removed

• Removing support for Python 3.5
  (#1706)

opentelemetry v0.18b0

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])(#1584)

opentelemetry v1.0.0rc1

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)

opentelemetry v0.17b0

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 v0.16b1

opentelemetry-sdk

• Add meter reference to observers to fix #1424

opentelemetry v0.16b0

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)