README

Integration of the jmonitor/collector library into Symfony to collect metrics from your stack (Php, MySQL, Apache / Nginx / Caddy / FrankenPHP, Redis...) and send them to Jmonitor.io.

Jmonitor.io: https://jmonitor.io
Collector library (standalone): https://github.com/jmonitor/collector

Requirements

PHP 8.1+ for this bundle. (The standalone collector library supports PHP 7.4.)
Symfony 6.4+.
Optional: Symfony Scheduler (recommended): https://symfony.com/doc/current/scheduler.html
Linux recommended for the System collector. On Windows, use the RandomAdapter for testing.

Quick Start

Install the bundle:

composer require jmonitor/jmonitor-bundle

Create a project on https://jmonitor.io and copy your Project API key.
Configure your API key and collectors.

# .env
JMONITOR_API_KEY=your_api_key

# config/packages/jmonitor.yaml
jmonitor:
    enabled: true
    project_api_key: '%env(JMONITOR_API_KEY)%'

    # Optional: Symfony Scheduler transport name, or remove to disable scheduling.
    schedule: 'default'

    # Optional: use a specific logger service (Symfony's default is "logger").
    # See "Debugging" section below for more informations.
    # logger: 'logger'

    # Optional: provide a custom HTTP client service
    # http_client: 'http_client'
    
    # Enable the collectors you want to use (remove the unused ones).
    # Refer to the collector library for deeper collector-specific doc: https://github.com/jmonitor/collector
    collectors:
        
        # Cpu, Ram, Disk of the server. Linux only.
        system: ~
        # You can use a RandomAdapter on Windows for testing purpose.
        # system:
        #     adapter: 'Jmonitor\\Collector\\System\\Adapter\\RandomAdapter'
        
        # Apache via mod_status.
        # for more information, see https://github.com/jmonitor/collector?tab=readme-ov-file#apache
        apache:
            server_status_url: 'https://localhost/server-status'  
        
        # MySQL variables and status
        mysql:
            db_name: 'your_db_name'
            
        # PHP : some ini keys, opcache, loaded extensions... 
        # /!\ See below for more informations about CLI vs Web-context metrics
        # use this to collect web metrics
        # php: 
        #     endpoint: 'http://localhost/php-metrics'
        # of for CLI only
        # php: ~
        
        # Redis metrics via INFO command
        redis:
            # you can use either DSN or a service name (adapter). 
            # dsn: '%env(SOME_REDIS_DSN)%'
            # adapter: 'some_redis_service_name'
            
        # Metrics from FrankenPHP
        # see https://frankenphp.dev/docs/metrics/ 
        frankenphp:
            endpoint: 'http://localhost:2019/metrics'

        # Metrics from Caddy
        # see https://caddyserver.com/docs/metrics
        caddy:
            endpoint: 'http://localhost:2019/metrics'

Run a collection manually to verify:

php bin/console jmonitor:collect -vvv --dry-run

Exposing PHP metrics

Why this matters:

PHP settings and extensions can differ significantly between CLI and your web server context.
If you want metrics that reflect your web runtime, you must expose a tiny HTTP endpoint that returns PHP metrics from within that web context.

To do that, extend the built‑in controller:

// src/Controller/JmonitorPhpController.php
namespace App\Controller;

use Symfony\Component\Routing\Attribute\Route;
use Jmonitor\JmonitorBundle\Controller\JmonitorPhpController as BaseJmonitorPhpController;

#[Route('/jmonitor/php-metrics')] // chose an URL
final class JmonitorPhpController extends BaseJmonitorPhpController
{
}

Caution

Secure this URL !

A quick way can be to use local ip restriction in access_control configuration:

# config/packages/security.yaml
security:
    firewalls:
        jmonitor:
            pattern: ^/jmonitor/
            stateless: true
        main:
            # ...
    
    # ...
    access_control:
        # ...
        - { path: ^/jmonitor/php-metrics, roles: PUBLIC_ACCESS, ips: [127.0.0.1, 10.0.0.0/8, ::1, 192.168.0.0/24] }
        - { path: ^/jmonitor/php-metrics, roles: ROLE_NO_ACCESS }

Wire it in your bundle config

# config/packages/jmonitor.yaml
jmonitor:
    # ...
    collectors:
        php:
            # Use the URL you exposed above
            endpoint: 'https://localhost/jmonitor/php-metrics'

Scheduling

Command: jmonitor:collect.
With Symfony Scheduler enabled and schedule configured, the command runs every 15 seconds.
Without Scheduler, schedule the command yourself (e.g., cron, systemd timers, container orchestration schedules).

# Run once
php bin/console jmonitor:collect

Logging and Debugging

The command is resilient: individual collector failures do not crash the whole run; errors are logged.
Log levels:
- Errors (collector exceptions, HTTP responses with status >= 400): error
- Collected metrics: debug
- Summary: info

Useful commands:

# Verbose with debug logs
php bin/console jmonitor:collect -vvv

# Dry-run (collect but do not send)
php bin/console jmonitor:collect -vvv --dry-run

# Only summary
php bin/console jmonitor:collect -vv

jmonitor / jmonitor-bundle

Maintainers

Details