Incoming Mail Log

The Incoming Mail Log provides insights to the internal statuses of the mail handlers. You can access the Incoming Mail Log from the app's administration page.

Log Details

By opening the log, the following details are shown:

ColumnDescription
From Address / Reporterthe sender of the email or the reporter of the issue related to the email
Subjectthe email's subject
Whenwhen the log was created
Category

category of actions that generated the log:

  • Filter emails: the log reflects why the email was filtered from being processed.
  • Process emails: the log reflects how the email was processed
Result

result of actions that the mail handler has taken:

  • Skipped: when emails are filtered out
  • Succeeded: when emails have been processed successfully
  • Error: when processing emails resulted in an error

By expanding the log items you can reveal more details:

  • Message ID: extracted from the MESSAGE-ID header of the email that was processed
  • Execution ID: a unique identifier of the course of actions related to this email
  • Log: detailed set of steps the mail handler has done or the reason why the email was filtered out

Remove Items from the Log

Entries of the Mail Handler log are permanently stored in the database. This poses a risk of increasing the size of the database dramatically.

To prevent this you can remove entries from the log in one of the following ways:

Delete a Single Log Item

You can use the Delete button to remove a single item from the log:


Manual Purge

To remove multiple entries manually, click on the Configure Purge button. This opens a form where the relevant field is Items to remove. This allows you to select the age of the log entries to remove. Options include emails older than 1 month, 3 months, 6 months:

To actually remove the mail items, click the Purge Items Permanently button.

Automatic Purge

To remove items automatically, click on the Configure Purge button.

This opens a form where there are two relevant fields to set are:

  • Hour to start at: specifies when the purge job is carried out every day
  • Items to remove: allows you to select the age of the mail items to remove. Options include emails older than 1 month, 3 months, 6 months.

To schedule the job, click Save Settings.

Search the Log

As the Incoming Mail Log may grow fast, you can use the search function to find particular items. Click the Search button (marked with a magnifier icon) to open the search form:


The available search fields are as follows: 

FieldDescription
Search for

free-text search over the sender, message id, log text and email subject

Time rangesearch for items added in the last X days
Categorysearch for items of the selected Category
Resultsearch for items of the selected Result
Show maximummaximum number of items to show