# 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:
| 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 | 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.
{% hint style="warning" %}
**Important**: Do not click on **Save Settings** unless you want to schedule an automatic purge.
{% endhint %}
### 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:
| 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. |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.meta-inf.hu/email-this-issue/email-this-issue-for-jira-server-data-center/documentation/administration/incoming-mail-log.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.