opentelemetry-python

What's Changed

• Stop MeterProvier attribute error message from showing up by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2875
• Update PeriodicExportingMetricReader to never call export() concurrently by @aabmass in https://github.com/open-telemetry/opentelemetry-python/pull/2873
• Fix typos by @kianmeng in https://github.com/open-telemetry/opentelemetry-python/pull/2868
• Adding Codespell to the CI by @galbash in https://github.com/open-telemetry/opentelemetry-python/pull/2878
• Skip LICENSE files for spellcheck by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2879
• Add param for indent size to LogRecord.to_json() by @dougramirez in https://github.com/open-telemetry/opentelemetry-python/pull/2870
• Remove LogEmitter.flush() to align with OTel Log Spec by @pranavmarla in https://github.com/open-telemetry/opentelemetry-python/pull/2863
• Mark test as flaky by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2886
• Remove support for 3.6 by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2763
• Update package metadata opentelemetry-api by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2867
• Refactor testing console exporter by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2877
• Update package metadata opentelemetry-proto by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2905
• Update package metadata opentelemetry-sdk by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2906
• Update package metadata opentelemetry-semantic-conventions by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2907
• Update package metadata opentelemetry-propagator-b3 by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2908
• Update package metadata opentelemetry-propagator-jaeger by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2909
• Update package metadata opentelemetry-exporter-jaeger-thrift by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2896
• Update package metadata opentelemetry-exporter-zipkin-json by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2903
• Update package metadata opentelemetry-exporter-opencensus by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2897
• Update package metadata opentelemetry-exporter-zipkin-proto-http by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2904
• Update package metadata opentelemetry-exporter-zipkin by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2902
• Update package metadata opentelemetry-exporter-prometheus by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2901
• Update package metadata opentelemetry-exporter-otlp-proto-http by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2900
• Update package metadata opentelemetry-exporter-otlp-proto-grpc by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2899
• Update package metadata opentelemetry-exporter-jaeger-proto-grpc by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2895
• Update package metadata opentelemetry-exporter-otlp by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2898
• Update package metadata opentelemetry-exporter-jaeger by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2894
• Update package metadata opentelemetry-opentracing-shim by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2912
• Update package metadata docs/examples/error_handler by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2914
• Update package metadata opentelemetry-test-utils by @ofek in https://github.com/open-telemetry/opentelemetry-python/pull/2913
• Update README.md by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2916
• Adding support for setting OTLP exporter protocol by env vars by @ronyis in https://github.com/open-telemetry/opentelemetry-python/pull/2893
• Fix preferred_aggregation + preferred_temporality example by @lzchen in https://github.com/open-telemetry/opentelemetry-python/pull/2911
• Bump API/SDK version for exporters by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2918
• Add a configurable max_export_batch_size to the gRPC metrics exporter by @overmeulen in https://github.com/open-telemetry/opentelemetry-python/pull/2809
• Update scripts and lint configs by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2929
• Update contrib repo SHA by @ocelotl in https://github.com/open-telemetry/opentelemetry-python/pull/2937
• Add force_flush to span exporters by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2919
• Update scripts by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2944
• updating changelogs and version to 1.13.0-0.34b0 by @srikanthccv in https://github.com/open-telemetry/opentelemetry-python/pull/2950

New Contributors

• @kianmeng made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2868
• @galbash made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2878
• @dougramirez made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2870
• @pranavmarla made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2863
• @ofek made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2867
• @ronyis made their first contribution in https://github.com/open-telemetry/opentelemetry-python/pull/2893

Full Changelog: https://github.com/open-telemetry/opentelemetry-python/compare/v1.12.0...v1.13.0

