Send System Status Reports with Notification Emails

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)

  • Time period

  • 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 Notifications page enables you to manage email delivery through either of two methods:
  • 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 following:
    • 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.
  1. In the navigation pane, click Settings, then Notifications.


    The Notifications page shows introductory text, a Recipients field to add email addresses, a Reports section with Hourly Status and Daily Status check boxes, the Alerts section with an Expiring and expired certificates check box and Critical health check box, a Use customer SMTP configuration section, a Senders button, and a table with columns for email addresses, approved status, SPF status, confirming DKIM, and using system notifications.

  2. In the Recipients field, enter the email address to which to send the reports. You can specify multiple email addresses, each separated by commas.

  3. 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.
  4. In the Alerts section, select to send alerts when the following occurs:
    Option Description
    Expiring and expired certificates (Daily)

    Select to send alerts when the following occurs:

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

    Critical health (5 mins)

    Select to send alerts when one or more of the following conditions are detected:

    • The email quota exceeded the threshold.
    • One or more connectivity agent instances became unavailable.
  5. To use your own customer tenancy to manage the number of emails to send, click Toggle icon to enable customer tenancy mode.
    1. Specify the SMTP user name and password and the default sender email address (that is, the from address). These three fields are required. You can also optionally specify a default address for system notifications.
      The Use customer SMTP configuration section includes fields for SMTP user name, SMTP password, Default sender email address, and Sender email address for system notification.

    2. Click Test to validate the SMTP credentials.
    3. Click Save.

      Note:

      If you want to return to using the default method, click SMTP configuration icon to disable the SMTP credentials, and click Save.
  6. To use the default method to manage the number of emails to send, follow these steps:
    1. In the Senders section, click Add Email Address in the lower right corner to add approved senders.
    2. Specify the following details:
      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.

    3. Click Save.

  7. Perform other email notification tasks on this page.
    To ... Description

    Receive an immediate email about system status

    Click Actions Actions icon and select Send Now.

    Clear the distribution list, selected alert/reports options, and specified sender email addresses. Click ActionsActions icon 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 ActionsActions icon and select Email Suppression List.

    See Remove Email Addresses from the Suppression List.

Remove Email Addresses from the Suppression List

You can remove email addresses from the suppression list.

Adding users to a suppression list is a common task in email address management. Reasons for adding email addresses to the suppression list can include the following:
  • 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.

  1. Click Actions Actions icon 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.

  2. Search for the email address to remove.

    Note:

    The search functionality is case sensitive. For example, if the email address you are looking for is joe.smith@mycompany.com, and you enter Joe.Smith@mycompany.com, the email address is not returned in the search results.
  3. Next to the email address to remove, click Delete Delete icon.

    This action removes this address from the suppression list.

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

See Troubleshoot Oracle Cloud Infrastructure Notification Email Configuration to Ensure Proper Delivery.