oxalide/phpfpm-prometheus-exporter

PHP FPM Prometheus Exporter镜像

镜像概述

该镜像用于将PHP-FPM的状态和统计数据通过HTTP接口暴露给Prometheus监控系统。本版本基于https://github.com/blablacar/phpfpm-prometheus-exporter%E9%A1%B9%E7%9B%AE%E5%88%86%E5%8F%89%EF%BC%8C%E5%B9%B6%E4%BF%AE%E6%94%B9%E4%B8%BA%E5%8F%AF%E5%9C%A8Docker%E5%92%8CKubernetes%E7%8E%AF%E5%A2%83%E4%B8%AD%E8%BF%90%E8%A1%8C%E3%80%82

核心功能

• 采集PHP-FPM的运行状态数据（如进程数量、请求处理情况、内存使用等）
• 通过标准化HTTP接口向Prometheus提供监控指标
• 支持自定义配置参数（监听地址、轮询间隔、日志级别等）

使用场景

• 监控PHP-FPM服务的实时运行状态和性能指标
• 集成到Prometheus+Grafana监控体系，实现PHP应用性能可视化
• 在Docker或Kubernetes集群中对PHP服务进行自动化监控

配置说明

命令行参数

运行镜像时可通过以下参数配置：

• -log.format value：日志目标和格式（默认：logger:stderr）
• -log.level value：日志级别（可选值：debug/info/warn/error/fatal，默认：info）
• -nc.connect-timeout int：客户端连接超时时间（单位：ms，默认：500）
• -phpfpm.listen-key string：PHP-FPM监听地址（默认：127.0.0.1:9000）
• -phpfpm.pid-file string：PHP-FPM PID文件路径（默认：/var/run/php5-fpm.pid）
• -phpfpm.poll-interval int：数据轮询间隔（单位：秒，默认：10）
• -phpfpm.pool-name string：PHP-FPM池名称（默认：www）
• -phpfpm.status-key string：PHP-FPM状态路径（默认：/status）
• -version：打印版本信息
• -web.listen-address string：遥测接口监听地址（默认：:9101）
• -web.telemetry-path string：指标暴露路径（默认：/metrics）

Docker环境变量

使用Docker时可通过以下环境变量配置：

• LISTEN_KEY：对应-phpfpm.listen-key
• STATUS_KEY：对应-phpfpm.status-key
• POOL_NAME：对应-phpfpm.pool-name
• METRICS_ADDR：对应-web.listen-address

部署示例

Docker Run命令

bash
docker run -d \
  -p 9101:9101 \
  -e LISTEN_KEY="phpfpm-container:9000" \
  -e POOL_NAME="my-php-pool" \
  oxalide/phpfpm-prometheus-exporter

Docker Compose配置

yaml
version: '3.8'
services:
  phpfpm-exporter:
    image: oxalide/phpfpm-prometheus-exporter
    ports:
      - "9101:9101"
    environment:
      LISTEN_KEY: "phpfpm:9000"
      STATUS_KEY: "/status"
      POOL_NAME: "www"
      METRICS_ADDR: ":9101"
    depends_on:
      - phpfpm
  phpfpm:
    image: php:fpm
    volumes:
      - ./php-fpm.conf:/usr/local/etc/php-fpm.conf