Server Monitor

Easily keep an eye on your server's health and performance for your Mautic site.

The Server Monitor Plugin checks important things like CPU, memory, and disk space, and lets you know if something needs your attention. Works with Mautic 4, 5, 6, and 7.

Requirements: A Linux server (the plugin uses /proc/stat, /proc/meminfo, and the df command).

Features

Email Alerts: Get an email right away if your server is running out of memory, disk space, or CPU power. Set multiple email addresses (comma separated).
Dashboard Widget: See your server's health at a glance on your Mautic dashboard — CPU, memory, disk usage, and system uptime with color-coded status (OK, Warning, Danger).
Set Your Own Limits: Choose warning and critical thresholds for CPU, memory, and disk usage.
Reports: Look back at how your server has been doing over time using Mautic's reporting system.
Webhook Support: Connect with other tools (Zapier, Make.com) via a server.monitor webhook event.
Automatic Cleanup: Old server logs (30 days) are deleted automatically during Mautic's maintenance cleanup.
Choose Check Frequency: Decide how often the plugin checks your server (configurable in settings).

Installation

Step 1: Copy the plugin

Place the plugin folder in plugins/ServerMonitorBundle

Step 2: Clear cache

php bin/console cache:clear

Step 3: Reload plugins list

php bin/console mautic:plugins:reload

Step 4: Re-generate assets

php bin/console mautic:assets:generate

After installation, go to Settings > Plugins in Mautic and make sure the plugin is enabled.

Note: Make sure your server is Linux-based, as the plugin uses Linux system files and commands.

Settings

After installing and publishing the plugin, configure it to match your needs:

Warning and Critical Thresholds: Set the limits for CPU, memory, and disk usage (default: 85% warning, 95% critical).
Check Frequency (Timeout): Choose how often the plugin checks your server (default: every 5 minutes = 300 seconds).
Notification Emails: Enter one or more email addresses to receive alerts (separate with commas). Leave blank to disable email alerts.
Webhook Integration: The plugin automatically triggers a server.monitor webhook event with the latest stats.
Automatic Data Cleanup: Old server logs (older than 30 days) are deleted automatically during Mautic's maintenance cleanup.

Don't forget to save your settings after making changes.

Note: The plugin only works if it is published and your Mautic cron jobs are running.

Usage

Dashboard Widget — Add the Server Monitor Overview widget to your dashboard to see:

CPU usage: Shows how busy your server is, with a colored bar (green = OK, yellow = warning, red = danger).
Memory usage: See how much memory is used and total available (in GB and %).
Disk usage: See how much storage is used and total available (in GB and %).
System uptime: Shows how long your server has been running.

Email & Webhook Alerts — Add your email address in the plugin settings. You'll get alerts if something goes wrong. The plugin triggers a server.monitor event with the latest stats that you can connect to external tools.

Reports — View historical server performance in Mautic's reporting section. Create custom reports using the "Server Monitor" data source to analyze trends over time.

Tip: If you don't see new data, make sure the plugin is published and your Mautic cron jobs are running.

FAQ

Can I get email alerts if there's a server problem?

Yes! Just add your email address in the plugin settings and you'll get alerts if your server is running out of memory, disk space, or CPU. You can add more than one email address (separate with commas).

When will I get a warning or alert?

By default, you'll get a warning at 85% usage and a critical alert at 95%. You can change these numbers in the settings.

How long does the plugin keep server data?

The plugin keeps data for 30 days. Older data is deleted automatically when Mautic does its regular cleanup.

Can I connect this plugin to other tools?

Yes, the plugin can send a server.monitor webhook event. You can use this with Zapier, Make.com, or set up your own webhook listener in Mautic.

How often does the plugin check my server?

By default, every 5 minutes (300 seconds). You can change this in the plugin settings by adjusting the "Timeout" value.

What if I don't see new stats or alerts?

Make sure the plugin is published and your Mautic cron jobs are running. Stats are updated when Mautic commands run.

What kind of server do I need?

The plugin works on Linux servers. It uses /proc/stat, /proc/meminfo, and the df command to get stats.