flant/php-fpm-exporter

flant/php-fpm-exporter 镜像说明

镜像概述

本镜像提供了php-fpm-exporter工具，用于从PHP-FPM实例中采集运行状态指标（如活跃进程数、空闲进程数、慢请求数等），并通过HTTP接口以Prometheus兼容的格式暴露，方便集成到监控体系中进行可视化和告警。镜像基于Alpine Linux构建，资源占用低，适合容器化环境部署。

核心功能

1. 指标采集：支持获取PHP-FPM的核心状态指标（包括进程状态、连接数、请求处理时间等）。
2. Prometheus兼容：输出格式符合Prometheus标准，可直接被Prometheus抓取。
3. 轻量高效：基于Alpine基础镜像，镜像体积小，运行时资源消耗低。
4. 灵活配置：通过命令行参数可自定义监听地址、PHP-FPM状态页面地址等。

使用场景

• 监控PHP-FPM服务的性能状态，及时发现慢请求、资源瓶颈等问题。
• 集成到Prometheus+Grafana监控系统，实现PHP-FPM指标的可视化展示。
• 容器化环境中（如Kubernetes、Docker Compose）对PHP-FPM容器进行实时监控。

配置说明

镜像运行时支持以下关键参数：

• --php-fpm.scrape-uri：PHP-FPM状态页面的地址（必填，如http://php-fpm:9000/status）。
• --web.listen-address：Exporter监听的地址和端口（默认0.0.0.0:9253）。
• --php-fpm.timeout：采集PHP-FPM指标的超时时间（默认10秒）。

部署示例

Docker Run命令

bash
docker run -d \
  -p 9253:9253 \
  flant/php-fpm-exporter \
  --php-fpm.scrape-uri=http://your-php-fpm-service:9000/status \
  --web.listen-address=0.0.0.0:9253

Docker Compose示例

yaml
version: "3"
services:
  php-fpm-exporter:
    image: flant/php-fpm-exporter
    ports:
      - "9253:9253"
    command: ["--php-fpm.scrape-uri=http://php-fpm:9000/status"]
    depends_on:
      - php-fpm
  php-fpm:
    image: php:fpm-alpine
    # 需确保PHP-FPM启用状态页面（在php-fpm.conf中配置pm.status_path = /status）

部署后，可通过http://localhost:9253/metrics访问指标数据，或配置Prometheus抓取该地址。 ===FULL_DESC===