ThinkPHP性能监控需接入AppDynamics：一、用PHP Agent自动注入监控；二、通过中间件手动标记业务事务；三、以JSON日志对接Machine Agent；四、Swoole协程下手动埋点透传Trace ID。
如果您在ThinkPHP应用中需要实现性能监控，但缺乏端到端的调用链追踪与业务事务可视化，则可能是由于未将应用运行时指标接入专业APM平台。以下是将ThinkPHP与AppDynamics集成的多种可行方法：
一、通过PHP Agent启用自动字节码注入监控
AppDynamics官方提供PHP Agent，支持在Web服务器（如Apache或Nginx）中以模块方式加载，自动捕获HTTP请求、数据库调用、外部服务调用等关键事务。该方式无需修改ThinkPHP源码，适合生产环境快速启用。
1、下载适配当前PHP版本（7.4+或8.x）及操作系统架构的AppDynamics PHP Agent压缩包，解压至指定路径，例如/opt/appdynamics/php-agent。
2、编辑PHP配置文件php.ini，添加以下三行配置：
立即学习“PHP免费学习笔记（深入）”；
extension=appdynamics.so
appdynamics.agent.application_name=YourThinkPHPAppName
appdynamics.agent.tier_name=web-tier
3、设置环境变量APPDYNAMICS_CONTROLLER_HOST_NAME、APPDYNAMICS_CONTROLLER_PORT、APPDYNAMICS_AGENT_ACCOUNT_NAME和APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY，确保Agent能连接至AppDynamics Controller。
4、重启Web服务器（如sudo systemctl restart apache2或sudo nginx -s reload），访问任意ThinkPHP路由，检查AppDynamics仪表板是否出现新应用节点。
二、使用ThinkPHP中间件注入自定义业务事务
当PHP Agent无法识别ThinkPHP特有的路由调度逻辑（如Route::dispatch()或App::run()）时，可通过中间件手动创建Business Transaction，显式标记入口点并包裹核心执行流程，从而补全事务上下文。
1、在app/middleware/目录下新建AppDynamicsMiddleware.php，引入AppDynamics PHP SDK（需提前通过Composer安装appdynamics/php-sdk）。
2、在handle()方法中调用AppDynamics\Transaction::start('HTTP-Request')，传入当前请求URI与HTTP方法作为事务名称。
3、执行$next($request)后，调用AppDynamics\Transaction::end()完成事务闭合。
4、在app/middleware.php中注册该中间件为全局中间件，确保所有HTTP请求均被包裹。
5、验证时，在AppDynamics Business Transactions列表中查找以HTTP-Request-开头的事务，并确认其响应时间与ThinkPHP实际处理耗时一致。
三、通过日志管道对接AppDynamics Machine Agent
若受限于生产环境权限，无法部署PHP Agent或修改php.ini，可利用ThinkPHP内置的日志系统（如Log::write()）输出结构化JSON日志，再由AppDynamics Machine Agent的Log Monitoring模块实时采集解析，映射为Custom Metrics与Events。
1、在config/log.php中配置日志驱动为single，并将format设为JSON模板，包含字段：timestamp、level、action（如route或db_query）、duration_ms、uri、status_code。
2、在核心控制器基类（如app/controller/Base.php）的initialize()与__destruct()中记录事务起止毫秒时间戳，并计算duration_ms写入日志。
3、在AppDynamics Controller中配置Log Monitoring，指定日志文件路径（如/var/log/thinkphp/app.log），并上传自定义解析规则JSON，将duration_ms映射为Custom Metric thinkphp.request.duration。
4、配置Health Rule，当thinkphp.request.duration的P95值连续5分钟超过800ms时触发告警。
四、基于Swoole协程服务的手动Instrumentation
针对采用Swoole作为底层Server（如think-swoole扩展）的ThinkPHP应用，PHP Agent默认不支持协程上下文透传，需通过SDK手动注入Span ID与Trace ID，确保跨协程调用链不中断。
1、在Swoole启动回调（如Swoole\Http\Server::on('start')）中初始化AppDynamics Tracer，调用AppDynamics\Tracer::init()并设置全局采样率。
2、在每个HTTP请求回调（on('request')）中，从$request->header提取appd-trace-id与appd-node-id，调用AppDynamics\Tracer::startSpan()重建上下文。
3、在响应发送前（$response->end()），调用AppDynamics\Tracer::endSpan()提交Span数据至本地Collector。
4、确保Swoole Worker进程复用时，每次请求均重置Tracer状态，避免Span ID污染。
