You can notify users by email with hourly or daily reports about total messages received, total messages processed, successful messages, failed messages, and successful message rate; with service failure alerts (for example, and when a service is down or an agent becomes unavailable). You can also remove email addresses from the suppression list.
Note:This is a system level setting. Therefore, user A cannot create one notification setup while user B creates another notification setup. User B can see the notification setup created initially by user A and can modify it.
Understand DKIM Authentication and SPF Record Details
When you configure notification emails to send service failure alerts, system status reports, and integration error reports, you can optionally specify Domain Keys Identified Mail (DKIM) authentication and Sender Policy Framework (SPF) record details.
Details and examples are provided to better understand DKIM and SPF. See the An Advanced Guide to OIC Notification via Emails blog and Configure Email Authentication Settings for SPF and DKIM in Provisioning and Administering Oracle Integration 3.
Configure Notification Emails
You can configure notification emails to notify interested parties about system status on a regular basis and alert them about service failures. Detailed system status reports include metrics on instances and runs processed by the system, including failures. You can select to send an hourly or daily report and specify the list of recipients.
The report includes the following information:
POD name (also included in the subject of the email)
Total messages received, processed, succeeded, aborted, and failed
Percentage of successful messages
Errors by integration instance and run including messages received, processed, succeeded, and failed
The email includes a link at the bottom to change the notification settings or completely stop receiving email notifications. Click Oracle Integration to access the Notifications page to adjust your settings.
- The default method: Sets your limit at 10,000 emails for a rolling 24-hour window. This is provided automatically and requires no additional configuration to use.
- Your own customer tenancy: Sets your limit
to the number allowed by the Oracle Cloud
Infrastructure Email Delivery Service for a
rolling 24-hour window. See Email
Delivery Service Capabilities and Limits.
To use your customer tenancy, you must do the
- Create SMTP credentials in the Oracle Cloud Infrastructure Console in order to complete the Use customer SMTP configuration section. Only Oracle Cloud Infrastructure SMTP credentials are supported. See Generate SMTP Credentials for a User.
- Register the default sender email address and the sender email address for system notification with Oracle Cloud Infrastructure in your customer tenancy.
- Manage the approved senders and suppression list in your customer tenancy.
- Check the service limits. See Overview of the Email Delivery Service.
In the navigation pane, click Settings, then Notifications.
In the Recipients field, enter the email address to which to send the reports. You can specify multiple email addresses, each separated by commas.
- In the Reports field, select the type of
report to send.
- Hourly Status: Send a detailed report every hour.
- Daily Status: Alerts are sent once a day.
- In the
Alerts section, select the
check box if you want to send alerts when the following
- Certificates are set to expire within seven days.
- Certificates have expired.
The check is made for certificates you uploaded on the Certificates page. Certificate expiration status is checked daily. Oracle Integration provided-certificates are not checked.
- To use your own customer tenancy to manage the
number of emails to send, click to enable customer tenancy mode.
- Specify the SMTP user name and
password and the default sender email address
(that is, the
fromaddress). These three fields are required. You can also optionally specify a default address for system notifications.
- Click Test to validate the SMTP credentials.
Note:If you want to return to using the default method, click to disable the SMTP credentials, and click Save.
- Specify the SMTP user name and password and the default sender email address (that is, the
- To use the default method to manage the number of
emails to send, follow these steps:
- In the Senders section, click Add Email Address in the lower right corner to add approved senders.
- Specify the following
Element Description Email Address An approved sender enables Oracle Integration to send email with a matching From address. An email is sent to each of the email addresses listed as approved senders. Upon approval, these email addresses can be used as the From address in a notification action of an integration and/or system notification. Approval Status Indicates if the email address is approved. Green indicates the address is approved. Yellow indicates the address is not yet approved.
Email address approval is based on your version of Oracle Integration. In Oracle Integration, a verification email is sent. You must click the verification link you receive in the email. Upon successful verification, status is changed to green. In Oracle Integration 3, the email is automatically approved when you add the email ID.
SPF Status Optionally configure the Sender Policy Framework (SPF) for the sender email addresses. You configure SPF support outside of Oracle Integration. Confirm DKIM Optionally confirm the Domain Keys Identified Mail (DKIM) for the sender email addresses. You configure DKIM support outside of Oracle Integration. Use for System Notification Select to use this email address for the system notifications you selected at the top of the page. However, only a single email address can be selected to send system notifications.
Recommendations are provided to ensure that you configure notification email correctly. See Troubleshoot Oracle Cloud Infrastructure Notification Email Configuration to Ensure Proper Delivery.
- Perform other email notification tasks on this page.
To ... Description
Receive an immediate email about system status
Click Actions and select Send Now.
Clear the distribution list, selected alert/reports options, and specified sender email addresses. Click Actions and select Reset All Notifications. Remove email addresses from the suppression list
Note: This task is only required if you are using the default method.
Click Actions and select Email Suppression List.
Remove Email Addresses from the Suppression List
You can remove email addresses from the suppression list.
- An employee on an email distribution list left the company and their email address was deactivated.
- SPF and DKIM not being configured on the sender's address domain server (DNS) result in soft bounces and subsequently end up on the suppression list.
Oracle Integration provides a self-service feature that enables you to view and remove email addresses from the suppression list, when necessary. This feature eliminates the need to file a service request to remove addresses from the suppression list.
Suppressed email addresses can lead to errors in your integration. The activity stream of the instance can show that a notification action failed if the email address used to send the notification is on the suppression list.
Click Actions and select Email Suppression List.
The Email Suppression List drawer opens on the right side. Email addresses on the suppression list cannot send or receive email notifications.
- Search for the email address to
Note:The search functionality is case sensitive. For example, if the email address you are looking for is
firstname.lastname@example.org, and you enter
Joe.Smith@mycompany.com, the email address is not returned in the search results.
- Next to the email address to
remove, click Delete
This action removes this address from the suppression list.
- Rerun the integration and check the activity stream again. The notification action completes successfully this time.
Change the Delivery Time of Notification Emails
You can change the delivery time of notification emails.
The tracking metrics daily report runs by default at 00:00 UTC time, which can differ from your time zone. For example, the central time zone is 6 hours behind the UTC time zone. When the report runs at 00:00 UTC on November 14th, it is processing at 6:00pm central time on November 13th.
The report time is based on UTC time, which ensures a common reference point (particularly for the log files). This enables anyone in any time zone to identify the time of processing. This is important for global companies with operations in multiple countries/time zones.
As a workaround, set up notifications to run hourly and use a tool such an Outlook rule to automatically delete the 23 unwanted emails, keeping the one email with the tracking metrics you want.