softonic/phpfpm_exporter

phpfpm_exporter镜像说明

镜像概述

softonic/phpfpm_exporter是一个Prometheus导出器，用于采集php-fpm服务的状态信息，并将其转换为Prometheus可读取的指标格式。适用于搭配Nginx等Web服务器使用的php-fpm环境，帮助运维人员实时监控php-fpm的运行状态。

核心功能

• 采集php-fpm的连接接受数、监听队列大小、进程状态等关键指标
• 将指标转换为Prometheus标准格式，支持Prometheus采集与分析
• 支持自定义采集间隔、监听地址及状态信息URL

使用场景

• 监控php-fpm服务的连接处理能力
• 跟踪php-fpm监听队列的拥堵情况
• 分析php-fpm进程的活跃/空闲状态分布
• 实时掌握php-fpm最大子进程数的使用情况

配置说明

命令行参数

该导出器支持以下3个核心参数：

1. status.url：php-fpm状态信息的JSON格式URL（必填含?json参数），默认值为http://localhost/status?json
2. listen.address：导出器监听地址，默认值为http://127.0.0.1:9099/
3. scrape.interval：采集间隔（支持Go Duration格式，如1m/30s），默认值为5m

Docker部署示例

bash
docker run --rm softonic/phpfpm_exporter \
  -status.url=http://your-nginx-service/status?json \
  -listen.address 0.0.0.0:9099

Prometheus采集配置

在Prometheus的prometheus.yml中添加以下配置：

yaml
scrape_configs:
  - job_name: 'php-fpm'
    static_configs:
      - targets: ['phpfpm-exporter:9099'] # 替换为导出器的实际地址

导出指标

1. phpfpm_acceptedconnections_count：php-fpm池接受的连接总数（标签：pool）
2. phpfpm_listenqueue_size：监听队列大小（标签：pool、metric（current/max/len））
3. phpfpm_processes_count：进程数量（标签：pool、state（idle/active/max_active））
4. phpfpm_maxchildren_count：池达到的最大子进程数（标签：pool）