Version 1.5.1

Changes

• Fixes support of Python 3.12 and newer

Announcements in November 2023

While not related to this release, we want to use this opportunity to make users that are only watching releases aware of the following announcements that were published in November 2023:

• ⚠️ Deprecation announcement for older SDK versions: Version 1.4 has been put on the path to deprecation and will no longer be supported starting June 1, 2024. Only version 1.5 of the SDK (or any newer version) will be supported from that date on.
• ⚠️ Deprecation announcement for using any SDK version with older Python versions: SDK support for Python 3.4.x, 3.5.x, 3.6.x and 3.7.x has been put on the path to deprecation and no version of the SDK will be supported on Python 3.4.x, 3.5.x and 3.6.x starting June 1, 2024.
  Usage of the SDK on 3.7.x will remain supported until September 1, 2024.
  All Python versions below 3.8.x are already declared End of Life by the Python.org project, and customers are encouraged to upgrade to a newer Python version that is also supported by Python.org.

Version 1.5.0

ℹ️ Note: New important announcements have been added to the README on the master branch since this release.

This is Version 1.5.0 of the OneAgent SDK for Python, bundled with the OneAgent SDK for C/C++ v1.7.1 thus requiring the Dynatrace OneAgent version 1.251 or newer.

• README (including installation instructions)
• Downloads @ PyPI (binary Python wheels, etc.)
• Documentation

The Dynatrace OneAgent SDK for Python has GA status. The features are fully supported by Dynatrace.

Changes

• Adds limited W3C trace context support (for log enrichment).
• This version no longer supports Python 2 (Python 2.7.x).
• This version no longer supports Python 3.4.x.

Announcements

• ⚠️ Deprecation announcement for older SDK versions: Version 1.3 and all older versions have been put on the path to deprecation and will no longer be supported starting July 1, 2023. We strongly advise customers to upgrade to newest versions to avoid incompatibility and security risks. Customers need to upgrade to at least 1.4 but are encouraged to upgrade to the newest available version (1.5) if using Python >3.4 as there are no known incompatibilities or breaking changes other than the increased minimum Python version.
• ⚠️ Deprecation announcement for using any SDK version with older Python versions: Python 2.7.x has been put on the path to deprecation and no version of the SDK will be supported on this Python version starting July 1, 2023. Furthermore, we intend to release a similar deprecation announcement regarding versions 3.4-3.6 (which are no longer maintained by the Python project) soon (we plan that this will not become effective before 2023-07-01).

Version 1.4.0

This is Version 1.4.0 of the OneAgent SDK for Python, bundled with the OneAgent SDK for C/C++ v1.6.1 thus requiring the Dynatrace OneAgent version 1.179 or newer.

• README (including installation instructions)
• Downloads @ PyPI (binary Python wheels, etc.)
• Documentation

The Dynatrace OneAgent SDK for Python has GA status. The features are fully supported by Dynatrace.

Changelog

• Don't look for the agent module in PATH/LD_LIBRARY_PATH/... and disallow a relative path in the DT_HOME directory on Windows to prevent DLL hijacking issues.
• Fixed a bug that might lead to crashes in the SDK's shutdown phase
• Support for Python versions < 3.5 is deprecated. The OneAgent SDK for Python will still work with this release, but this might change in the future.
• Following versions of the OneAgent SDK for Python are considered deprecated and might not be supported in the future. Applications using it should be upgraded to the latest release.
  • Version 1.1.0
  • Version 1.2.0
  • Version 1.2.1

Version 1.3.0

This is Version 1.3.0 of the OneAgent SDK for Python, bundled with the OneAgent SDK for C/C++ v1.5.1 thus requiring the Dynatrace OneAgent version 1.179 or newer.

• README (including installation instructions)
• Downloads @ PyPI (binary Python wheels, etc.)
• Documentation

The Dynatrace OneAgent SDK for Python has GA status. The features are fully supported by Dynatrace.

Changelog

• Fork support
• Improved diagnostics in case of installation problems
• Readme bug fixes

Version 1.2.1

This is Version 1.2.1 of the OneAgent SDK for Python, bundled with the OneAgent SDK for C/C++ v1.4.1 thus requiring the Dynatrace OneAgent version 1.161 or newer.

• README (including installation instructions)
• Downloads @ PyPI (binary Python wheels, etc.)
• Documentation

The Dynatrace OneAgent SDK for Python has GA status. The features are fully supported by Dynatrace.

Changelog

• Readme bug fixes
• Bug fix: the minimum stub version wasn't correctly set

Version 1.2.0

This is Version 1.2 of the OneAgent SDK for Python, bundled with the OneAgent SDK for C/C++ v1.4.1 thus requiring the Dynatrace OneAgent version 1.161 or newer.

• README (including installation instructions)
• Downloads @ PyPI (binary Python wheels, etc.)
• Documentation

The Dynatrace OneAgent SDK for Python is currently in beta status. The features are fully supported by Dynatrace.

Changelog

Added Features

• Tracing support for messaging
• Tracing support for custom services

Version 1.1.0

This is Version 1.1 of the OneAgent SDK for Python, bundled with the OneAgent SDK for C/C++ v1.3.1 thus requiring the Dynatrace OneAgent version 1.151 or newer.

• README (including installation instructions)
• Downloads @ PyPI (binary Python wheels, etc.)
• Documentation

The Dynatrace OneAgent SDK for Python is currently in beta status. The features are fully supported by Dynatrace.

Changelog

Added Features

• Outgoing web requests
• In-process linking
• Custom request attributes

Breaking Changes

The SDK initialization has changed. Until now you had the possibility to initialize the SDK using
two methods:

• oneagent.try_init()
• oneagent.sdk.SDK.get()

The latter method implicitly initialized the SDK. This was changed in 1.1.0. Both methods were removed.
Now it's mandatory to call oneagent.initialize() to initialize the SDK and oneagent.shutdown() to shut the SDK down. For each initialize call there must be a corresponding shutdown call.

The oneagent.sdk.SDK.get() method was replaced by a new oneagent.get_sdk() method which does not implicitly initialize the SDK anymore. If this new method is called without previously initializing the SDK then a dummy (non-functional) SDK instance will be returned. This instance won't do anything if it is used later.

Version 1.0.0

This is Version 1.0 of the OneAgent SDK for Python, bundled with the OneAgent SDK for C/C++ v1.1.0 thus requiring the Dynatrace OneAgent version 1.141 or newer.

• README (including installation instructions)
• Downloads @ PyPI (binary Python wheels, etc.)
• Documentation

This is the first public release of the OneAgent SDK for Python, so there is no changelog.