Skip to main content

Report Errors to Developer

Report errors to developer lets your Mumara Campaigns installation tell the Mumara team about unexpected errors automatically, so they can be investigated and fixed — often before anyone opens a support ticket. It is designed to be safe to leave on: reports are stripped of personal data, they are sent in the background so they never slow the application down, and you can turn the feature off at any time.

Where to find it

WhereWhat you see
Installation wizard → Administrator Account stepA pre-selected checkbox "Help improve Mumara by automatically reporting errors to the developers". Untick it to keep everything local.
Settings → Application Settings → LogsThe Report errors to developer switch, and next to it the Send diagnostic report now button.
Existing installations start off

Installations updated from an earlier version are not opted in. The feature stays off until an administrator switches it on under Application Settings → Logs and saves the tab.

What a report contains

IncludedPurpose
The error message, type, and where in the application it happened (with the sequence of recent internal steps that led to it)Lets the developers reproduce the problem
Application version and installation type (self-hosted, cloud, demo)Tells them which release the problem is in
PHP version, database version, operating system, and IonCube versionRules environment differences in or out
Installed addons and their versionsIdentifies addon-related problems
Cron health — how long ago each scheduled job last ranExplains "nothing is being sent" situations
A small, fixed set of non-sensitive settings (batch size, queue driver, log level, timezone, …)Explains configuration-dependent behaviour
The last few lines of the application log, with personal data maskedShows what the application was doing just before the error
Your license's client and service identifiers, the domain the application runs on, and the first characters of the license keyLets the developers see which installation the report belongs to and reach out if needed

What a report never contains

  • Your contacts — no email addresses, names, or custom-field data
  • Email content — no templates, subjects, or bodies
  • Passwords, API keys, tokens, or SMTP credentials
  • Submitted form data, cookies, or browser sessions
  • The user who was logged in when the error happened

In addition, every part of a report is scrubbed before it leaves your server: email addresses become [email], IP addresses become [ip], and anything that looks like a password, token, or key is replaced with [redacted].

How reports are sent

Reporting never happens during a page load or a sending run. When an error is caught, the report is written to a small local queue on your server and sent to the Mumara error tracker in the background by the scheduled tasks that already run every few minutes.

  • Rate limits — the same error is reported at most 5 times per hour, and an installation sends at most 200 reports per day, so a runaway problem cannot flood anything.
  • Unreachable tracker — if the tracker cannot be reached, reports wait in the local queue and are retried with increasing pauses; anything still unsent after 3 days is discarded. The queue is capped in size, so it can never fill your disk.
  • Nothing when off — with the switch off, no error-reporting component is even loaded, so there is no overhead at all.

Send a diagnostic report on demand

Some problems do not produce an error — campaigns that stay queued, imports that seem slow, a cron job that appears stuck. For those, use Send diagnostic report now on the Logs tab:

  1. Make sure Report errors to developer is switched on and the tab has been saved.
  2. Click Send diagnostic report now.
  3. Copy the Report ID that appears next to the button and quote it to support.

A diagnostic report carries everything an automatic report does, plus a fuller picture of the server — PHP extensions and limits, disk space, and the most recent entries from the application's own error list. It is sent immediately; if the tracker cannot be reached at that moment, the report is queued and sent within a few minutes, and the ID stays valid.

tip

Send a diagnostic report before opening a ticket about a "nothing happens" problem. It usually saves a round of back-and-forth about versions, cron settings, and log excerpts.

Turning it off

Switch Report errors to developer off under Settings → Application Settings → Logs and save the tab. Reporting stops immediately; anything still in the local queue is discarded on the next scheduled run.

For server administrators

Two optional values in the installation's .env file override the setting for that server — useful when the same server image is deployed many times:

VariableEffect
MUMARA_ERROR_REPORTING_ENABLEDtrue forces reporting on, false forces it off, regardless of the switch in Application Settings. Leave unset to follow the switch.
MUMARA_ERROR_REPORTING_DSNWhere reports are sent. Setting it to an empty value disables the feature completely; it is normally left unset.

Run Tools → Config Cache (or php artisan config:cache) after changing .env values.

Frequently Asked Questions

Does it slow the application down? No. Reports are written locally and sent later in the background; nothing waits for the network.

Can the Mumara team see my subscribers or my campaigns? No. Contacts, email content, credentials, and form data are never part of a report, and email addresses or IP addresses that appear in an error message are masked before the report is created.

My server has no outbound internet access. Is that a problem? No. Reports simply wait in the local queue and are discarded after 3 days. The application is not affected either way. If that is your situation, you may prefer to leave the feature off.

Where do the reports go? To an error-tracking service operated by Mumara. Reports are used only to diagnose and fix problems in Mumara Campaigns.


Related: Application Settings → Logs Tab · Debug Logs