softonic/php-fpm-exporter

php-fpm-exporter镜像说明

镜像概述

该镜像用于将PHP-FPM的运行状态指标转换为Prometheus可识别的格式，便于集成到Prometheus监控体系，实现对PHP-FPM服务的实时性能跟踪与故障排查。

核心功能

1. 导出PHP-FPM关键指标（活跃进程数、空闲进程数、请求处理时间等）；
2. 支持HTTP和FastCGI两种方式获取PHP-FPM状态；
3. 提供/healthz健康检查接口，适配容器编排系统；
4. 可灵活配置监听地址及状态端点参数。

使用场景

• LNMP/LAMP架构下的PHP服务监控；
• 集成Prometheus+Grafana构建PHP-FPM性能监控面板；
• 对PHP应用的请求处理效率进行实时分析。

配置说明

前提条件

需开启PHP-FPM状态页面：

1. 修改PHP-FPM配置（如www.conf），添加pm.status_path = /status；
2. HTTP方式需在Nginx等Web服务器配置/status反向代理至PHP-FPM。

镜像参数

• --addr：指标监听地址（默认：127.0.0.1:8080）；
• --endpoint：HTTP状态端点（默认：[***]
• --fastcgi：FastCGI地址（如tcp://127.0.0.1:9000/status或unix:///var/run/php-fpm.sock/status）。

Docker部署示例

1. HTTP方式

bash
docker run -d --name php-fpm-exporter \
  -p 8080:8080 \
  softonic/php-fpm-exporter \
  --endpoint http://your-php-fpm-host:9000/status

2. FastCGI（Unix Socket）

bash
docker run -d --name php-fpm-exporter \
  -p 8080:8080 \
  -v /var/run/php-fpm.sock:/var/run/php-fpm.sock \
  softonic/php-fpm-exporter \
  --fastcgi unix:///var/run/php-fpm.sock/status

3. Docker Compose

yaml
version: '3'
services:
  php-fpm-exporter:
    image: softonic/php-fpm-exporter
    ports: ["8080:8080"]
    command: --endpoint http://php-fpm:9000/status
    depends_on: [php-fpm]
  php-fpm:
    image: php:fpm
    volumes: [./php-fpm.conf:/usr/local/etc/php-fpm.d/www.conf]

指标访问

通过http://<exporter-ip>:8080/metrics获取Prometheus格式指标数据。

许可证

基于开源项目构建，许可证详见原项目https://github.com/bakins/php-fpm-exporter/blob/master/LICENSE%E3%80%82 ===END===