# 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
You can use automatic installation or manual installation as described in the following sections:
### Automatic installation
Instana remotely instruments your Python applications automatically by [Instana AutoTrace webhook] in Kubernetes and Red Hat OpenShift clusters. However, if you prefer to install the package manually, see [Manual Installation](#manual-installation) as follows.
### 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 With Code Changes
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 webhook]: https://www.ibm.com/docs/en/instana-observability/current?topic=kubernetes-instana-autotrace-webhook "Instana AutoTrace webhook"
[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://ibm.biz/monitoring-python "Monitoring Python - IBM 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.9",
"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/d9/f1/066b270d2138159f00bcb168633b4f46a1aa8c326d6f817094a760c1112d/instana-3.9.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\nYou can use automatic installation or manual installation as described in the following sections:\n\n### Automatic installation\n\nInstana remotely instruments your Python applications automatically by [Instana AutoTrace webhook] in Kubernetes and Red Hat OpenShift clusters. However, if you prefer to install the package manually, see [Manual Installation](#manual-installation) as follows.\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 With Code Changes\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 webhook]: https://www.ibm.com/docs/en/instana-observability/current?topic=kubernetes-instana-autotrace-webhook \"Instana AutoTrace webhook\"\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://ibm.biz/monitoring-python \"Monitoring Python - IBM 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.9.0",
"project_urls": {
"Documentation": "https://ibm.biz/monitoring-python",
"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": "d160cf5c5e414ce91075fc64f532c5f42e2a033785677b8a9012c6015b2bc061",
"md5": "6ab7559780b2019cbf7346168b9ab7e1",
"sha256": "14673916b357b94dd1f90ee7d6b71bb9627865a4690f47c472fb1738304bdafc"
},
"downloads": -1,
"filename": "instana-3.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6ab7559780b2019cbf7346168b9ab7e1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 175129,
"upload_time": "2025-10-09T12:17:44",
"upload_time_iso_8601": "2025-10-09T12:17:44.906077Z",
"url": "https://files.pythonhosted.org/packages/d1/60/cf5c5e414ce91075fc64f532c5f42e2a033785677b8a9012c6015b2bc061/instana-3.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d9f1066b270d2138159f00bcb168633b4f46a1aa8c326d6f817094a760c1112d",
"md5": "7016b6164cad40372c9feac009f768fd",
"sha256": "251cafdde785568304a12d237915d1925ed67aa79d69d09c5b5603cf09bd5ea5"
},
"downloads": -1,
"filename": "instana-3.9.0.tar.gz",
"has_sig": false,
"md5_digest": "7016b6164cad40372c9feac009f768fd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 295343,
"upload_time": "2025-10-09T12:17:46",
"upload_time_iso_8601": "2025-10-09T12:17:46.692530Z",
"url": "https://files.pythonhosted.org/packages/d9/f1/066b270d2138159f00bcb168633b4f46a1aa8c326d6f817094a760c1112d/instana-3.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-09 12:17:46",
"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
