# 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)
* For Chinese speaker, send `[CN] Request to join SkyWalking slack` mail to the mail list(`dev@skywalking.apache.org`), we will invite you in.
* [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.12,>=3.7",
"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/35/1b/6bb577f0825e23eff43210f1797d5b6becbf02827aaf1c1ba1cf45f2fa4d/apache_skywalking-1.1.0.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* For Chinese speaker, send `[CN] Request to join SkyWalking slack` mail to the mail list(`dev@skywalking.apache.org`), we will invite you in.\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.1.0",
"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": "0baf239e34913fd5f1a610b10a3983c9849dcea21c152c1ccb690a8d4512e7a5",
"md5": "298ebfd93cabd5a1b476549963de8534",
"sha256": "a73ee28a7b7217f99f1d6b9c2ee015137cb691a58ac058dd89351dad30888b44"
},
"downloads": -1,
"filename": "apache_skywalking-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "298ebfd93cabd5a1b476549963de8534",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.7",
"size": 249532,
"upload_time": "2024-07-22T02:46:17",
"upload_time_iso_8601": "2024-07-22T02:46:17.046711Z",
"url": "https://files.pythonhosted.org/packages/0b/af/239e34913fd5f1a610b10a3983c9849dcea21c152c1ccb690a8d4512e7a5/apache_skywalking-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "351b6bb577f0825e23eff43210f1797d5b6becbf02827aaf1c1ba1cf45f2fa4d",
"md5": "00bf2d7fa8632fbe687ddfe0634082bc",
"sha256": "4e5cd728d314183a5da8bd804b936f0c1f5b8a937c4aadc104d11faa481f497f"
},
"downloads": -1,
"filename": "apache_skywalking-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "00bf2d7fa8632fbe687ddfe0634082bc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.7",
"size": 110572,
"upload_time": "2024-07-22T02:46:19",
"upload_time_iso_8601": "2024-07-22T02:46:19.692384Z",
"url": "https://files.pythonhosted.org/packages/35/1b/6bb577f0825e23eff43210f1797d5b6becbf02827aaf1c1ba1cf45f2fa4d/apache_skywalking-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-22 02:46:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "apache",
"github_project": "skywalking",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "apache-skywalking"
}