[English](Readme.md) | [中文](Readme-CN.md) | [한국어](Readme-KR.md)

[](https://github.com/pinpoint-apm/pinpoint-c-agent/actions/workflows/main.yml) [](https://gitter.im/naver/pinpoint-c-agent?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) [](https://codecov.io/gh/pinpoint-apm/pinpoint-c-agent) [](LICENSE) \
`pinpoint_php_ext:` [](https://pecl.php.net/package/pinpoint_php)\
`pinpoint-php-aop:` 
[](https://packagist.org/packages/pinpoint-apm/pinpoint-php-aop)\
`pinpointpy:` 
[](https://pypi.org/project/pinpointpy/)
\
`github-assert`: 
**Visit [our official website](http://pinpoint-apm.github.io/pinpoint/) for more information and [the Latest updates on Pinpoint](https://pinpoint-apm.github.io/pinpoint/news.html)**
> [v0.7](https://github.com/pinpoint-apm/pinpoint-c-agent/tree/v0.7) async api version
# Pinpoint `C` Agent
> ⚠️ **SECURITY NOTICE**: collector-agent **v0.7.8 (and earlier)** contains a
> remote denial-of-service vulnerability — an unauthenticated attacker can crash
> the collector-agent with a single TCP packet, affecting all traced
> applications. **Please upgrade the collector-agent to [v0.7.9](https://github.com/pinpoint-apm/pinpoint-c-agent/releases/tag/v0.7.9) as soon as possible.**
> What's `C`
1. Use `C/Cpp` common API
2. `C`ross-platform: windows/*nux/macOS
3. [`C`ollector-agent](DOC/collector-agent/Readme.md): a bridge to pinpoint-collector
Pinpoint C Agent helps your monitor your PHP/PYTHON applications into [pinpoint-apm](https://github.com/pinpoint-apm/pinpoint).\
Our advantage:
1. Continuous maintenance and optimization. (Since Jul 31,2018)
2. Auto-injection, that means less aggression against your code.
- python: leverage [PEP 318 Decorator](https://peps.python.org/pep-0318/)
- php: leverage `CG(*_table)` in php kernel and AST parser([nikic/PHP-Parser](https://github.com/nikic/PHP-Parser))
3. Cross-platform: windows/*nux/macOS. It helps address the problems even when you are developing.
## Python Agent
> py 3.8+
`pip install pinpointPy`
[Full guide for python](DOC/PY/Readme.md)
## PHP Agent
> php 7.1+
For PHP 7.1–8.2, support is limited to security fixes and critical bug fixes.
New features are not supported on these PHP versions.
1. Install extension
` pecl install pinpoint_php `
2. Import pinpoint aspect plugin
`composer require pinpoint-apm/pinpoint-php-aop`
[Full guide for PHP](DOC/PHP/Readme.md) · [Package validation and PIE release checklist](DOC/PHP/packaging.md)
## C/CPP built in API
[Full guide for C](DOC/C-CPP/Readme.md)
## Our agent playground
`cd testapps && docker compose build --build-arg PHP_VERSION=7.4 && docker compose up`
[Tested project](/testapps/readme.md)
### Blogs
- [Intro pinpoint php aop](https://github.com/pinpoint-apm/pinpoint-php-aop/wiki/Intro-pinpoint-php-aop)
- [pinpoint php on phpmyadmin](https://github.com/pinpoint-apm/pinpoint-c-agent/wiki/pinpoint-in-phpmyadmin)
## Contact Us
* Submit an [issue](https://github.com/pinpoint-apm/pinpoint-c-agent/issues) 👍👍
* [Email Us](mailto:dl_cd_pinpoint@navercorp.com) 👍👍
* [Gitter char room](https://gitter.im/naver/pinpoint-c-agent)
* QQ us (QQ Group: 882020485)
<details>
<summary> show more
</summary>
| QQ Group1: 897594820 | QQ Group2: 812507584 | QQ Group3: 882020485 | DING Group : 21981598 |
| :------------------------------------: | :-------------------------------------: | :-------------------------------------: | :------------------------------------------------: |
|  |  |  |  |
</details>
## Contributing
Thanks all [](https://github.com/pinpoint-apm/pinpoint-c-agent/graphs/contributors)
We are looking forward to your contributions via pull requests.
## License
This project is licensed under the Apache License, Version 2.0.
See [LICENSE](LICENSE) for full license text.
```
Copyright 2024 NAVER Corp.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```