Incoming Mail Log

SINCE VERSION 8.0

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. Go to INCOMING EMAILS ADMINSTRATION --> Incoming Mail Log.

Log details

By opening the log, the following details are shown:

ColumnDescription

From Address / Reporter

the sender of the email or the reporter of the issue related to the email

Subject

the email's subject

When

when 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:

  • Manually remove a single log entry.

  • Manually remove multiple log entries that are over a certain age.

  • Schedule an automatic purge process to bulk remove log entries that are over a certain age.

Deleting a single log item

You can click the three dots next to an email and 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. The following options are available:

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

Important: Do not click on Save Settings unless you want to schedule an automatic purge.

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.

Searching 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 range

Search for items added in the last n days.

Category

Search for items of the selected Category.

Result

Search for items of the selected Result.

Show maximum

The maximum number of items to show.

Last updated