barwell/phpfpm_exporter

phpfpm_exporter

该镜像用于将PHP-FPM的运行指标导出至Prometheus监控系统，支持实时采集和展示PHP-FPM的关键性能数据，助力用户掌握服务运行状态。

核心功能

• 采集PHP-FPM状态页面数据，生成Prometheus兼容的指标
• 支持配置PHP-FPM主机、端口、状态路径及指标暴露端口
• 当无法连接PHP-FPM时，自动标记phpfpm_up为0并重置相关指标
• 记录状态页面数据到日志文件，便于故障排查

使用场景

• PHP应用服务器的性能监控与优化
• CI/CD环境中PHP-FPM状态的持续跟踪
• 生产环境下PHP-FPM资源利用率分析

配置说明

通过环境变量配置镜像参数：

• PHPFPM_HOST：必填，PHP-FPM主机地址
• PHPFPM_PORT：可选，状态页面端口，默认80
• PHPFPM_PATH：可选，状态页面路径，默认"/status"
• METRICS_PORT：可选，指标暴露端口，默认9253

镜像每5秒轮询一次PHP-FPM状态页面，并在/metrics路径暴露指标。

部署示例

Docker Run命令

bash
docker run -e PHPFPM_HOST=mywebserver barwell/phpfpm_exporter -d

PHP-FPM配置

启用状态页面：

ini
pm.status_path = /status

Nginx安全配置

建议为状态页面设置独立端口：

nginx
http {
    server {
        listen 80;
        server_name www.example.com;
        
        location ~ ^/status$ { deny all; }
        
        location / { try_files $uri @php; }
        
        location @php {
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_index index.php;
            fastcgi_param SCRIPT_FILENAME $document_root/index.php;
            include fastcgi_params;
        }
    }
    
    server {
        listen 9001;
        server_name fpmstatus;
        
        access_log off; error_log off;
        
        location ~ ^/status$ {
            include fastcgi_params;
            fastcgi_param SCRIPT_FILENAME /status;
            fastcgi_pass 127.0.0.1:9000;
        }
    }
}

故障排查

• 指标异常时，检查/var/log/phpfpm/current日志，确认状态页面输出是否正确
• 日志示例：

pool: www process manager: dynamic start time: 26/May/2017:07:11:29 +0000 start since:10 accepted conn:2 listen queue:0 max listen queue:0 listen queue len:0 idle processes:1 active processes:1 total processes:2 max active processes:1 max children reached:0 slow requests:0

测试

test目录下的run脚本通过docker-compose启动PHP-FPM和exporter，指标可通过localhost:9253/metrics查询。

许可证

本项目基于MIT许可证开源，详见仓库许可协议。

依赖

• alpine
• https://github.com/google/mtail
• https://github.com/just-containers/s6-overlay