PHP不直接处理Datadog基础设施监控，仅上报应用层指标；基础设施指标由独立运行的Datadog Agent通过系统接口采集，PHP需通过StatsD（UDP 127.0.0.1:8125）或trace端口（8126）主动发送业务指标并与Agent联动。
PHP本身不直接处理Datadog基础设施监控——它只负责应用层指标（如请求耗时、自定义事件），而基础设施（CPU、内存、磁盘、网络、进程）由Datadog Agent在宿主机上采集，与PHP代码无关。想让PHP应用“参与”基础设施监控，关键在于两件事：确保Agent正常上报系统指标，并让PHP主动暴露可被Agent抓取的应用指标。
为什么dd-agent必须装在PHP运行的机器上
Datadog Agent是独立于PHP的守护进程，它通过读取/proc、/sys、ps、df等系统接口获取基础设施数据。PHP脚本即使跑满CPU，也不会自动触发这些采集；没有Agent，Datadog控制台连服务器是否在线都看不到。
- Agent默认监听本地
127.0.0.1:8125（StatsD端口）和127.0.0.1:8126（trace端口），PHP需往这两个地址发数据才能联动 - 若PHP运行在容器中，Agent必须以host网络模式或共享PID/NET命名空间部署，否则无法采集容器内进程和网络指标
- 常见错误：
Connection refused—— 通常是因为Agent没启动、端口被防火墙拦截，或PHP容器没连通宿主机网络
statsd发送PHP业务指标的实操要点
用statsd向Agent上报计数器、直方图、Gauge等，是PHP接入基础设施监控最轻量的方式。不要依赖SDK自动埋点，手动控制更稳。
- 推荐使用原生UDP发送，避免引入HTTP依赖和超时风险：
fsockopen('udp://127.0.0.1', 8125)后fputs()写入php.request.count:1|c - 注意采样率：高QPS场景下加
|@0.1降低传输压力，但会损失精度；调试期设为|@1.0 - 命名规范直接影响Dashboard分组：用英文点号分隔层级，如
php.db.query.time比db_query_time_php更易聚合 - 避免在慢SQL或文件IO路径里同步发StatsD——可能拖慢主流程；异步发或批量缓存后定时刷
PHP-FPM状态页如何被datadog-agent自动采集
Datadog Agent内置php_fpm集成，能自动抓取FPM状态页（status和ping），但前提是PHP-FPM开启了对应功能且Agent配置正确。
- 确认PHP-FPM配置中启用了
pm.status_path = /status和ping.path = /ping，并允许外部访问（如Nginx location透传） - Agent配置文件
/etc/datadog-agent/conf.d/php_fpm.d/conf.yaml中必须指定url，例如http://localhost/status?json（注意加?json参数，否则解析失败） - 常见报错
403 Forbidden：Nginx未放行/status路径；Connection refused：PHP-FPM监听的是socket而非TCP，Agent不支持直接连unix socket - 采集到的指标如
php_fpm.processes.idle、php_fpm.performance.max_children_reached，直接反映PHP资源瓶颈
真正容易被忽略的是时间一致性：Agent采集系统指标用的是宿主机时钟，PHP应用日志打点如果用date_default_timezone_set()设了非UTC时区，会导致Trace里Span时间戳和基础设施图表对不上。所有时间基准统一用UTC，排查问题才不会偏移。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
