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)

opentelemetry v0.13b0

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

opentelemetry v0.12.0

vBeta v12 release.

Update exporter package names

Change package names from "ext" to "exporter" (#953)
opentelemetry-ext-datadog -> opentelemetry-exporter-datadog
opentelemetry-ext-jaeger-> opentelemetry-exporter-jaeger
opentelemetry-ext-opencensusexporter-> opentelemetry-exporter-opencensus
opentelemetry-ext-otlp-> opentelemetry-exporter-otlp
opentelemetry-ext-prometheus-> opentelemetry-exporter-prometheus
opentelemetry-ext-zipkin-> opentelemetry-exporter-zipkin

Update instrumentation package names

Change package names from "ext" to "instrumentation" (#961, #966, #969)
opentelemetry-ext-aiohttp-client-> opentelemetry-instrumentation-aiohttp-client
opentelemetry-ext-asgi-> opentelemetry-instrumentation-asgi
opentelemetry-ext-asyncpg-> opentelemetry-instrumentation-asyncpg
opentelemetry-ext-boto-> opentelemetry-instrumentation-boto
opentelemetry-ext-botocore-> opentelemetry-instrumentation-botocore
opentelemetry-ext-celery-> opentelemetry-instrumentation-celery
opentelemetry-ext-dbapi-> opentelemetry-instrumentation-dbapi
opentelemetry-ext-django-> opentelemetry-instrumentation-django
opentelemetry-ext-elasticsearch-> opentelemetry-instrumentation-elasticsearch
opentelemetry-ext-flask-> opentelemetry-instrumentation-flask
opentelemetry-ext-grpc-> opentelemetry-instrumentation-grpc
opentelemetry-ext-jinja2-> opentelemetry-instrumentation-jinja2
opentelemetry-ext-mysql-> opentelemetry-instrumentation-mysql
opentelemetry-ext-opentracing-shim-> opentelemetry-instrumentation-opentracing-shim
opentelemetry-ext-psycopg2-> opentelemetry-instrumentation-psycopg2
opentelemetry-ext-pymemcache-> opentelemetry-instrumentation-pymemcache
opentelemetry-ext-pymongo-> opentelemetry-instrumentation-pymongo
opentelemetry-ext-pymysql-> opentelemetry-instrumentation-pymysql
opentelemetry-ext-pyramid-> opentelemetry-instrumentation-pyramid
opentelemetry-ext-redis-> opentelemetry-instrumentation-redis
opentelemetry-ext-requests-> opentelemetry-instrumentation-requests
opentelemetry-ext-sqlalchemy-> opentelemetry-instrumentation-sqlalchemy
opentelemetry-ext-sqlite3-> opentelemetry-instrumentation-sqlite3
opentelemetry-ext-system-metrics-> opentelemetry-instrumentation-system-metrics
opentelemetry-ext-wsgi-> opentelemetry-instrumentation-wsgi

opentelemetry-api

• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#904)
• Stop TracerProvider and MeterProvider from being overridden (#959)

opentelemetry-sdk

• Changed default Sampler to ParentOrElse(AlwaysOn) (#960)
• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#904)
• Implement Views in metrics SDK (#596)
• Update environment variable OTEL_RESOURCE to OTEL_RESOURCE_ATTRIBUTES as per the specification (#973)

opentelemetry-instrumentation-django

• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#904)

opentelemetry-instrumentation-elasticsearch

• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#904)

opentelemetry-instrumentation-flask

• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#904)

opentelemetry-instrumentation-pyramid

• Update environment variable names, prefix changed from OPENTELEMETRY to OTEL (#904)

opentelemetry-instrumentation-redis

• Update default SpanKind to SpanKind.CLIENT (#965)

opentelemetry v0.11.0

Beta v11 release.

opentelemetry-api

• Log a warning when replacing the global Tracer/Meter provider (#856)
• Return INVALID_SPAN if no TracerProvider set for get_current_span (#751)
• Rename record_error to record_exception (#927)

opentelemetry-sdk

• Add support for resources and resource detector (#853)
• Rename record_error to record_exception (#927)

opentelemetry-ext-asyncpg

• Shouldn't capture query parameters by default (#854)

opentelemetry-ext-boto

• bugfix: fails to export spans via jaeger (#866)

opentelemetry-ext-botocore

• bugfix: fails to export spans via jaeger (#866)

opentelemetry-ext-django

• Use one general exclude list instead of two (#872)

opentelemetry-ext-flask

• Use one general exclude list instead of two (#872)

opentelemetry-ext-grpc

• Add status code to gRPC client spans (896)
• Add gRPC client and server instrumentors (788)

opentelemetry-ext-jaeger

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

opentelemetry-ext-mysql

• bugfix: Fix auto-instrumentation entry point for mysql (#858)

opentelemetry-ext-otlp

• Update span exporter to use OpenTelemetry Proto v0.4.0 (#872)

opentelemetry-ext-pyramid

• Use one general exclude list instead of two (#872)

opentelemetry-ext-wsgi

• Set span status on wsgi errors (#864)

opentelemetry-instrumentation-aiopg

• Initial release

opentelemetry-instrumentation-fastapi

• Initial release (#890)