# 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/master)
[](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 up to 2.5.3 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#installing "Instana Python package installation"
[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/ed/51/c51013d8cb18aab972bd1ef0a027868dbdd3f95d859e592bd70694e78074/instana-3.0.1.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/master)\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 up to 2.5.3 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#installing \"Instana Python package installation\"\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.0.1",
"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": "",
"digests": {
"blake2b_256": "043e6f688571db002066167146d5499dff7605af2cc8719b986f56941a7051b8",
"md5": "f8dc603808f588f9ac587cfd2d9d58d2",
"sha256": "2226b5a941cf89e67c2e0ac5ca24644257361063890a75997c60c1d3c09a5742"
},
"downloads": -1,
"filename": "instana-3.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f8dc603808f588f9ac587cfd2d9d58d2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 151227,
"upload_time": "2024-10-21T13:56:32",
"upload_time_iso_8601": "2024-10-21T13:56:32.955470Z",
"url": "https://files.pythonhosted.org/packages/04/3e/6f688571db002066167146d5499dff7605af2cc8719b986f56941a7051b8/instana-3.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ed51c51013d8cb18aab972bd1ef0a027868dbdd3f95d859e592bd70694e78074",
"md5": "31ab29eb2a0772ac85c701fe72c6735f",
"sha256": "842b3f9a4190236e3f992c5e8bc4c1fef5e46968e836ad63c533d67ce418a4ad"
},
"downloads": -1,
"filename": "instana-3.0.1.tar.gz",
"has_sig": false,
"md5_digest": "31ab29eb2a0772ac85c701fe72c6735f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 246854,
"upload_time": "2024-10-21T13:56:34",
"upload_time_iso_8601": "2024-10-21T13:56:34.418158Z",
"url": "https://files.pythonhosted.org/packages/ed/51/c51013d8cb18aab972bd1ef0a027868dbdd3f95d859e592bd70694e78074/instana-3.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-21 13:56:34",
"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
