# Instana
The `instana` Python package collects key metrics and distributed traces for [Instana].
Any feedback is welcome. Happy Python visibility.
[](https://circleci.com/gh/instana/python-sensor/tree/main)
[](http://opentracing.io)
[](http://opentelemetry.io)
> [!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].
<!-- Reference links -->
[Instana]: https://www.instana.com/ "IBM Instana Observability"
[Instana AutoTrace™️]: https://www.ibm.com/docs/en/instana-observability/current?topic=kubernetes-instana-autotrace-webhook "Instana AutoTrace"
[configuration page]: https://www.ibm.com/docs/en/instana-observability/current?topic=package-python-configuration-configuring-instana#general "Instana Python package configuration"
[PyPI]: https://pypi.python.org/pypi/instana "Instana package at PyPI"
[installation document]: https://www.ibm.com/docs/en/instana-observability/current?topic=technologies-monitoring-python-instana-python-package#installation-methods "Instana Python package installation methods"
[documentation portal]: https://www.ibm.com/docs/en/instana-observability/current?topic=technologies-monitoring-python-instana-python-package "Instana Python package documentation"
[Node.js]: https://github.com/instana/nodejs "Instana Node.JS Tracer"
[Go]: https://github.com/instana/golang-sensor "Instana Go Tracer"
[Ruby]: https://github.com/instana/ruby-sensor "Instana Ruby Tracer"
[supported technologies]: https://www.instana.com/supported-technologies/ "Instana supported technologies"
Raw data
{
"_id": null,
"home_page": null,
"name": "instana",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "distributed-tracing, metrics, monitoring, opentelemetry, performance, tracing",
"author": "Instana Team Python Tracer Engineers",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/15/6e/56bea9d1ddb46624f9b47a57026503b620e5fab2cc967877794e7168e716/instana-3.8.2.tar.gz",
"platform": null,
"description": "# Instana\n\nThe `instana` Python package collects key metrics and distributed traces for [Instana].\n\nAny feedback is welcome. Happy Python visibility.\n\n[](https://circleci.com/gh/instana/python-sensor/tree/main)\n[](http://opentracing.io)\n[](http://opentelemetry.io)\n\n\n\n> [!NOTE]\n> 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.\n\n## Installation\n\nInstana remotely instruments your Python web servers automatically via [Instana AutoTrace\u2122\ufe0f]. To configure which Python processes this applies to, see the [configuration page].\n\n## Manual Installation\n\nIf you wish to instrument your applications manually, you can install the package with the following into the `virtualenv`, `pipenv`, or container (hosted on [PyPI]):\n\n pip install instana\n\nor to alternatively update an existing installation:\n\n pip install -U instana\n\n### Activating Without Code Changes\n\nThe Instana package can then be activated _without any code changes required_ by setting the following environment variable for your Python application:\n\n export AUTOWRAPT_BOOTSTRAP=instana\n\nThis 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.\n\n### Activating via Import\n\nAlternatively, if you prefer the manual method, import the `instana` package inside of your Python application:\n\n import instana\n\nSee also our detailed [installation document] for additional information covering Django, Flask, End-user Monitoring (EUM), and more.\n\n## Documentation\n\nYou can find more documentation covering supported components and minimum versions in the Instana [documentation portal].\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/instana/python-sensor.\n\n## More\n\nWant to instrument other languages? See our [Node.js], [Go], [Ruby] instrumentation or many other [supported technologies].\n\n<!-- Reference links -->\n[Instana]: https://www.instana.com/ \"IBM Instana Observability\"\n[Instana AutoTrace\u2122\ufe0f]: https://www.ibm.com/docs/en/instana-observability/current?topic=kubernetes-instana-autotrace-webhook \"Instana AutoTrace\"\n[configuration page]: https://www.ibm.com/docs/en/instana-observability/current?topic=package-python-configuration-configuring-instana#general \"Instana Python package configuration\"\n[PyPI]: https://pypi.python.org/pypi/instana \"Instana package at PyPI\"\n[installation document]: https://www.ibm.com/docs/en/instana-observability/current?topic=technologies-monitoring-python-instana-python-package#installation-methods \"Instana Python package installation methods\"\n[documentation portal]: https://www.ibm.com/docs/en/instana-observability/current?topic=technologies-monitoring-python-instana-python-package \"Instana Python package documentation\"\n[Node.js]: https://github.com/instana/nodejs \"Instana Node.JS Tracer\"\n[Go]: https://github.com/instana/golang-sensor \"Instana Go Tracer\"\n[Ruby]: https://github.com/instana/ruby-sensor \"Instana Ruby Tracer\"\n[supported technologies]: https://www.instana.com/supported-technologies/ \"Instana supported technologies\"\n",
"bugtrack_url": null,
"license": null,
"summary": "Python Distributed Tracing & Metrics Sensor for Instana.",
"version": "3.8.2",
"project_urls": {
"Documentation": "https://www.ibm.com/docs/en/instana-observability/current?topic=technologies-monitoring-python-instana-python-package",
"Issues": "https://github.com/instana/python-sensor/issues",
"Source": "https://github.com/instana/python-sensor"
},
"split_keywords": [
"distributed-tracing",
" metrics",
" monitoring",
" opentelemetry",
" performance",
" tracing"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "74200d96fed46f45d7e6502021098740db7c170533976a06048b6fbb14fea470",
"md5": "b748e28d23194cdb0099f8450add051f",
"sha256": "b95eb25288943933caad295089e2858ee457b8e3f1960ed9744fcd71182cfe97"
},
"downloads": -1,
"filename": "instana-3.8.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b748e28d23194cdb0099f8450add051f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 174825,
"upload_time": "2025-09-10T14:38:07",
"upload_time_iso_8601": "2025-09-10T14:38:07.764686Z",
"url": "https://files.pythonhosted.org/packages/74/20/0d96fed46f45d7e6502021098740db7c170533976a06048b6fbb14fea470/instana-3.8.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "156e56bea9d1ddb46624f9b47a57026503b620e5fab2cc967877794e7168e716",
"md5": "8f7e7f9d66b2819b186fdc807a4eb809",
"sha256": "72a7000a34756369627f7be1d76385b90d7c63c24d41110effb9b28bcd892ba8"
},
"downloads": -1,
"filename": "instana-3.8.2.tar.gz",
"has_sig": false,
"md5_digest": "8f7e7f9d66b2819b186fdc807a4eb809",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 282570,
"upload_time": "2025-09-10T14:38:09",
"upload_time_iso_8601": "2025-09-10T14:38:09.307055Z",
"url": "https://files.pythonhosted.org/packages/15/6e/56bea9d1ddb46624f9b47a57026503b620e5fab2cc967877794e7168e716/instana-3.8.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-10 14:38:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "instana",
"github_project": "python-sensor",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"circle": true,
"requirements": [],
"lcname": "instana"
}
JSON
