jmonitoring/jmonitor-bundle

Integration of jmonitor monitoring library in symfony.

dev-master 2025-07-15 21:06 UTC

Requires

• php: ^8.1
• jmonitoring/jmonitor: dev-master
• nyholm/psr7: ^1.8
• symfony/console: ^6.4|^7.0
• symfony/framework-bundle: ^6.4|^7.0
• symfony/http-client: ^6.4|^7.0

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^10.5

Suggests

• symfony/scheduler: If you want the bundle to automatically collect metrics at regular intervals.

MIT

• Johndodev

• redis
• symfony
• php
• mysql
• monitoring
• Metrics
• system
• apache
• nginx

README

Integration of the jmonitoring/jmonitor, library into Symfony.
Jmonitor.io is a simple monitoring service for PHP applications and web servers that provides insights and alerting from various sources like MySQL, Redis, Apache, Nginx...

This bundle uses Symfony Scheduler to send metrics to Jmonitor.io every 15 seconds.
You can still use it without it, but you will need to set up a cron by yourself.

Requirements

• PHP 8.1 for the bundle. You can still use Jmonitor with PHP 7.4 with the standalone library.
• Symfony 6.4 or higher.
• You need to use Symfony Scheduler: https://symfony.com/doc/current/scheduler.html

Installation

composer require jmonitoring/jmonitor-bundle

Configuration

Create a project in jmonitor.io and get your API key.

.env

JMONITOR_API_KEY=your_api_key

config/packages/jmonitor.yaml

jmonitor:
    enabled: true
    project_api_key: '%env(JMONITOR_API_KEY)%'
    schedule: 'default' # Optionnal. You can omit this line if already use a "default" schedule. Remove it if you do not use symfony scheduler.
    
    # Enable the collectors you want to use.
    collectors:
        system: ~
        apache:
            server_status_url: 'https://localhost/server-status' # for more informations, see https://github.com/jmonitoring/jmonitor?tab=readme-ov-file#apache 
        mysql:
            db_name: 'your_db_name'
        php: ~
        redis: 
            # you can use either DSN or a service name (adapter). 
            # Remove the unused one.
            dsn: '%env(SOME_REDIS_DSN)%'
            adapter: 'some_redis_service_name'

You can customize the HTTP client used by Jmonitor.

jmonitor:
    #...
    http_client: 'some_http_client'