fpm-exporter

README

Cbox FPM Exporter

Cbox FPM Exporter is a lightweight, Go-based Prometheus exporter for PHP-FPM and Laravel applications.

Features

• 📊 PHP-FPM metrics via FastCGI (using fcgx)
• ⚙️ Automatic PHP-FPM pool discovery via php-fpm -tt
• 🧠 Opcache statistics per FPM pool
• 🚦 Laravel queue sizes, app info, cache state
• 🔌 Prometheus /metrics endpoint + JSON at /json
• 🐘 Multi-site Laravel support

Documentation

📖 Full documentation available at cbox.dk/docs/fpm-exporter

Or browse the docs folder for:

• Installation
• Quickstart
• Configuration
• Metrics Reference

Quickstart

# Install (auto-detects OS/arch)
curl -fsSL https://raw.githubusercontent.com/cboxdk/fpm-exporter/main/install.sh | sh

# Run with auto-discovery
fpm-exporter serve

# With Laravel monitoring (shorthand)
fpm-exporter serve --laravel App:/var/www/html

# With Laravel queues (explicit)
fpm-exporter serve \
  --laravel-site name=App \
  --laravel-site path=/var/www/html \
  --laravel-site queues.redis=default,emails

Configuration

Environment Variables

Variable	Description	Default
CBOX_DEBUG	Enable debug mode	false
CBOX_MONITOR_LISTEN_ADDR	Listen address	:9114
CBOX_PHPFPM_ENABLED	Enable PHP-FPM monitoring	true
CBOX_PHPFPM_AUTODISCOVER	Auto-discover pools	true

YAML Config

debug: false
monitor:
  listen_addr: ":9114"
phpfpm:
  enabled: true
  autodiscover: true
laravel:
  - name: App
    path: /var/www/html
    queues:
      redis: ["default", "emails"]

See Configuration Reference for all options.

Metrics

Key metrics exported:

# PHP-FPM
phpfpm_up{pool="www",socket="..."} 1
phpfpm_active_processes{pool="www"} 2
phpfpm_idle_processes{pool="www"} 3
phpfpm_max_children_reached{pool="www"} 0

# Opcache
phpfpm_opcache_hit_rate{pool="www"} 98.5
phpfpm_opcache_used_memory_bytes{pool="www"} 67108864

# Laravel
laravel_queue_size{site="App",connection="redis",queue="default"} 42
laravel_debug_mode{site="App"} 0

See Metrics Reference for the complete list.

Building

# Build for current platform
make build

# Build all platforms
make build-all

Produces static binaries (no libc dependencies) for:

• fpm-exporter-linux-amd64
• fpm-exporter-linux-arm64
• fpm-exporter-darwin-amd64
• fpm-exporter-darwin-arm64

License

MIT License — © 2024–2025 Cbox