Skip to main content

Configuring Instance Notifications (Beta)

note

Configuring notifications for customer instance changes is in public Beta. Features and functionality are subject to change as we continue to iterate this functionality towards General Availability.

Notifications can help catch problems before they happen and let you proactively contact customers to prevent support cases. For example, you can be notified of a degraded status and you can contact your customer about fixing it before the instance goes down. This approach can make issues quicker and easier to solve, and improve the customer experience with less down time.

For more information about how application status is determined, see Resource Statuses in Enabling and Understanding Application Status. For all instance events that may trigger notifications, see Types of Events in About Instance and Event Data.

Teams can receive notifications about customer instances through a Slack channel. Individual users can also receive email notifications.

Instance notifications can be disabled when they are no longer needed. For example, a team member can turn off their email notifications for a customer instance when they are no longer responsible for supporting that customer.

Prerequisite

For Slack notifications, you must configure a Slack webhook in the vendor portal at the Team level before you can turn on instance notifications. For more information, see Configuring a Slack Webhook (Beta).

For email notification, no prior configuration is required. The email address listed in your vendor portal account settings is used.

Configure Notifications

Follow this procedure to configure Slack or email notifications for one or more customer instances. You can enable notifications for the application status only, for all changes on the instance, or disable notifications as needed.

To configure notifications:

  1. Go to Applications > Customers, and click an active customer instance that you want to receive notifications for.

    Customer instances list in the vendor portal
  2. On the Instance Details page, click Notifications.

  3. From the Configure Instance Notifications dialog, select the Slack Notifications tab or use the default My Notifications tab for email notifications.

  4. Select one of the following options:

    • App Changes: Sends notifications for application health status changes.
    • All Changes: Sends notifications for all instance changes, including version changes and Kubernetes upgrades.
    • None: Turns off notifications.
  5. Click Save My Notifications.

  6. Repeat these steps for every instance that you want to receive or manage notifications for.

Test Notifications

After you enable notifications for a running development instance, test that your notifications are working as expected.

Do this by forcing your application into a non-ready state. For example, you can delete one or more application Pods and wait for a ReplicationController to recreate them.

Then, look for notifications in the assigned Slack channel. You also receive an email if you enabled email notifications.

note

There is a 30-second buffer between event detection and notifications being sent. This buffer provides better roll-ups and reduces noise.