# 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/a0/28/c096158d10a1f958d1118af3d59dc844ea194d9dc98d9dbe3d187d0b5e5a/instana-3.6.0.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.6.0",
"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": "236e558018f3e5e4a0b9ab12d94342ab74102a2a64ce124a5a2dca741a4e10e7",
"md5": "8dc0480b3223e69b085f392af02017e9",
"sha256": "d3611bee444665d4e41ec0bdaf6716ac17cbef9fbe02cae716c048d3d81c7369"
},
"downloads": -1,
"filename": "instana-3.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8dc0480b3223e69b085f392af02017e9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 171294,
"upload_time": "2025-07-18T09:42:59",
"upload_time_iso_8601": "2025-07-18T09:42:59.929744Z",
"url": "https://files.pythonhosted.org/packages/23/6e/558018f3e5e4a0b9ab12d94342ab74102a2a64ce124a5a2dca741a4e10e7/instana-3.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a028c096158d10a1f958d1118af3d59dc844ea194d9dc98d9dbe3d187d0b5e5a",
"md5": "bee69079506e64061bf7d4de60bf2509",
"sha256": "3cb19f7a46314eaf900d7178aadcca680dfe58fc1cf5ef3586b4841119325d6a"
},
"downloads": -1,
"filename": "instana-3.6.0.tar.gz",
"has_sig": false,
"md5_digest": "bee69079506e64061bf7d4de60bf2509",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 275668,
"upload_time": "2025-07-18T09:43:01",
"upload_time_iso_8601": "2025-07-18T09:43:01.483934Z",
"url": "https://files.pythonhosted.org/packages/a0/28/c096158d10a1f958d1118af3d59dc844ea194d9dc98d9dbe3d187d0b5e5a/instana-3.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-18 09:43:01",
"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
