Oneagent-sdk

**Requires Dynatrace OneAgent version 1.251 or newer.**

Changes:

* Add W3C trace context support for log enrichment (not for tagging/linking).

Other announcements:

* ⚠️ **Deprecation announcement:** Version 1.5.1 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.6.1 but are encouraged to upgrade to the newest available version (1.7.1) as there are no known incompatibilities or breaking changes.

**Requires Dynatrace OneAgent version 1.179 or newer.**

Changes:

* Deprecated all metrics-related APIs. The [Metric ingestion page](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/) provides further information on how to replace these APIs and how to report metrics data from now on
* Don't look for agent module in `PATH/LD_LIBRARY_PATH/...` and disallow relative `DT_HOME` on Windows to prevent possible DLL hijacking issues.

**Requires Dynatrace OneAgent version 1.179 or newer.**

Changes:
* Added [**metrics** API](https://github.com/Dynatrace/OneAgent-SDK-for-C/blob/v1.5.1/README.md#metrics) to report custom metric data to Dynatrace ([**preview feature**](https://www.dynatrace.com/support/help/shortlink/preview-and-early-adopter-releases)).
* Improved logging callback APIs ([`onesdk_agent_set_warning_callback`](https://dynatrace.github.io/OneAgent-SDK-for-C/group__misc.html#ga31c7f418f4b3515097434f8df6810cad) replaces [`onesdk_agent_set_logging_callback`](https://dynatrace.github.io/OneAgent-SDK-for-C/group__misc.html#ga3962855fa4d4c78665b96c5b12774c02) and the new [`onesdk_agent_set_verbose_callback`](https://dynatrace.github.io/OneAgent-SDK-for-C/group__misc.html#ga1324a8c95a407255e838641e8a8f03a9) can be used to get valuable debugging information).
* New function [`onesdk_agent_get_fork_state`](https://dynatrace.github.io/OneAgent-SDK-for-C/group__misc.html#ga77260efaf63455969962e05b6b170135). See also ["Using the Dynatrace OneAgent SDK with forked child processes" in the README](https://github.com/Dynatrace/OneAgent-SDK-for-C/blob/v1.5.1/README.md#forking)).
* Improved and restructured [README](https://github.com/Dynatrace/OneAgent-SDK-for-C/blob/v1.5.1/README.md).
* Improved error messages in certain situations when loading the agent fails.

> ℹ️ Note: New important announcements have been added to the [README on the master branch](https://github.com/Dynatrace/OneAgent-SDK-for-Python/blob/master/README.md#release-notes-and-announcements) 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](https://github.com/Dynatrace/OneAgent-SDK-for-C/releases/tag/v1.7.1) thus requiring the Dynatrace OneAgent version 1.251 or newer.

* [README](https://github.com/Dynatrace/OneAgent-SDK-for-Python/blob/v1.5.0/README.md) (including installation instructions)
* [Downloads PyPI](https://pypi.org/project/oneagent-sdk/1.5.0.20221221.150433/) (binary Python wheels, etc.)
* [Documentation](https://dynatrace.github.io/OneAgent-SDK-for-Python/v1.5.0/docs)

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

Changes

* Adds limited [W3C trace context](https://github.com/Dynatrace/OneAgent-SDK-for-Python/blob/v1.5.0/README.md#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).

**Requires Dynatrace OneAgent version 1.161 or newer.**

Changes:
* [Added tracing support for messaging](https://github.com/Dynatrace/OneAgent-SDK-for-C/blob/v1.4.1/README.md#using-the-dynatrace-oneagent-sdk-to-trace-messaging)
* [Added tracing support for custom services](https://github.com/Dynatrace/OneAgent-SDK-for-C/blob/v1.4.1/README.md#using-the-dynatrace-oneagent-sdk-to-trace-custom-service-methods)

This is Version 1.4.0 of the OneAgent SDK for Python, bundled with the [OneAgent SDK for C/C++ v1.6.1](https://github.com/Dynatrace/OneAgent-SDK-for-C/releases/tag/v1.6.1) thus requiring the Dynatrace OneAgent version 1.179 or newer.

* [README](https://github.com/Dynatrace/OneAgent-SDK-for-Python/blob/v1.4.0/README.md) (including installation instructions)
* [Downloads PyPI](https://pypi.org/project/oneagent-sdk/1.4.0.20210127.165413) (binary Python wheels, etc.)
* [Documentation](https://dynatrace.github.io/OneAgent-SDK-for-Python/v1.4.0/docs)

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.