---
id: oneagent-sdk
version: "1.5.2.20260107.153442"
license: Apache License 2.0
license_treatment: permissive
maintenance: aging
---

# oneagent-sdk — Dynatrace OneAgent SDK for Python

License: permissive · Maintenance: aging · Downloads: 124.7K/mo

## What it is and what it does

The Dynatrace OneAgent SDK for Python is an instrumentation library that integrates Python applications with Dynatrace's monitoring platform. It wraps the OneAgent SDK for C/C++ (bundled with each release) and provides Python-friendly APIs to trace application behavior at the request level, including remote calls, SQL queries, incoming and outgoing HTTP requests, custom services, and message queues. The SDK automatically switches to a native Python code module implementation if Dynatrace's OneAgent is injected into the process.

The package is designed for developers who already run Dynatrace OneAgent in their environment and need to extend monitoring visibility into Python-specific code paths. It requires CPython 3.8 or newer, manylinux1-compatible Linux or Windows x86/x86-64 systems, and a compatible Dynatrace OneAgent version. The SDK provides context propagation via W3C trace context and supports forked child processes on Linux, making it suitable for both traditional and containerized deployments.

Use it for:

- Trace custom Python service methods and remote procedure calls to correlate them with Dynatrace's end-to-end transaction monitoring.
- Instrument SQL database queries to capture execution time and query details within the broader request context.
- Capture incoming and outgoing HTTP requests to map service dependencies and detect performance bottlenecks.
- Tag requests with custom attributes for business-level correlation and filtering in Dynatrace dashboards.
- Monitor asynchronous task execution and message queue operations to track distributed work across services.
- Integrate with forked child processes on Linux to maintain trace continuity across process boundaries.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Extends Dynatrace monitoring into Python applications by providing tracers for request-level visibility into remote calls, database queries, web requests, and custom services.

Yes, if you already run Dynatrace OneAgent and need Python-level request tracing. The SDK is production-stable, permissively licensed, and actively maintained. Install friction is moderate due to platform-specific wheels and C/C++ dependencies, but this is expected for a monitoring SDK. No known vulnerabilities. Not suitable for serverless environments (AWS Lambda); use OpenTelemetry instead.

## Install

pip install oneagent-sdk
uv add oneagent-sdk
poetry add oneagent-sdk

## Installing oneagent-sdk

Before you install: Medium install friction due to platform-specific wheels (Linux i686/x86_64, Windows 32/64-bit); requires pip 8.1.0 or newer and bundled C/C++ SDK dependencies. Last release was 219 days ago; repository is active but aging.

License in practice: Apache License 2.0 (permissive) allows commercial and private use with minimal restrictions; suitable for most production deployments.

Quickstart:

pip install oneagent-sdk

import oneagent
oneagent_sdk = oneagent.get_sdk()
tracer = oneagent_sdk.trace_incoming_web_request('GET', 'https://example.com')

Requires CPython 3.8 or newer (3.9+ recommended); Linux must be manylinux1-compatible (not Alpine); Windows requires x86 or x86-64 architecture; Dynatrace OneAgent version ≥1.251 (C/C++) required.

Verify before relying:

- Whether the SDK automatically selects between C/C++ wrapper and Python code module implementations at runtime.
- Support status for Python 3.8 beyond current deprecation warning timeline.
- Compatibility with async/await frameworks beyond in-process asynchronous execution tracing.
- Performance overhead of tracing on high-throughput applications.

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: aging
- Downloads: 124.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dynatrace python monitoring, application performance monitoring sdk, python request tracing, dynatrace oneagent integration, distributed tracing python, application instrumentation, python apm sdk, apm, dynatrace, instrumentation

[View on SkillFed](https://skillfed.io/packages/oneagent-sdk) · [View on PyPI](https://pypi.org/project/oneagent-sdk/)