• Add force_flush method to metrics exporter (#2852)
• Change tracing to use Resource.to_json() (#2784)
• Fix get_log_emitter instrumenting_module_version args typo (#2830)
• Fix OTLP gRPC exporter warning message (#2781)
• Fix tracing decorator with late configuration (#2754)
• Fix --insecure of CLI argument (#2696)
• Add temporality and aggregation configuration for metrics exporters, use OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE only for OTLP metrics exporter (#2843)
• Instrument instances are always created through a Meter (#2844)

• Fix instrument name and unit regexes (#2796)
• Add optional sessions parameter to all Exporters leveraging requests.Session (#2783)
• Add min/max fields to Histogram (#2759)
• opentelemetry-exporter-otlp-proto-http Add support for OTLP/HTTP log exporter (#2462)
• Fix yield of None-valued points (#2745)
• Add missing to_json methods (#2722
• Fix type hints for textmap Getter and Setter (#2657)
• Fix LogEmitterProvider.force_flush hanging randomly (#2714)
• narrow protobuf dependencies to exclude protobuf >= 4 (#2720)
• Specify worker thread names (#2724)
• Loosen dependency on backoff for newer Python versions (#2726)
• fix: frozenset object has no attribute items (#2727)
• fix: create suppress HTTP instrumentation key in opentelemetry context (#2729)
• Support logs SDK auto instrumentation enable/disable with env (#2728)
• fix: update entry point object references for metrics (#2731)
• Allow set_status to accept the StatusCode and optional description (#2735)
• Configure auto instrumentation to support metrics (#2705)
• Add entrypoint for metrics exporter (#2748)
• Fix Jaeger propagator usage with NonRecordingSpan (#2762)
• Add opentelemetry.propagate module and opentelemetry.propagators package to the API reference documentation (#2785)

• Fix LoggingHandler to handle LogRecord with exc_info=False (#2690)
• Make metrics components public (#2684)
• Update to semantic conventions v1.11.0 (#2669)
• Update opentelemetry-proto to v0.17.0 (#2668)
• Add CallbackOptions to observable instrument callback params (#2664)
• Add timeouts to metric SDK (#2653)
• Add variadic arguments to metric exporter/reader interfaces (#2654)
• Added a opentelemetry.sdk.resources.ProcessResourceDetector that adds the 'process.runtime.{name,version,description}' resource attributes when used with the opentelemetry.sdk.resources.get_aggregated_resources API (#2660)
• Move Metrics API behind internal package (#2651)

This release includes the release candidate for metrics.

• Fix unhandled callback exceptions on async instruments
  (#2614)
• Rename DefaultCounter, DefaultHistogram, DefaultObservableCounter,
  DefaultObservableGauge, DefaultObservableUpDownCounter, DefaultUpDownCounter
  instruments to NoOpCounter, NoOpHistogram, NoOpObservableCounter,
  NoOpObservableGauge, NoOpObservableUpDownCounter, NoOpUpDownCounter
  (#2616)
• Deprecate InstrumentationLibraryInfo and Add InstrumentationScope
  (#2583)

• Add support for zero or more callbacks
  (#2602)
• Fix parsing of trace flags when extracting traceparent
  (#2577)
• Add default aggregation
  (#2543)
• Fix incorrect installation of some exporter “convenience” packages into
  “site-packages/src”
  (#2525)
• Capture exception information as part of log attributes
  (#2531)
• Change OTLPHandler to LoggingHandler
  (#2528)
• Fix delta histogram sum not being reset on collection
  (#2533)
• Add InMemoryMetricReader to metrics SDK
  (#2540)
• Drop the usage of name field from log model in OTLP
  (#2565)
• Update opentelemetry-proto to v0.15.0
  (#2566)
• Remove enable_default_view option from sdk MeterProvider
  (#2547)
• Update otlp-proto-grpc and otlp-proto-http exporters to have more lax requirements for backoff lib
  (#2575)
• Add min/max to histogram point
  (#2581)

• Docs rework: non-API docs are moving to opentelemetry.io. For details, including a list of pages that have moved, see #2453, and #2498.
• opentelemetry-exporter-otlp-grpc update SDK dependency to ~1.9.
  (#2442)
• bugfix(auto-instrumentation): attach OTLPHandler to root logger
  (#2450)
• Bump semantic conventions from 1.6.1 to 1.8.0
  (#2461)
• fix exception handling in get_aggregated_resources
  (#2464)
• Fix OTEL_EXPORTER_OTLP_ENDPOINT usage in OTLP HTTP trace exporter
  (#2493)
• [exporter/opentelemetry-exporter-prometheus] restore package using the new metrics API
  (#2321)

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)