README

Fetch health state of your pimcore installation.

Release Plan

Installation

"require" : {
    "dachcom-digital/monitoring" : "~4.4.0"
}

Add Bundle to bundles.php:

return [
    MonitoringBundle\MonitoringBundle::class => ['all' => true],
];

Install Routes

# config/routes.yaml
monitoring:
    resource: '@MonitoringBundle/config/routing.yaml'

Configuration

# config/packages/monitoring.yaml
monitoring:
    api_code: 'YOUR_API_CODE'

Fetch Data

curl --data "apiCode=YOUR_API_CODE" https://www.your-domain.tld/monitoring/fetch

Fetch Data By Check

curl --data "apiCode=YOUR_API_CODE" https://www.your-domain.tld/monitoring/fetch?filter=core,heartbeat

Create Custom Check

Create a tagged pimcore.monitoring.check service and implement the CheckInterface interface.

Available Checks

• Pimcore version and revision
• PHP (version, memory_limit and more)
• Kernel (environment, debug)
• Installed Bundles
• Installed AreaBricks
• Available Users

Modules

Email Log Module

monitoring:
    modules:
        email_log: true # disabled by default

curl --data "apiCode=YOUR_API_CODE" https://www.your-domain.tld/monitoring/fetch-email-log

Params

• onlyErrors: only fetch logs with errors (Default false)
• startingFrom: only fetch logs newer than Y-m-d H:i:s (Default null)
• limit: limit log response (Default 100)

Heartbeat Module

This module provides a lightweight "heartbeat" mechanism to monitor the execution of periodic maintenance tasks. It helps verify that both the system cronjob and the Symfony Messenger queue are functioning correctly.

This heartbeat check:

• Confirms that the cronjob is triggering as expected.
• Confirms that the Messenger worker is actively processing jobs.
• Optionally indicates the duration or load of the maintenance task by analyzing time deltas between executions.

monitoring:
    modules:
        heartbeat: true # disabled by default

This will also add a check hearbeat.

Upgrade Info

Before updating, please check our upgrade notes!

License

DACHCOM.DIGITAL AG, Löwenhofstrasse 15, 9424 Rheineck, Schweiz
dachcom.com, dcdi@dachcom.ch
Copyright © 2025 DACHCOM.DIGITAL. All rights reserved.

For licensing details please visit LICENSE.md