skillfed

instana

Python Distributed Tracing & Metrics Sensor for Instana.

instana v3.17.0 129.1K downloads/30d#11,681 on PyPI68
Permissive license MIT Active released

What it is and what it does

Instana is a Python instrumentation library that integrates with the Instana monitoring platform to collect application metrics and distributed traces automatically. It works by instrumenting your Python application—either through environment variable activation without code changes or by importing the package directly—and then reporting performance data and trace information to a local Instana host agent. The package builds on OpenTelemetry standards and includes support for common frameworks like Django and Flask.

The library handles the complexity of tracing function calls, capturing request/response data, and measuring performance across your application stack. It's designed for developers who want visibility into their Python applications' behavior and performance without extensive manual instrumentation code. The package supports Python 3.9 through 3.14 and is actively maintained.

Use it for:

  • Monitor distributed traces across microservices to diagnose latency and performance bottlenecks in production
  • Collect application metrics automatically without modifying application code by setting AUTOWRAPT_BOOTSTRAP
  • Instrument Django or Flask web applications to track request handling and downstream service calls
  • Integrate with existing Instana monitoring infrastructure to correlate application metrics with infrastructure data
  • Track end-user monitoring data alongside server-side traces for complete application visibility

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Instana is a Python instrumentation package that automatically collects metrics and distributed traces from your application, reporting them to an Instana monitoring agent.

Yes, if you are already using Instana for infrastructure monitoring and need Python application instrumentation. The low install friction, active maintenance, permissive license, and automatic instrumentation capability make it a straightforward choice for that use case. No, if you need a general-purpose tracing library independent of the Instana platform—consider OpenTelemetry directly instead.

Install

instana on PyPI

pip

pip install instana

uv

uv add instana

poetry

poetry add instana

Installing instana

Before you install

Low install friction: pure Python wheel with 9 runtime dependencies including widely-used packages like requests, pyyaml, and opentelemetry-api. Active maintenance with a release on 2026-08-14 and recent repository activity.

License in practice

MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.

Quickstart

pip install instana

# Automatic activation via environment variable:
export AUTOWRAPT_BOOTSTRAP=instana

# Or manual activation in code:
import instana

Requires Python 3.9 or later. Instana host agent must be running to report metrics and traces.

Verify before relying

  • Whether automatic instrumentation via AUTOWRAPT_BOOTSTRAP covers all common frameworks or requires additional configuration
  • Performance overhead of automatic instrumentation on typical application workloads
  • Compatibility with specific ASGI frameworks or async Python applications

Package facts

License MIT (permissive)
Python support supports the current Python release (>=3.9)
Install friction low — pure-Python wheel
Runtime dependencies 9 — autowrapt, fysom, opentelemetry-api, opentelemetry-semantic-conventions, psutil, pyyaml, requests, typing-extensions, urllib3
Maintenance actively maintained — 0 days since the last release
Last repo commit
First released
Downloads 129,122/month — #11,681 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: instana-3.17.0-py3-none-any.whl

Keywords: distributed-tracing, metrics, monitoring, opentelemetry, performance, tracing

Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Information TechnologyIntended Audience :: Science/ResearchIntended Audience :: System AdministratorsLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonTopic :: Internet :: WWW/HTTP :: WSGI :: MiddlewareTopic :: Software Development :: Libraries :: Python ModulesTopic :: System :: MonitoringTopic :: System :: Networking :: Monitoring

Tags

distributed tracing pythonapplication metrics collectionopentelemetry instrumentationpython performance monitoringautomatic application instrumentationwsgi middleware tracinginstana agent integration
observabilitydistributed-tracingopentelemetry

More Python Modules packages

idna

Converts domain names between Unicode and…

permissive · top 100 on PyPI

setuptools

Setuptools is a Python build backend and…

permissive · top 100 on PyPI

PyYAML

PyYAML parses and emits YAML 1.1 data format,…

permissive · top 100 on PyPI

pydantic

Pydantic validates Python data structures…

permissive · top 100 on PyPI

annotated-types

Provides reusable metadata objects for use with…

permissive · top 100 on PyPI

typing-inspection

Provides runtime tools to inspect and…

permissive · top 100 on PyPI

opentelemetry-instrumentation-asyncio

Adds distributed tracing and metrics to asyncio…

permissive · top 5,000 on PyPI

opentelemetry-instrumentation-flask

Adds distributed tracing to Flask web…

permissive · top 1,000 on PyPI

opentelemetry-instrumentation-wsgi

Provides WSGI middleware for OpenTelemetry that…

permissive · top 1,000 on PyPI

opentelemetry-instrumentation-agno

Automatically instruments the Agno framework to…

permissive · top 5,000 on PyPI

opentelemetry-instrumentation-falcon

Adds distributed tracing to Falcon web…

permissive · top 5,000 on PyPI

opentelemetry-instrumentation-pyramid

Adds automatic tracing and metrics collection…

permissive · top 5,000 on PyPI

opentelemetry-instrumentation

Provides automatic instrumentation commands and…

permissive · top 1,000 on PyPI

autodynatrace

Autodynatrace wraps the Dynatrace OneAgent SDK…

permissive · top 15,000 on PyPI

opentelemetry-instrumentation-openai-agents

Adds distributed tracing to OpenAI Agents…

permissive · top 5,000 on PyPI

opentelemetry-instrumentation-asgi

Provides ASGI middleware for OpenTelemetry that…

permissive · top 1,000 on PyPI