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)

opentelemetry v0.15b0

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 v0.14b0

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)