hipages/php-fpm_exporter

php-fpm_exporter

镜像概述

php-fpm_exporter是一个针对PHP-FPM的Prometheus指标导出器。该工具直接连接PHP-FPM实例，收集其运行状态指标，并通过HTTP接口提供标准化的Prometheus指标数据，便于监控系统采集和分析PHP-FPM性能。

项目源码地址：https://github.com/hipages/php-fpm_exporter

核心功能与特性

• 直接连接PHP-FPM：无需额外插件，通过PHP-FPM内置的状态页面获取指标
• Prometheus兼容：输出符合Prometheus标准的指标格式，支持直接接入Prometheus监控
• HTTP接口暴露：通过HTTP服务提供指标数据，默认监听9253端口
• 轻量部署：以Docker容器形式运行，配置简单，易于集成到现有环境

使用场景与适用范围

• PHP应用服务器监控：适用于运行PHP-FPM的Web服务器环境（如Nginx+PHP-FPM架构）
• 性能指标收集：可采集PHP-FPM关键指标，包括活跃进程数、请求数、慢请求数、内存使用等
• 监控告警集成：配合Prometheus和Grafana实现PHP-FPM性能可视化与告警
• 容器化环境：特别适合Docker或Kubernetes等容器化部署的PHP应用监控

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name php-fpm-exporter \
  -p 9253:9253 \
  -e PHP_FPM_SCRAPE_URI="tcp://php-fpm:9000/status" \
  hipages/php-fpm_exporter

Docker Compose配置

yaml
version: '3'
services:
  php-fpm:
    image: php:fpm
    # 确保PHP-FPM启用状态页面
    command: php-fpm -F -y /usr/local/etc/php-fpm.conf
    volumes:
      - ./php-fpm.conf:/usr/local/etc/php-fpm.conf:ro
      
  php-fpm-exporter:
    image: hipages/php-fpm_exporter
    ports:
      - "9253:9253"
    environment:
      - PHP_FPM_SCRAPE_URI=tcp://php-fpm:9000/status
      - LISTEN_ADDRESS=:9253
      - SCRAPE_TIMEOUT=5s
    depends_on:
      - php-fpm

配置参数说明

环境变量

PHP-FPM配置要求

需确保PHP-FPM启用状态页面，在php-fpm.conf或[***]

ini
pm.status_path = /status

指标访问

启动容器后，可通过以下地址访问指标：

http://<容器IP>:9253/metrics

示例指标包括：

• php_fpm_active_processes：活跃进程数
• php_fpm_requests_total：总请求数
• php_fpm_slow_requests_total：慢请求数
• php_fpm_memory_usage_bytes：内存使用量