instana

library3.15.0pypypi✓ verified 85d ago

Automatic distributed tracing and metrics collection for Python applications, designed to work with the Instana observability platform. Version 3.14.0 requires Python >=3.9. Active development with frequent releases every few weeks.

observability

pip install instana

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · INSTANA

instana

observabilitypythonv3.15.0

Install

4.7s avg

Import

1028ms

Disk

29MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.15.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 1.070s · 29.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.7s · import 0.986s · 31MB

29MB installed

● package 29MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

instana

✓ import instana

No common mistake; the package auto-instruments supported frameworks upon import.

Importing the module auto-starts the sensor. Set INSTANA_AGENT_HOST environment variable to point to your Instana agent.

import instana import os # Agent host can be set via env var INSTANA_AGENT_HOST os.environ.get('INSTANA_AGENT_HOST', '') # The sensor starts automatically when imported print('Instana sensor initialized')

Debug

Known issues

gotchaThe Instana sensor auto-instruments many frameworks (Django, Flask, etc.). If you see unexpected spans or performance overhead, check the list of supported frameworks. You can disable instrumentation for specific frameworks via environment variables.

fix

Set INSTANA_DISABLE_<FRAMEWORK>=true to disable auto-instrumentation for that framework.

affects: all

gotchaThe agent host must be reachable; otherwise the sensor will buffer spans locally until timeout. Spans may be lost if agent is unreachable for too long.

fix

Ensure INSTANA_AGENT_HOST is set correctly and network connectivity exists. For Kubernetes, use the agent's DNS or IP.

affects: all

deprecatedOlder Python versions (3.7, 3.8) are no longer supported as of v3.0.0+.

fix

Upgrade to Python >=3.9.

affects: >=3.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'instana'

Package not installed or imported incorrectly.

fix

Install with 'pip install instana' and 'import instana' in your code.

instana.collector.Collector: Failed to report spans to agent at http://localhost:42699/com.instana.plugin.python.spans

Instana agent is not running or unreachable on the default host/port.

fix

Start the Instana agent, or set INSTANA_AGENT_HOST environment variable to the correct agent endpoint.

AttributeError: module 'instana' has no attribute 'span'

Incorrect use of the API; the library does not expose a public 'span' attribute. Use instana.current_span() or instana.span_context.

fix

Use 'instana.current_span()' to get the active span, or read the documentation for custom spans.

Upgrade

Version history

3.15.0latest on PyPI · released May 15, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

23 hits · last 30 days

node

OpenAI (training)

Amazon

Resources

githubhttps://github.com/instana/python-sensor ↗

packagehttps://pypi.org/project/instana/ ↗

homepagehttps://instana.com ↗

docshttps://ibm.biz/monitoring-python ↗