# 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": "sparticleinc-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/02/52/d7641949877a18ba99615a832c48a159601f495a42f704547ce46c6bd7ce/sparticleinc_skywalking-1.0.4.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.4",
"project_urls": {
"Bug Tracker": "https://github.com/apache/skywalking/issues",
"Documentation": "https://github.com/sparticleinc/skywalking-python/next/readme/",
"Homepage": "https://skywalking.apache.org/",
"Repository": "https://github.com/sparticleinc/skywalking-python"
},
"split_keywords": [
"skywalking",
"tracing",
"metrics",
"logging",
"profiling",
"observability",
"distributed-tracing",
"apm",
"python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d73cd7d2275e37e75a20b7585a3d3dc7b6cab6b6174127779c9bd9a39ec1c2b2",
"md5": "9f480e47ae2d46b7298893c84b550e3b",
"sha256": "c39f4f2ac4ab28e30bf5c1618f754dafac5ade4ecc5e19eee5285f58a97c41f9"
},
"downloads": -1,
"filename": "sparticleinc_skywalking-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9f480e47ae2d46b7298893c84b550e3b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<3.12",
"size": 225055,
"upload_time": "2023-09-22T09:24:52",
"upload_time_iso_8601": "2023-09-22T09:24:52.282871Z",
"url": "https://files.pythonhosted.org/packages/d7/3c/d7d2275e37e75a20b7585a3d3dc7b6cab6b6174127779c9bd9a39ec1c2b2/sparticleinc_skywalking-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0252d7641949877a18ba99615a832c48a159601f495a42f704547ce46c6bd7ce",
"md5": "8fde489d234ac726663947639a8e3c63",
"sha256": "5db58e7f204b028477cc939402312f324f11894d6b2e94e51a9ce4c4f5581e08"
},
"downloads": -1,
"filename": "sparticleinc_skywalking-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "8fde489d234ac726663947639a8e3c63",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<3.12",
"size": 125045,
"upload_time": "2023-09-22T09:24:54",
"upload_time_iso_8601": "2023-09-22T09:24:54.108609Z",
"url": "https://files.pythonhosted.org/packages/02/52/d7641949877a18ba99615a832c48a159601f495a42f704547ce46c6bd7ce/sparticleinc_skywalking-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-22 09:24:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "apache",
"github_project": "skywalking",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sparticleinc-skywalking"
}