Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Status | ||||
---|---|---|---|---|
|
Incoming Mail Queue provides ways to look into the internal status of the mailbox connections. You can access the Incoming Mail Queue from the administration page.
The Incoming Mail Queue is related to Email This Issue's internal mailbox connections, it does not show details of the Jira Mail Services (connections configured in Jira Incoming Mail page).
Different Views in the Queue
The Incoming Mail Queue has different views related to the phases:
New → | Filtered → | Being Processed → | Failed |
---|---|---|---|
this tab shows emails that have been successfully downloaded | this tab shows emails that were downloaded but all related mail handlers have filtered them out, so they are not processed |
| emails that were downloaded but the mail handler failed to process them |
New Emails
This page lists the emails that were downloaded from all the enabled mail accounts.
Status | ||||
---|---|---|---|---|
|
Filtered Emails
This page lists the emails that were downloaded and passed to mail handlers attached to the mail account which downloaded the email, but all of these handlers have refused to process the email. Details of the reason (why the email was filtered) can be seen in the Incoming Mail Log.
Status | ||||||
---|---|---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Emails Being Processed
This page lists the emails that were downloaded and there was a handler that accepted it for processing and the emails are being processed.
Normally processing an email does not take long. It depends on the configuration of the mail handler but should not take more than 1-2 seconds in well performing system.
If the email was successfully processed, it is removed from the queue and also from the database which keeps the DB as reduced as possible.
However, if an error occurs duding while processing the email, it is moved to the Error Queue.
Failed Emails
This is an error queue for emails which the handlers could not successfully processed.
Error details can be seen in the Incoming Mail Log.
Status | ||||
---|---|---|---|---|
|
Status | ||||
---|---|---|---|---|
|
Email Details in the Queue
In all views, the queue shows the below detail of the email items:
- Account: the incoming mail account which downloaded the email
- From: the sender of the email
- Subject: subject of the email
- Received: when the email was downloaded
- Processed: when the email was last submitted for processing by the handlers.
To reveal more details, click the > icon:
- To, Cc: recipients of the email
- Body: mail body in text format
- Message Headers: all headers hidden in the email
Purge Old Items
Remove Emails from the Queue
Filtered emails and those which failed to process will remain on the queue permanently. This is a kind of risk to increase the size of the database dramatically.
To prevent this you can remove emails from the Filtered and Failed views in three ways:
- manually remove a single email
- schedule an automatic purge process
- to bulk remove items
Image Removed
- that are over a certain age
- manually remove multiple emails that are over a certain age
Image Added
Delete a Single Email from the Queue
You can use the Delete menu of an email to remove it from the queue:
Image Added
Manual Purge
To remove multiple items manually, click the "Configure Purge" button in the page. This opens a form where the relevant field is Items to remove. This allows you to select the age of the mail items to remove. Options include emails older than 1 month, 3 months, 6 months.
To actually remoe remove the mail items, click the Purge Items Permanently button.
Automatic Purge
To remove items automatically, click the "Configure Purge" button in the page.
This opens a form where there are two fields to set:
- Hours to start at: specifies when the purge job is started every day
- Items to remove: field 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.
Panel | ||||
---|---|---|---|---|
| ||||
|