# SkyWalking Python Agent
<img src="http://skywalking.apache.org/assets/logo.svg" alt="Sky Walking logo" height="90px" align="right" />
**SkyWalking-Python**: The Python Agent for Apache SkyWalking provides the native tracing/metrics/logging/profiling abilities for Python projects.
**[SkyWalking](https://github.com/apache/skywalking)**: Application performance monitor tool for distributed systems, especially designed for microservices, cloud native and container-based (Kubernetes) architectures.
[![GitHub stars](https://img.shields.io/github/stars/apache/skywalking-python.svg?style=for-the-badge&label=Stars&logo=github)](https://github.com/apache/skywalking-python)
[![Twitter Follow](https://img.shields.io/twitter/follow/asfskywalking.svg?style=for-the-badge&label=Follow&logo=twitter)](https://twitter.com/AsfSkyWalking)
![Release](https://img.shields.io/pypi/v/apache-skywalking)
![Version](https://img.shields.io/pypi/pyversions/apache-skywalking)
![Build](https://github.com/apache/skywalking-python/actions/workflows/CI.yaml/badge.svg?event=push)
## Documentation
- [Official documentation](https://skywalking.apache.org/docs/#PythonAgent)
- [Blog](https://skywalking.apache.org/blog/2021-09-12-skywalking-python-profiling/) about the Python Agent Profiling Feature
## Capabilities
| Reporter | Supported? | Details |
|:----------|:----------------|:-----------------------------------------------------------|
| Trace | ✅ (default: ON) | Automatic instrumentation + Manual SDK |
| Log | ✅ (default: ON) | Direct reporter only. (Tracing context in log planned) |
| Meter | ✅ (default: ON) | Meter API + Automatic PVM metrics |
| Event | ❌ (Planned) | Report lifecycle events of your awesome Python application |
| Profiling | ✅ (default: ON) | Threading and Greenlet Profiler |
## Installation Requirements
SkyWalking Python Agent requires [Apache SkyWalking 8.0+](https://skywalking.apache.org/downloads/#SkyWalkingAPM) and Python 3.7+.
> If you would like to try out the latest features that are not released yet, please refer to this [guide](docs/en/setup/faq/How-to-build-from-sources.md) to build from sources.
## Live Demo
- Find the [live demo](https://skywalking.apache.org/#demo) with Python agent on our website.
- Follow the [showcase](https://skywalking.apache.org/docs/skywalking-showcase/next/readme/) to set up preview deployment quickly.
## Contributing
Before submitting a pull request or pushing a commit, please read our [contributing](CONTRIBUTING.md) and [developer guide](docs/en/contribution/Developer.md).
## Contact Us
* Mail list: **dev@skywalking.apache.org**. Mail to `dev-subscribe@skywalking.apache.org`, follow the reply to subscribe the mail list.
* Send `Request to join SkyWalking slack` mail to the mail list(`dev@skywalking.apache.org`), we will invite you in.
* Twitter, [ASFSkyWalking](https://twitter.com/AsfSkyWalking)
* QQ Group: 901167865, 392443393
* [bilibili B站 视频](https://space.bilibili.com/390683219)
## License
Apache 2.0
Raw data
{
"_id": null,
"home_page": "https://skywalking.apache.org/",
"name": "apache-skywalking",
"maintainer": "Apache SkyWalking Community",
"docs_url": null,
"requires_python": ">=3.7,<3.12",
"maintainer_email": "dev@skywalking.apache.org",
"keywords": "skywalking,tracing,metrics,logging,profiling,observability,distributed-tracing,apm,python",
"author": "Apache Software Foundation",
"author_email": "dev@skywalking.apache.org",
"download_url": "https://files.pythonhosted.org/packages/3b/52/5511f2f813b4b511c8b617f30bd1c667c7b3774ce9b73bdaede444276144/apache_skywalking-1.0.1.tar.gz",
"platform": null,
"description": "# SkyWalking Python Agent\n\n<img src=\"http://skywalking.apache.org/assets/logo.svg\" alt=\"Sky Walking logo\" height=\"90px\" align=\"right\" />\n\n**SkyWalking-Python**: The Python Agent for Apache SkyWalking provides the native tracing/metrics/logging/profiling abilities for Python projects.\n\n**[SkyWalking](https://github.com/apache/skywalking)**: Application performance monitor tool for distributed systems, especially designed for microservices, cloud native and container-based (Kubernetes) architectures.\n\n\n[![GitHub stars](https://img.shields.io/github/stars/apache/skywalking-python.svg?style=for-the-badge&label=Stars&logo=github)](https://github.com/apache/skywalking-python)\n[![Twitter Follow](https://img.shields.io/twitter/follow/asfskywalking.svg?style=for-the-badge&label=Follow&logo=twitter)](https://twitter.com/AsfSkyWalking)\n\n![Release](https://img.shields.io/pypi/v/apache-skywalking)\n![Version](https://img.shields.io/pypi/pyversions/apache-skywalking)\n![Build](https://github.com/apache/skywalking-python/actions/workflows/CI.yaml/badge.svg?event=push)\n\n## Documentation\n\n- [Official documentation](https://skywalking.apache.org/docs/#PythonAgent)\n- [Blog](https://skywalking.apache.org/blog/2021-09-12-skywalking-python-profiling/) about the Python Agent Profiling Feature\n\n## Capabilities\n\n| Reporter | Supported? | Details | \n|:----------|:----------------|:-----------------------------------------------------------|\n| Trace | \u2705 (default: ON) | Automatic instrumentation + Manual SDK | \n| Log | \u2705 (default: ON) | Direct reporter only. (Tracing context in log planned) |\n| Meter | \u2705 (default: ON) | Meter API + Automatic PVM metrics |\n| Event | \u274c (Planned) | Report lifecycle events of your awesome Python application |\n| Profiling | \u2705 (default: ON) | Threading and Greenlet Profiler |\n\n## Installation Requirements\n\nSkyWalking Python Agent requires [Apache SkyWalking 8.0+](https://skywalking.apache.org/downloads/#SkyWalkingAPM) and Python 3.7+.\n\n> If you would like to try out the latest features that are not released yet, please refer to this [guide](docs/en/setup/faq/How-to-build-from-sources.md) to build from sources.\n\n## Live Demo\n- Find the [live demo](https://skywalking.apache.org/#demo) with Python agent on our website.\n- Follow the [showcase](https://skywalking.apache.org/docs/skywalking-showcase/next/readme/) to set up preview deployment quickly.\n\n## Contributing\n\nBefore submitting a pull request or pushing a commit, please read our [contributing](CONTRIBUTING.md) and [developer guide](docs/en/contribution/Developer.md).\n\n## Contact Us\n* Mail list: **dev@skywalking.apache.org**. Mail to `dev-subscribe@skywalking.apache.org`, follow the reply to subscribe the mail list.\n* Send `Request to join SkyWalking slack` mail to the mail list(`dev@skywalking.apache.org`), we will invite you in.\n* Twitter, [ASFSkyWalking](https://twitter.com/AsfSkyWalking)\n* QQ Group: 901167865, 392443393\n* [bilibili B\u7ad9 \u89c6\u9891](https://space.bilibili.com/390683219)\n\n## License\nApache 2.0\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "The Python Agent for Apache SkyWalking, which provides the native tracing/metrics/logging/profiling abilities for Python projects.",
"version": "1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/apache/skywalking/issues",
"Documentation": "https://skywalking.apache.org/docs/skywalking-python/next/readme/",
"Homepage": "https://skywalking.apache.org/",
"Repository": "https://github.com/apache/skywalking-python"
},
"split_keywords": [
"skywalking",
"tracing",
"metrics",
"logging",
"profiling",
"observability",
"distributed-tracing",
"apm",
"python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "60d1a0d7365015866efbbe12c60d611312e65894590b0219295c0dc1f1b83b3c",
"md5": "e9a607b90a509b77202c64c832a77e34",
"sha256": "c6f1cbd2ecd2f1effe517323aa0ba78f1eafe49e3eeaf81b63d6eca6e479934a"
},
"downloads": -1,
"filename": "apache_skywalking-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e9a607b90a509b77202c64c832a77e34",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<3.12",
"size": 223277,
"upload_time": "2023-04-29T19:51:53",
"upload_time_iso_8601": "2023-04-29T19:51:53.016140Z",
"url": "https://files.pythonhosted.org/packages/60/d1/a0d7365015866efbbe12c60d611312e65894590b0219295c0dc1f1b83b3c/apache_skywalking-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3b525511f2f813b4b511c8b617f30bd1c667c7b3774ce9b73bdaede444276144",
"md5": "c109b64da6bd0b6f15166710518e3c34",
"sha256": "18fbe07f6e12daa6b502385de1586fafe8b9c1dbef240bb1896bb8a4a8c277a7"
},
"downloads": -1,
"filename": "apache_skywalking-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "c109b64da6bd0b6f15166710518e3c34",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<3.12",
"size": 99461,
"upload_time": "2023-04-29T19:51:55",
"upload_time_iso_8601": "2023-04-29T19:51:55.869570Z",
"url": "https://files.pythonhosted.org/packages/3b/52/5511f2f813b4b511c8b617f30bd1c667c7b3774ce9b73bdaede444276144/apache_skywalking-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-29 19:51:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "apache",
"github_project": "skywalking-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "apache-skywalking"
}