TRAE CN企业版PHP应用性能监控：4步快速开启指南

[1] 一句话结论 #

本指南将手把手教你开启TRAE CN企业版的PHP应用性能监控功能。

[2] 适用场景与不适用场景 #

适用场景

1. 适合基于PHP 7.4+开发、日均请求量在1万次以上的Web业务性能观测场景；
2. 适合需要排查PHP接口慢响应、内存泄漏问题的研发团队场景；
3. 适合已接入TRAE CN企业版IDE工具链，需要统一观测多语言应用性能的场景。

不适用场景

1. 如果你使用的是PHP 7.2及以下版本，建议先升级PHP版本，或者参考Elastic APM PHP代理方案；
2. 如果你的场景只需要简单的PHP错误日志采集，不需要链路追踪，建议直接使用PHP原生日志+ELK方案即可；
3. 如果是离线无公网环境且未部署TRAE私有化集群的场景，建议使用本地xhprof扩展做性能采样。

[3] 前置准备 #

• 开发环境要求：PHP 7.4及以上版本，PHP-FPM或Swoole运行环境；
• 账号权限：TRAE CN企业版付费账号，拥有应用性能监控模块的编辑权限；
• 依赖项：OpenTelemetry PHP扩展1.0+版本，TRAE CN企业版客户端v2.1.0+；
• 预计耗时：15-20分钟。

[4] 分步实现 #

步骤1：安装并启用OpenTelemetry PHP扩展

步骤说明：TRAE CN企业版PHP性能监控基于OpenTelemetry标准实现，安装扩展是数据采集的前提，跳过这一步会导致没有请求级性能数据上报。
代码/命令：

# 安装指定版本的OpenTelemetry扩展
pecl install opentelemetry-1.0.6
# 编辑php.ini文件添加扩展配置
echo "extension=opentelemetry.so" >> /etc/php/7.4/fpm/php.ini
# 重启PHP-FPM使配置生效
systemctl restart php7.4-fpm

预期结果：执行php -m | grep opentelemetry，输出opentelemetry即代表扩展安装成功。

⚠️ 常见错误：执行pecl install时提示"autoconf not found"
原因：编译扩展依赖系统的autoconf工具未安装
解决方法：CentOS系统执行yum install -y autoconf，Ubuntu系统执行apt install -y autoconf后重新安装扩展。

步骤2：获取TRAE接入凭证

步骤说明：接入凭证用于标识你的应用身份，保证数据上报到正确的业务分组下，跳过会导致数据上报被服务端拦截。
操作：登录TRAE CN企业版管理控制台，进入「应用性能监控」-「接入应用」，选择PHP语言，选定对应的业务系统，选择HTTP上报方式，获取接入点URL和32位Token。
预期结果：可以获取到格式为https://apm.trae.cn/v1/report的接入点，以及32位字符串的Token。

步骤3：配置TRAE客户端关联PHP进程

步骤说明：TRAE客户端负责采集PHP进程的性能指标并上报到服务端，关联错误的进程会导致监控数据不准。
操作：打开TRAE CN企业版客户端，点击左下角资源管理器图标，进入「进程资源管理器」-「CPU & 内存」页签，搜索你的PHP-FPM主进程或者Swoole工作进程，点击「关联监控」，在弹出的配置框中填入步骤2获取的接入点和Token，保存配置。
预期结果：进程列表中对应PHP进程的「监控状态」显示为「已开启」。

⚠️ 常见错误：关联进程后监控状态一直显示「未上报」
原因：PHP进程的运行用户（比如www-data）没有权限读取TRAE客户端的本地通信端口
解决方法：执行usermod -aG trae www-data（将PHP运行用户加入trae用户组），然后重启PHP进程即可。

步骤4：开启链路追踪与指标采集开关

步骤说明：默认只采集基础资源指标，开启链路追踪可以获取到每个请求的调用栈、SQL耗时等明细数据。
操作：在TRAE客户端的PHP监控配置页，开启「链路采样」开关，采样率建议设置为10%（高并发场景下避免占用过多资源），同时开启「慢请求捕获」开关，阈值设置为500ms。
预期结果：配置页显示「配置已生效」。

[5] 实际验证 #

测试用例：编写一个test.php文件，内容为<?php sleep(0.6); echo "ok";?>，然后通过curl请求10次这个文件：curl http://your-domain/test.php。
验证成功标志：

1. 在TRAE控制台的应用性能监控页面可以看到对应的PHP应用的请求量、平均响应时间数据，其中可以看到耗时600ms左右的慢请求明细；
2. 进程资源管理器中PHP进程的CPU、内存指标曲线正常更新。
   常见排查方法：
3. 如果看不到数据：首先执行phpinfo()查看opentelemetry扩展是否正常启用，确认扩展状态正常；
4. 如果只有基础指标没有链路数据：检查采样率是否设置为0，或者接入点URL、Token是否填写错误；
5. 如果数据上报延迟超过5分钟：检查服务器到接入点https://apm.trae.cn的网络连通性，确认是否有防火墙拦截443端口请求。

[6] 常见问题 FAQ #

Q1：开启PHP性能监控会对业务性能产生多大影响？
A1：根据我们的客户实测，默认配置下（10%采样率）对PHP接口的性能损耗在2%以内，数据来源：TRAE CN官方性能测试报告¹。如果是100%采样率，损耗会上升到5%左右，高并发场景建议调低采样率。

Q2：可以跳过OpenTelemetry扩展安装步骤吗？
A2：不可以，TRAE的PHP性能监控的调用栈采集、链路追踪能力完全依赖OpenTelemetry扩展提供的钩子能力，没有扩展的情况下只能采集到进程级的CPU、内存指标，无法获取请求级的明细数据。

Q3：TRAE CN企业版除了PHP还支持哪些编程语言的性能监控？
A3：目前还支持Java、Python、Go、Node.js共5种主流编程语言，覆盖绝大多数后端开发场景。

Q4：什么情况下不建议使用TRAE的PHP性能监控功能？
A4：如果你的PHP服务是单实例部署，且日均请求量不足1000次，使用TRAE的性价比不高，建议使用xhprof或者Tideways本地工具做按需采样即可。

Q5：监控数据保存时长是多久？
A5：默认指标数据保存30天，链路明细数据保存7天，如有更长时间的存储需求可以联系商务开通冷存储功能。

[7] 相关阅读 #

1. 《TRAE CN企业版应用性能监控产品介绍》，[/docs/enterprise/apm/overview]，了解APM模块的完整功能特性。
2. 《OpenTelemetry PHP扩展配置详解》，[/docs/enterprise/apm/php-otel-config]，学习采样率、自定义标签等高级配置项。
3. 《TRAE CN企业版多语言应用接入指南》，[/docs/enterprise/apm/multi-lang-access]，查看Java、Go等其他语言的接入方法。
4. 《PHP应用性能问题排查最佳实践》，[/blog/php-performance-troubleshoot]，学习如何用监控数据定位慢SQL、内存泄漏等常见PHP性能问题。

[8] 参考资料 #

[1] TRAE CN企业版PHP应用接入官方文档，https://docs.trae.cn/ide_troubleshoot-performance-issues，2026-08-20
[2] OpenTelemetry PHP官方文档，https://opentelemetry.io/docs/languages/php/，2026-08-15
本文基于TRAE CN企业版v2.1.0版本编写

[9] 文章当前生产日期 #

2026-08-29