Enabling and Viewing Notifications

Oracle automatically notifies you by email to let you know about any environment lifecycle activities and any events impacting service availability.

You can view up to 3 months of past notifications for your tenancy in the Cloud Console.

Oracle Applications converted to or provisioned on the new Oracle Cloud Console use the Oracle Cloud Infrastructure (OCI) Announcements Service to send email notifications. This service alerts customers to operational events affecting service status. You can subscribe to announcements to receive them by email, SMS, or other supported methods through integration with the OCI Notifications service.

Announcements belong to different categories. An announcement prefix helps you understand, at a glance, the type and relative severity of the information and whether there's anything you can or must do. Announcement types currently include the following, in order of most important to least:

If you want to receive announcements through email or another delivery mechanism, you can manage the tenancy administrator email preferences or configure subscriptions.

Announcement subscriptions direct announcements that match specified filter criteria to your choice of endpoint (email, SMS, and others). Endpoints can be configured using topics in the Notifications service, which can have multiple recipients for a given subscription protocol. A topic is a communication channel for sending messages to its subscriptions.

• If you are a new Oracle customer, the "cloud account administrator" who provisioned the application, or a user with the role "Administrator" in the Cloud Console, you receive all emails and can view notification announcements in the Console by default.
• If you are an existing Oracle customer who has been migrated to the Oracle Cloud Console, all the email contacts (email subscribers) set up in MyServices will continue to receive all emails by default. Any previously added preferences, such as language, time zone, and notification type in MyServices are not automatically migrated. The cloud account administrator, or someone with the "Administrator" role will need to add these preferences in the Cloud Console.

For customers who have had their environments converted to the Oracle Cloud Console, an announcement subscription is automatically created to preserve their notification preferences in the legacy console:

• General service anouncement subscription: <Service_Name>_Service_Announcements_Converted_Announcement_Subscription

To allow other users in your organization to view notification announcements in the Console, an administrator must add them to a group with the following permission granted in a policy:

Allow group '<identity-domain-name'/'<your-group-name>' to read announcements in tenancy

A user with this permission can navigate to the Announcements page in the Console to view the details of the notifications. For more information about setting up groups and policies for your Applications, see Managing User Access to Applications Environments.

To enable other users in your organization to receive notifications via email or other channels (such as SMS), an administrator must create a subscription and add the user information to the subscription.

To create a subscription, you need the following additional policy permissions:

Allow group '<identity-domain-name'/'<your-group-name>' to manage announcement-subscriptions in tenancy
Allow group '<identity-domain-name'/'<your-group-name>' to manage ons-topics in tenancy

Allow group '<identity-domain-name'/'<your-group-name>' to read announcements in tenancy

1. In the Console, select the Announcements icon () on the top bar. The Overview page displays.
2. Select Announcements to display all announcements for your tenancy. Select the applicable compartment, or the root compartment.
3. To refine the list, you can:
   • Filter by start and end date
   • Filter by Platform and Service. Select your service to view only announcements pertaining to your applications.
   • Select a tab to filter by notification type. For example, you can click Scheduled Maintenance to filter the list to only the scheduled maintenance notifications.

For more details about working with Announcements, see Console Announcements.

This task describes how to create an email subscription. For information about other options, see Console Announcements.

To create an email subscription for Applications announcements:

1. In the Console, click the Announcements icon () on the top bar. The Overview page displays.
2. Click Subscriptions and then click Create announcement subscription.
3. Enter a Name for the subscription. Avoid entering confidential information.
4. Optionally, enter a Description. Avoid entering confidential information.
5. Accept the default Compartment, or select the compartment where you want to create the subscription.
6. Select Selected announcements only.
7. Define the Filter group:
   • Filter group name: enter a name, for example, "Applications-Notifications".
   • Type: select Service.
   • Value: select your application name.

   These selections will include all announcements regarding your selected application. To include only maintenance-related announcements, add another filter:

   • Click +Another filter.
   • Type: select Announcement type.
   • You can add multiple selections for Value. Select the following to include all maintenance announcements Scheduled maintenance, Emergency maintenance, Emergency maintenance extended, Emergency maintenance complete, Emergency maintenance rescheduled.
8. Maintenance Notification Announcements use UTC and English as the default time zone and language. If you wish to change these, under Display preferences, select the preferred Time zone for announcement time stamps and the preferred Language.
9. Define the Notifications topic:
   • Select Create new topic.
   • Accept the default Compartment, or select the compartment where you want to create the topic.
   • Enter a Name for the topic. Avoid entering confidential information.
   • Optionally, enter a Description. Avoid entering confidential information.
   • Subscription protocol: select Email.
   • Email address: enter the email address of the person to receive the email notifications. To add multiple people or addresses, click +Another subscription.
10. Click Create.

To add more users to a subscription, like the one you created above, you must create a subscription for the user in the notification topic, as follows:

1. In the Console, click the Announcements icon (). The Overview page displays.
2. Click Subscriptions, The list of subscriptions is displayed. Click the name of the subscription to add the user to.
3. On the subscription detail page, click the Notification topic.
4. On the notification topic details page, click Create Subscription, then enter the following:
   • Protocol: select Email. For information about the other protocol options, see Creating a Subscription.
   • Email address: enter the email address of the person to receive the email notifications.
   • Click Create.

A confirmation email is sent to the email address entered. The recipient must click the Confirm subscription link in the email to activate the subscription.

After provisioning your environment, you can do the following:

• Add or delete subscribers
• Change the Announcement subscription filter. See Adding a Filter Group to an Existing Subscription in the Notifications documentation for more information.
• Update and delete the topic. See Managing Topics in the Notifications documentation for more information.

As an administrator, you can subscribe to multiple topic subscriptions. During environment creation (or conversion, if your environments were converted), you can be added to multiple Announcements subscriptions that are created by default. This may result in duplicate notifications. If you are receiving duplicate notifications for the same environment and want to unsubscribe from the duplicate topics, you can do the following:

1. Review the emails associated with the environment and note down the following details:
   • The environment name or system name found in the body of the notification.

     To ensure that a notification is a duplicate, it is important to verify the environment that it pertains to, as you may receive notifications for multiple environments (test, development, production) that can appear to be duplicates.

   • The topic name. Scroll down to the bottom of the email and you will see information similar to the following:

     

2. Note the topic names provided on the notifications that you suspect to be duplicates. If they are different, then decide which of the topics you want to remain subscribed to, and go to the next step. If they are the same, go to Removing Duplicate Subscriptions.
3. For the topic you want to unsubscribe from, click the unsubscribe link at the bottom of the email. The request to unsubscribe is confirmed.