opentelemetry-python

• Standardizing timeout calculation in measurement consumer collect to nanoseconds (#4074)
• optional scope attributes for logger creation (#4035)
• optional scope attribute for tracer creation (#4028)
• OTLP exporter is encoding invalid span/trace IDs in the logs fix (#4006)
• Update sdk process resource detector process.command_args attribute to also include the executable itself (#4032)
• Fix start_time_unix_nano for delta collection for explicit bucket histogram aggregation (#4009)
• Fix start_time_unix_nano for delta collection for sum aggregation (#4011)
• Update opentracing and opencesus docs examples to not use JaegerExporter (#4023)
• Do not execute Flask Tests in debug mode (#3956)
• When encountering an error encoding metric attributes in the OTLP exporter, log the key that had an error. (#3838)
• Fix ExponentialHistogramAggregation (#3978)
• Log a warning when a LogRecord in sdk/log has dropped attributes due to reaching limits (#3946)
• Fix RandomIdGenerator can generate invalid Span/Trace Ids (#3949)
• Add Python 3.12 to tox (#3616)
• Improve resource field structure for LogRecords (#3972)
• Update Semantic Conventions code generation scripts: - fix namespace exclusion that resulted in dropping os and net namespaces. - add Final decorator to constants to prevent collisions - enable mypy and fix detected issues - allow to drop specific attributes in preparation for Semantic Conventions v1.26.0 (#3973)
• Update semantic conventions to version 1.26.0. (#3964)
• Use semconv exception attributes for record exceptions in spans (#3979)
• Fix _encode_events assumes events.attributes.dropped exists (#3965)
• Validate links at span creation (#3991)
• Add attributes field in MeterProvider.get_meter and InstrumentationScope (#4015)
• Fix inaccessible SCHEMA_URL constants in opentelemetry-semantic-conventions (#4069)

• Fix class BoundedAttributes to have RLock rather than Lock (#3859)
• Remove thread lock by loading RuntimeContext explicitly. (#3763)
• Update proto version to v1.2.0 (#3844)
• Add to_json method to ExponentialHistogram (#3780)
• Bump mypy to 1.9.0 (#3795)
• Fix exponential histograms (#3798)
• Fix otlp exporter to export log_record.observed_timestamp (#3785)
• Add capture the fully qualified type name for raised exceptions in spans (#3837)
• Prometheus exporter sort label keys to prevent duplicate metrics when user input changes order (#3698)
• Update semantic conventions to version 1.25.0. Refactor semantic-convention structure: - SpanAttributes, ResourceAttributes, and MetricInstruments are deprecated. - Attribute and metric definitions are now grouped by the namespace. - Stable attributes and metrics are moved to opentelemetry.semconv.attributes and opentelemetry.semconv.metrics modules. - Stable and experimental attributes and metrics are defined under opentelemetry.semconv._incubating import path. (#3586)
• Rename test objects to avoid pytest warnings ([#3823] (https://github.com/open-telemetry/opentelemetry-python/pull/3823))
• Add span flags to OTLP spans and links (#3881)
• Record links with invalid SpanContext if either attributes or TraceState are not empty (#3917)
• Add OpenTelemetry trove classifiers to PyPI packages ([#3913] (https://github.com/open-telemetry/opentelemetry-python/pull/3913))
• Fix prometheus metric name and unit conversion (#3924) - this is a breaking change to prometheus metric names so they comply with the specification. - you can temporarily opt-out of the unit normalization by setting the environment variable OTEL_PYTHON_EXPERIMENTAL_DISABLE_PROMETHEUS_UNIT_NORMALIZATION=true - common unit abbreviations are converted to Prometheus conventions (s -> seconds), following the collector's implementation - repeated _ are replaced with a single _ - unit annotations (enclosed in curly braces like {requests}) are stripped away - units with slash are converted e.g. m/s -> meters_per_second. - The exporter's API is not changed
• Add parameters for Distros and configurators to configure autoinstrumentation in addition to existing environment variables. ([#3864] (https://github.com/open-telemetry/opentelemetry-python/pull/3864))

• Make create_gauge non-abstract method (#3817)
• Make tracer.start_as_current_span() decorator work with async functions (#3633)
• Fix python 3.12 deprecation warning (#3751)
• bump mypy to 0.982 (#3776)
• Add support for OTEL_SDK_DISABLED environment variable (#3648)
• Fix ValueError message for PeriodicExportingMetricsReader (#3769)
• Use BaseException instead of Exception in record_exception (#3354)
• Make span.record_exception more robust (#3778)
• Fix license field in pyproject.toml files (#3803)

• Use Attribute rather than boundattribute in logrecord (#3567)
• Fix flush error when no LoggerProvider configured for LoggingHandler (#3608)
• Fix OTLPMetricExporter ignores preferred_aggregation property (#3603)
• Logs: set observed_timestamp field (#3565)
• Add missing Resource SchemaURL in OTLP exporters (#3652)
• Fix loglevel warning text (#3566)
• Prometheus Exporter string representation for target_info labels (#3659)
• Logs: ObservedTimestamp field is missing in console exporter output (#3564)
• Fix explicit bucket histogram aggregation (#3429)
• Add code.lineno, code.function and code.filepath to all logs (#3645)
• Add Synchronous Gauge instrument (#3462)
• Drop support for 3.7 (#3668)
• Include key in attribute sequence warning (#3639)
• Upgrade markupsafe, Flask and related dependencies to dev and test environments (#3609)
• Handle HTTP 2XX responses as successful in OTLP exporters (#3623)
• Improve Resource Detector timeout messaging (#3645)
• Add Proxy classes for logging (#3575)
• Remove dependency on 'backoff' library (#3679)

• Prometheus exporter sanitize info metric (#3572)
• Remove Jaeger exporters (#3554)
• Log stacktrace on UNKNOWN status OTLP export error (#3536)
• Fix OTLPExporterMixin shutdown timeout period (#3524)
• Handle taskName logrecord attribute (#3557)

• Fix SumAggregation  (#3390)
• Fix handling of empty metric collection cycles (#3335)
• Fix error when no LoggerProvider configured for LoggingHandler (#3423)
• Make opentelemetry_metrics_exporter entrypoint support pull exporters (#3428)
• Allow instrument names to have '/' and up to 255 characters (#3442)
• Do not load Resource on sdk import (#3447)
• Update semantic conventions to version 1.21.0 (#3251)
• Add missing schema_url in global api for logging and metrics (#3251)
• Prometheus exporter support for auto instrumentation (#3413)

• Modify Prometheus exporter to translate non-monotonic Sums into Gauges (#3306)

• Drop setuptools runtime requirement. (#3372)
• Update the body type in the log ($3343)
• Add max_scale option to Exponential Bucket Histogram Aggregation (#3323)
• Use BoundedAttributes instead of raw dict to extract attributes from LogRecord (#3310)
• Support dropped_attributes_count in LogRecord and exporters (#3351)
• Add unit to view instrument selection criteria (#3341)
• Upgrade opentelemetry-proto to 0.20 and regen #3355)
• Include endpoint in Grpc transient error warning #3362)
• Fixed bug where logging export is tracked as trace #3375)

• Select histogram aggregation with an environment variable (#3265)
• Move Protobuf encoding to its own package (#3169)
• Add experimental feature to detect resource detectors in auto instrumentation (#3181)
• Fix exporting of ExponentialBucketHistogramAggregation from opentelemetry.sdk.metrics.view (#3240)
• Fix headers types mismatch for OTLP Exporters (#3226)
• Fix suppress instrumentation for log batch processor (#3223)
• Add speced out environment variables and arguments for BatchLogRecordProcessor (#3237)

• Implement LowMemory temporality (#3223)
• PeriodicExportingMetricReader will continue if collection times out (#3100)
• Fix formatting of ConsoleMetricExporter. (#3197)
• Fix use of built-in samplers in SDK configuration (#3176)
• Implement shutdown procedure forOTLP grpc exporters (#3138)
• Add exponential histogram (#2964)
• Add OpenCensus trace bridge/shim (#3210)

• Change __all__ to be statically defined. (#3143)

• Remove the ability to set a global metric prefix for Prometheus exporter (#3137)

• Adds environment variables for log exporter (#3037)

• Add attribute name to type warning message. (3124)

• Add db metric name to semantic conventions (#3115)

• Fix User-Agent header value for OTLP exporters to conform to RFC7231 & RFC7230 (#3128)

• Fix validation of baggage values (#3058)

• Fix capitalization of baggage keys (#3151)

• Bump min required api version for OTLP exporters (#3156)

• deprecate jaeger exporters (#3158)

• Create a single resource instance (#3118)

• Regenerate opentelemetry-proto to be compatible with protobuf 3 and 4 (#3070)
• Rename parse_headers to parse_env_headers and improve error message (#2376)
• Add url decode values from OTEL_RESOURCE_ATTRIBUTES (#3046)
• Fixed circular dependency issue with custom samplers (#3026)
• Add missing entry points for OTLP/HTTP exporter (#3027)
• Update logging to include logging api as per specification (#3038)
• Fix: Avoid generator in metrics _ViewInstrumentMatch.collect() (#3035
• [exporter-otlp-proto-grpc] add user agent string (#3009)

• Add logarithm and exponent mappings (#2960)
• Add and use missing metrics environment variables (#2968)
• Enabled custom samplers via entry points (#2972)
• Update log symbol names (#2943)
• Update explicit histogram bucket boundaries (#2947)
• exporter-otlp-proto-http: add user agent string (#2959)
• Add http-metric instrument names to semantic conventions (#2976)
• [exporter/opentelemetry-exporter-otlp-proto-http] Add OTLPMetricExporter (#2891)
• Add support for py3.11 (#2997)
• Fix a bug with exporter retries for with newer versions of the backoff library (#2980)

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)