# Incoming Mail Log

<mark style="color:green;">SINCE VERSION 8.0</mark>

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**.

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2Fg4saKafJmk7tray4YDNe%2F15.jpg?alt=media\&token=272dde10-b36e-435d-adee-1c8a0da35644)

## Log details <a href="#incomingmaillog-logdetails" id="incomingmaillog-logdetails"></a>

By opening the log, the following details are shown:

| Column                  | Description                                                                                                                                                                                                                                                                                    |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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                | <p>category of actions that generated the log:</p><ul><li><strong>Filter emails</strong>: the log reflects why the email was filtered from being processed.</li><li><strong>Process emails</strong>: the log reflects how the email was processed</li></ul>                                    |
| Result                  | <p>result of actions that the mail handler has taken:</p><ul><li><strong>Skipped</strong>: when emails are filtered out</li><li><strong>Succeeded</strong>: when emails have been processed successfully</li><li><strong>Error</strong>: when processing emails resulted in an error</li></ul> |

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

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FpIgYOEmtvhqBzdAHObgK%2F16.jpg?alt=media\&token=884c84d6-b40b-4c1e-addf-e5650addcf2c)

## Remove items from the log <a href="#incomingmaillog-removeitemsfromthelog" id="incomingmaillog-removeitemsfromthelog"></a>

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 <a href="#incomingmaillog-deleteasinglelogitemsinglelog" id="incomingmaillog-deleteasinglelogitemsinglelog"></a>

You can click the three dots next to an email and use the **Delete** button to remove a single item from the log:

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2F5dpZUyiIL6Ggxobhr3J5%2F17.jpg?alt=media\&token=e5f196e2-8a08-4bd7-959b-97b7c1a3a2be)

### Manual purge <a href="#incomingmaillog-manualpurgemanuallog" id="incomingmaillog-manualpurgemanuallog"></a>

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:

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FwsK3jcpZmrA0ZYGX5lWz%2Fimage.png?alt=media\&token=eca0c8c8-4c4d-4d84-8edf-39f8f91a9815)

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

{% hint style="warning" %}
**Important**: Do not click on **Save Settings** unless you want to schedule an automatic purge.
{% endhint %}

### Automatic purge <a href="#incomingmaillog-automaticpurgeautolog" id="incomingmaillog-automaticpurgeautolog"></a>

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 <a href="#incomingmaillog-searchthelog" id="incomingmaillog-searchthelog"></a>

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:

![](https://4173056255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY44m7ZY1jU4Arh2tzwNn%2Fuploads%2FATChvUxBfIGPE8tBtmcq%2Fimage.png?alt=media\&token=c594f56a-94fd-4c59-9027-2fe448b0c5ef)

The available search fields are as follows:&#x20;

| Field        | Description                                                               |
| ------------ | ------------------------------------------------------------------------- |
| 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.                                      |
