Skip to content

🐍 Python Distributed Tracing & Metrics Sensor for Instana

License

Notifications You must be signed in to change notification settings

instana/python-sensor

Repository files navigation

Instana

The instana Python package collects key metrics and distributed traces for Instana.

Any feedback is welcome. Happy Python visibility.

CircleCI OpenTracing Badge OpenTelemetry Badge Python Version from PEP 621 TOML GitHub Release

Note

Support for OpenTracing is deprecated starting on version 3.0.0. If you still want to use it, rely on any version earlier than 3.0.0 or use the legacy_2.x branch.

Installation

Instana remotely instruments your Python web servers automatically via Instana AutoTrace™️. To configure which Python processes this applies to, see the configuration page.

Manual Installation

If you wish to instrument your applications manually, you can install the package with the following into the virtualenv, pipenv, or container (hosted on PyPI):

pip install instana

or to alternatively update an existing installation:

pip install -U instana

Activating Without Code Changes

The Instana package can then be activated without any code changes required by setting the following environment variable for your Python application:

export AUTOWRAPT_BOOTSTRAP=instana

This will cause the Instana Python package to instrument your Python application automatically. Once it finds the Instana host agent, it will report Python metrics and distributed traces.

Activating via Import

Alternatively, if you prefer the manual method, import the instana package inside of your Python application:

import instana

See also our detailed installation document for additional information covering Django, Flask, End-user Monitoring (EUM), and more.

Documentation

You can find more documentation covering supported components and minimum versions in the Instana documentation portal.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/instana/python-sensor.

More

Want to instrument other languages? See our Node.js, Go, Ruby instrumentation or many other supported technologies.