CHANGELOG.md

Release History

1.0.0b47 (Unreleased)

Features Added

• Add auto detection for application ID from connection string if not set (#44644)
• Add support for user id and authId (#44662)

Breaking Changes

Bugs Fixed

Other Changes

• Update maximum size of custom properties (#44684)
• Declare support for Python 3.13 and 3.14 (#44550)

1.0.0b46 (2025-12-04)

Breaking Changes

• Fix to accommodate breaking log changes from Otel (#43626)
• Pin OpenTelemetry versions to guard against upstream logging breaking changes (#44220)

Bugs Fixed

• Fixes LogDeprecated warnings - LogDeprecatedInitWarning: LogRecord init with trace_id, span_id, and/or trace_flags is deprecated since 1.35.0. Use context instead (#44090)
• Fixes issue #43442: SyntaxWarning: 'return' in a 'finally' block in azure-monitor-opentelemetry-exporter with Python 3.14 (#44053)

Other Changes

• Commented OneSettings configuration manager temporarily to avoid user impact during feature testing. (#44179)

1.0.0b45 (2025-11-14)

Features Added

• Added new log record processor to support Trace Based Sampling (#43811)
• Added Operation Name Propagation for Dependencies and Logs (#43588)
• Added local storage support for multiple users on the same Linux system (#43483)

Bugs Fixed

• Modified logic for message body on Microsoft.ApplicationInsights.MessageData to include default message for messages with empty body and export logs (#43091)

Other Changes

• Unpinned fixedint dependency (#43475)
• Remove fixedint dependency (#43659)

1.0.0b44 (2025-10-14)

Bugs Fixed

• Fixed issue where AAD authentication for Live Metrics failed for users in sovereign cloud environments (#43392)

1.0.0b43 (2025-10-08)

Features Added

• OneSettings control plane: Add live metrics feature control (#43032)
• Adding customer sdkstats to feature statsbeat (#43066)
• OneSettings control plane: Add killswitch + exponential backoff + sdkstats feature control (#43147)
• Performance Counters (#43024)
• Performance Counters: Include Consumer spans (#43261)

Bugs Fixed

• Fixes issues #42897 - TypeError in _transmit_from_storage: LocalFileBlob.get() returns None (#42897)
• Fix logic for message field on Microsoft.ApplicationInsights.Message to sync with Breeze (#43060)
• Skip tests from test_storage.py causing transient build pipeline failures (#43122)
• Fix spelling for OTEL_PYTHON_EXCLUDED_URLS in samples (#43141)
• Revert #43060 (#43087)

1.0.0b42 (2025-09-17)

Features Added

• Customer Facing Statsbeat: Added remaining drop codes to base (#42382)
• Refactored the put methods in storage.py for LocalFileBlob and LocalFileStorage (#42502)
• Customer Facing Statsbeat: Refactored logic for tracking dropped items from storage (#42542)
• Customer Facing SDKStats: Added the export interval env var for customer sdkstats (#42551)
• Rename Customer Statsbeat to Customer SDKStats as per Spec (#42573)
• Customer Facing SDKStats: Exception categorization as per [Spec] - https://github.com/aep-health-and-standards/Telemetry-Collection-Spec/blob/main/ApplicationInsights/sdkstats/customer_facing_sdk_stats.md (#42695)
• Customer Facing SDKStats: Added logic for race conditions and updated the implementation to use a global instance for customer SDKStats metrics (#42655)
• Customer Facing SDKStats: Added telemetry_success field to dropped items as per [Spec] - https://github.com/aep-health-and-standards/Telemetry-Collection-Spec/pull/606 (#42846)

Bugs Fixed

• Customer Facing SDKStats: Refactor to use Manager and Singleton pattern (#42969)

Other Changes

• Configuration manager/worker fetch via OneSettings part 1 - Change detection ([#42360] Azure#42360)
• Configuration manager/worker fetch via OneSettings part 2 - Concurrency and refactoring of _ConfigurationManager ([#42508] Azure#42508)
• Refactoring of statsbeat to use StatsbeatManager ([#42716] Azure#42716)
• Support sdk stats dynamic change on OneSettings config change ([#42877] Azure#42877)

1.0.0b41 (2025-07-31)

Features Added

• Added RateLimited Sampler (#41954)
• Refactored Application Insights Sampler Code (#42210)

Other Changes

• Update minimum version of OpenTelemetry. Remove Python 3.8 support. (#42246)

1.0.0b40 (2025-07-17)

Features Added

• Detect synthetically created telemetry based on the user-agent header (#41733)
• Added customer-facing statsbeat preview. (#41669)
• Customer Facing Statsbeat: Added logic for dropped item count (#41950)
• Customer Facing Statsbeat: Added logic for retry item count (#41971)
• Support AI Foundry by Handling GEN_AI_SYSTEM Attributes with Spec (#41705)
• Distinguish Azure AI SDKs in statsbeats (#42016)
• Customer Facing Statsbeat: Updated base to include the metrics for customer statsbeat (#42123)

1.0.0b39 (2025-06-25)

Bugs Fixed

• Suppress stdout side effect of add permissions to file for local storage on Windows (#41727)

Other Changes

• Add logging errors for 401: Unauthorized and 403: Forbidden to assist in customer troubleshooting (#41767)

1.0.0b38 (2025-06-17)

Features Added

• Add AMW deduplicating flag, SentToAMW, for AKS Attach (#41410)
• Implement APPLICATIONINSIGHTS_METRICS_TO_LOGANALYTICS_ENABLED env var for AKS Attach . (#41383)

Bugs Fixed

• Fix for issue #41470. Added back exception message, removed earlier due to linting errors ([#41512] Azure#41512)
• Should leave ingestion to populate Device OS from User Agent ([#41549] Azure#41549)

Other Changes

• Update instrumentation list for Attach Statsbeat ([#41537] Azure#41537)

1.0.0b37 (2025-05-29)

Features Added

• Implement spec for k8s attribute logic. (#41130)

Bugs Fixed

• Do not count Functions as App Service (#41327)

Other Changes

• Extend version range for psutil to include 7.x (#40459)
• Add folder permissions for local files (#41384)

1.0.0b36 (2025-04-07)

Features Added

• Support syntheticSource from user_agent.synthetic.type semantic convention (#40004)
• Support server.address attributes when converting Azure SDK messaging spans to envelopes (#40059)
• Update AKS check to use KUBERNETES_SERVICE_HOST (#39941)
• Enabled Entra ID Credential configuration via env var (#40237)

1.0.0b35 (2025-03-04)

Features Added

• Support sending customEvent telemetry through special microsoft marker (#39886)
• Populate client_Ip on customEvent telemetry (#39923)

Bugs Fixed

• Implement from_log_record for Trace data types in live metrics (#39922)

1.0.0b34 (2025-02-26)

Features Added

• Support AAD for sovereign clouds (#39379)
• Support stable http semantic conventions for breeze exporter - REQUESTS (#39208)
• Support stable http semantic conventions for breeze exporter - DEPENDENCIES (#39441)
  • Support stable http semantic conventions for standard metrics + synthetic type for server standard metrics (#39799)

1.0.0b33 (2025-01-14)

Features Added

• Implement live metrics filtering for metrics (#37998)
• Add applying filter/validating filter logic to live metrics filtering (#38451)
• Implement live metrics filtering for docs (#38925)
• Implement live metrics + filtering for span event exceptions (#39168)

Bugs Fixed

• Detect live metrics usage during runtime in addition to on startup (#37694)
• Remove status code 206 from retry code + only count batch level for statsbeat (#38647)

Other Changes

• Refactored live metrics filtering modules (#38837)

1.0.0b32 (2024-11-04)

Breaking Changes

• Serialize complex objects provided as log or event bodies to JSON and fall back to string representation if they are not serializable. (#37694)

Other Changes

• Refactor trace mapping logic for target and data into trace utils (#37897)

1.0.0b31 (2024-10-08)

Features Added

• Allow tracking of whether in a Azure Functions attach scenario (#37717)

1.0.0b30 (2024-09-20)

Bugs Fixed

• Fix setting custom TracerProvider bug (#37469)

1.0.0b29 (2024-09-10)

Features Added

• Allow passing in of custom TracerProvider for AzureMonitorTraceExporter (#36363)
• Support AAD Auth for live metrics (#37258)

Other Changes

• Update instrumentation constants info (#36696)
• Refactor statsbeat utils functions (#36824)

1.0.0b28 (2024-07-29)

Other Changes

• Support for Python 3.12 (#36481)

1.0.0b27 (2024-06-21)

Features Added

• Implement redirect for live metrics (#35910)

Bugs Fixed

• Default missing/invalid status codes to "0" for standard metrics/trace payloads, change success criteria to False for those invalid cases, change success criteria to status_code < 400 for both client and server standard metrics (#36079)

1.0.0b26 (2024-05-29)

Bugs Fixed

• Handle invalid status codes in std metric payload (#35762)
• Disable distributed tracing for live metrics client calls (#35822)

Other Changes

• Update live metrics to use typespec generated swagger (#34840)
• Send old and new process level live metrics (#35753)

1.0.0b25 (2024-04-19)

Features Added

• Enable sampling for attach (#35218)

1.0.0b24 (2024-04-05)

Features Added

• Add live metrics collection of requests/dependencies/exceptions (#34673)
• Add live metrics collection of cpu time/process memory (#34735)
• Add live metrics collection feature detection to statsbeat (#34752)

Breaking Changes

• Rename Statbeat environments variables to use APPLICATIONINSIGHTS_* (#34742)

Bugs Fixed

• Reduce vm metadata service timeout to 200ms (#35039)

Other Changes

• Updated FastAPI sample (#34738)
• Set up branching logic for attach function (#35066)

1.0.0b23 (2024-02-28)

Features Added

• Add device.* to part A fields (#34229)
• Add live metrics exporting functionality (#34141)
• Add application.ver to part A fields (#34401)
• Add APPLICATIONINSIGHTS_METRIC_NAMESPACE_OPT_IN (#34463)

Other Changes

• Add attachType character to sdkVersion prefix (#34226)
• Add AKS scenarios to statsbeat metric and sdkVersion prefix (#34427)

1.0.0b22 (2024-02-01)

Features Added

• Add live metrics skeleton + swagger definitions (#33983)
• Only create temporary folder if local storage is enabled without storage directory. (#34061)

Bugs Fixed

• Update exception details messsage based on LogRecord body (#34020)

Other Changes

• Drop support for Python 3.7 (#34105)

1.0.0b21 (2024-01-16)

Other Changes

• Update to OTel SKD/API 1.21 (#33864)
• Update Django sample (#33834)

1.0.0b20 (2024-01-04)

Other Changes

• Store global instance of StatsbeatMetric (#33432)
• Shutdown statsbeat on customer getting 400 error code (#33489)
• Track custom events extension in feature statsbeat (#33667)
• Readme examples are updated with correct imports (#33691)
• Implement distro detection for statsbeat feature (#33761)
• Use empty resource for statsbeat MeterProvider (#33768)

1.0.0b19 (2023-11-20)

Bugs Fixed

• Fix deserialization of TelemetryItem from local storage (#33163)

1.0.0b18 (2023-11-06)

Bugs Fixed

• Default exception type for blank exceptions (#32327)
• Updated django samples with clearly artificial secret key (#32698)
• Remove metric namespace (#32897)

1.0.0b17 (2023-09-12)

Bugs Fixed

• Handle missing or empty message data (#31944)

1.0.0b16 (2023-08-30)

Features Added

• Export OTel Resource (#31355)
• Use observed timestamp for log record if timetamp is None (#31660)
• Support custom events (#31883)

Other Changes

• Unpin Opentelemetry SDK/API. (#31253)

1.0.0b15 (2023-07-17)

Features Added

• Upgrading to OpenTelemetry SDK/API 1.19. (#31170)

1.0.0b14 (2023-06-09)

Features Added

• Upgrading to OpenTelemetry SDK/API 1.18. (#30611)

1.0.0b13 (2023-04-11)

Features Added

• Enable AAD Credentials (#28888)
• Upgrading to OpenTelemetry SDK/API 1.17 (#29656)
• Updating sdkVersion prefix according to new spec. Using agents folder for marker. (#29730)

1.0.0b12 (2023-02-06)

Features Added

• Add sdkVersion prefix during App Service attach (#28637)
• Correcting sdkVersion prefix (#29227)

Bugs Fixed

• Update success criteria for requests (#28486)

Other Changes

• Loosen instrumentation key validation strictness (#28316)
• Disable storage for statsbeat if storage is disabled for exporter (#28322)
• Add UK to eu statsbeats (#28379)
• Update to opentelemetry api/sdk v1.15 (#28499)
• Update logging samples import paths to opentelemetry api/sdk v1.15 (#28646)

1.0.0b11 (2022-12-15)

Features Added

• Add pre-aggregated standard metrics - requests/duration, dependencies/duration (#26753)
• Add azure-sdk usage to instrumentations statsbeat (#27756)

Bugs Fixed

• Pinning OpenTelemetry SDK and API to between 1.12 and 1.14 to avoid bug from change in module path. Reverting [#27913] (#27958)
• Pass along sampleRate in SpanEvents from Span (#27629)

1.0.0b10 (2022-11-10)

Bugs Fixed

• Fix missing local storage attribute (#27405)
• Fix offline storage rename (#27414)

1.0.0b9 (2022-11-08)

Features Added

• Add Sampler factory and entry point (#27236)
• Add validation logic to ApplicationInsightsSampler (#26546)
• Change default temporality of metrics to follow OTLP (#26924)

Breaking Changes

• Rename local storage configuration, change default path (#26891)
• Change default storage retention period to 48 hours (#26960)

Bugs Fixed

• Fixed sampleRate field in ApplicationInsightsSampler, changed attribute to _MS.sampleRate (#26771)

Other Changes

• Update README.md (#26520)

1.0.0b8 (2022-09-26)

Features Added

• Implement success count network statsbeat (#25752)
• Implement all network statsbeat (#25845)
• Implement attach statsbeat (#25956)
• Implement feature statsbeat (#26009)
• Implement instrumentation statsbeat (#26023)
• Implement statsbeat shutdown (#26077)
• Add ApplicationInsightsSampler (#26224)
• Implement truncation logic for telemetry payload (#26257)
• Populate metric namespace with meter instrumentation scope name (#26257)

1.0.0b7 (2022-08-12)

Features Added

• Moved OpenTelemetry entry_points to setup.py (#25674)
• Added storage configuration options (#25633)

Breaking Changes

• Update to OpenTelemetry api/sdk v1.12.0 (#25659)

Bugs Fixed

• Opentelemetry span events have wrong ParentId in Azure Monitor logs (#25369)

1.0.0b6 (2022-06-10)

Features Added

• Added OpenTelemetry entry points for auto-instrumentation of Azure Monitor exporters (#25368)
• Implement log exporter using experimental OT logging sdk (#23486)
• Implement sending of exception telemetry via log exporter (#23633)
• Implement exporting span events as message/exception telemetry (#23708)
• Implement metrics exporter using experimental OT metrics sdk (#23960)

Breaking Changes

• Update to OpenTelemetry api/sdk 1.12.0rc1 (#24619)

1.0.0b5 (2021-10-05)

Features Added

• Support stamp specific redirect in exporters (#20489)

Breaking Changes

• Change exporter OT to AI mapping fields following common schema (#20445)

1.0.0b4 (2021-04-06)

Features Added

• Add from_connection_string method to instantiate exporters (#16818)

• Remove support for Python 3.5 (#17747)

1.0.0b3 (2021-02-11)

Breaking Changes

• The package has been renamed to azure-monitor-opentelemetry-exporter (#16621)
• Remove ExporterOptions (#16669)

Features Added

• Add azure servicebus samples and docstrings to samples (#16580)
• Support configuration of api_version in exporter (#16669)

1.0.0b2 (2021-01-13)

Breaking Changes

• Rename Azure Trace exporter class, only allow connection string configuration (#15349)

• OpenTelemetry Exporter use Resources API to retrieve cloud role props (#15816)

• Change span to envelope conversion to adhere to common schema and other languages (#15344)

• This library is renamed to azure-opentelemetry-exporter-azuremonitor. (#16030)

• Fix to only retry upon request error (#16087)

1.0.0b1 (2020-11-13)

Breaking Changes

• This library is renamed to microsoft-opentelemetry-exporter-azuremonitor.

0.5b.0 (2020-09-24)

• Change epoch for live metrics (#115)
• Dropping support for Python 3.4 (#117)

0.4b.0 (2020-06-29)

• Added live metrics (#96)
• Remove dependency metrics from auto-collection (#92)
• Change default local storage directory (#100)
• Implement proxies in exporter configuration (#101)
• Remove request failed per second metrics from auto-collection (#102)

0.3b.1 (2020-05-21)

• Fix metrics exporter serialization bug (#92)

0.3b.0 (2020-05-19)

• Implement max size logic for local storage (#74)
• Remove label sets + add is_remote to spancontext (#75)
• Adding live metrics manager (#78)
• Handle status 439 - Too Many Requests over extended time (#80)
• Fix breaking changes from OT release 0.7b.0 (#86)

0.2b.0 (2020-03-31)

• Initial beta release

0.1a.0 (2019-11-06)

• Initial alpha release

cSpell:enable