ThinkPHP日志可集成Fluentd的四种方式：一、Stdout输出+fluent-bit采集；二、Socket驱动直连Fluentd；三、Nginx日志间接接入；四、Monolog Bridge注入Fluentd Handler。
如果您在ThinkPHP项目中已启用日志记录，但希望将日志统一采集并转发至Fluentd服务端进行集中处理，则需绕过默认的File驱动，改用Stdout或Socket输出方式，并配合Fluentd客户端（如fluent-bit或td-agent）完成日志捕获与转发。以下是多种可行的集成与配置路径：
一、通过Stdout输出 + Fluent-bit本地采集
该方式利用ThinkPHP的Stdout日志驱动，将日志实时输出到标准输出流，再由轻量级fluent-bit作为边车（sidecar）进程监听并转发。适用于容器化部署或单机多应用场景，资源开销低且无需修改TP核心逻辑。
1、修改ThinkPHP配置文件config/log.php，将driver设为stdout：
2、确保realtime_write设为true，避免日志缓冲导致延迟：
立即学习“PHP免费学习笔记（深入）”；
3、安装fluent-bit并配置input为tail或stdin：若日志经PHP-FPM输出至error_log，需先确认其路径（如/var/log/php-fpm/www-error.log），并在fluent-bit.conf中指定Path；若使用CLI模式运行TP命令，则可直接配置input为stdin。
4、配置fluent-bit的output指向Fluentd服务端的forward端口（默认24224）：
5、启动fluent-bit：fluent-bit -c /etc/fluent-bit/fluent-bit.conf
二、通过Socket驱动直连Fluentd forward端口
该方式让ThinkPHP直接向Fluentd服务端建立TCP连接发送JSON格式日志，跳过中间采集代理，降低链路延迟。要求Fluentd服务端已启用forward输入插件并监听对应地址与端口。
1、在ThinkPHP中新增自定义日志驱动类app\common\log\driver\FluentdSocket.php，继承think\log\driver\File并重写save方法，使用fsockopen连接127.0.0.1:24224并发送JSON消息体。
2、构造日志事件结构，必须包含time、level、message及tag字段，例如{"time":1713936420,"level":"error","message":"DB connection failed","tag":"tp.app.error"}。
3、在config/log.php中注册该驱动并设置为默认：
4、Fluentd服务端配置<source>块启用forward输入：
5、重启Fluentd服务：systemctl restart td-agent
三、通过Nginx日志模块间接接入
当ThinkPHP运行于Nginx+PHP-FPM架构时，可直接采集Nginx访问日志与错误日志，无需修改PHP代码。此方式适用于Web请求全链路日志聚合，尤其适合审计与性能分析场景。
1、确保Nginx配置中access_log与error_log路径明确，例如/var/log/nginx/tp-access.log和/var/log/nginx/tp-error.log。
2、在Fluentd客户端（如td-agent）配置tail输入插件，分别监控两个日志文件：
3、为每条日志添加静态tag以区分来源，如tag nginx.access.tp和tag nginx.error.tp。
4、配置filter插件对nginx.access.tp日志执行parse，使用apache2或自定义正则提取status、request_time等字段。
5、所有日志统一匹配<match nginx.**>并转发至目标存储，例如Elasticsearch或HDFS。
四、通过Monolog Bridge注入Fluentd Handler
该方式基于ThinkPHP 6.1+对Monolog的原生支持，将Fluentd作为Monolog的Handler直接嵌入日志生命周期，确保上下文（如trace_id、user_id）完整透传，适合高一致性要求的微服务环境。
1、安装Monolog及Fluentd专用Handler：composer require monolog/monolog fluent/logger
2、创建app\common\log\handler\FluentdHandler.php，继承Monolog\Handler\AbstractProcessingHandler，在write方法中调用FluentLogger::post发送结构化数据。
3、在config/log.php中配置logger.handler为该类实例，并传入Fluentd服务地址与端口参数。
4、确保TP的Channel机制能将$context中的关键字段（如request_id）自动注入Monolog记录，避免手动拼接。
5、验证日志是否携带trace_id字段：grep -o '"trace_id":"[^"]*"' /var/log/td-agent/td-agent.log | head -n 1
