Notifications for Confluent Cloud

You can manage notifications for account, billing and service events with the Confluent Cloud Console or with a REST API. Additionally you can configure how you are notified for some of the notification types. For Required and Recommended notification types, notifcations are sent by email to the organization’s administrator or if using RBAC, a user with the OrganizationAdmin role by default. All other RBAC roles have read-only access to notifications.

For notifications, you should understand the following terms:

• Notification type: The type of notification based on the Confluent Cloud event that has occured. Each notification type defines a condition that must be met, and they are categorized by Account, Billing and Licensing, and Service, and they can be filtered by by severity level. For example, a Dedicated cluster shrink failure is a warning-level service notification type.
• Integration: Describes the configured notification channel for sending a notification event: Email, Microsoft Teams, Slack or a generic Webhook. The default integration is email, and notifications are sent to the organization’s admin or if using RBAC, users that have the OrganizationAdmin role.
• Subscription: Represents the association of a notification type to an integration channel. A customer creates subscriptions for a particular notification type and as a result is notified through the integration channels they have configured for that subscription. By default, Required and Recommended notification types are subscribed to an email integration and emails are sent to email addresses for organization admins associated with the account.

You can view the current notification subscriptions and configure additional integrations and subscriptions to those integrations using the Confluent Cloud Console or a REST API. For example, you can configure a Slack integration, and then subscribe to this integration for a Kafka cluster shrink failure notification type.

See a list of subscriptions

You can view the your notification integrations and subscriptions in the Cloud Console or by making a GET call to the REST API.

Cloud ConsoleREST API

To see a list of notification subscriptions and integrations you have currently configured access the Manage notifications page by clicking the Alert bell icon in the upper right of the console.

Subscriptions can filtered by:

• Category
• Severity level
• Integration
• Whether the subscription is Enabled or not

Configure integrations and subscriptions

You can configure Slack, Microsoft Teams or generic webhook integrations for some notification types if you are an organization admin, or if using RBAC, you have OrgAdmin access to the Confluent Cloud account.

To configure an integration and subscribe to a notification type for that integration:

Cloud ConsoleREST API

1. Sign in to Confluent Cloud, and click the Alert bell icon to display the Manage notifications page.

2. Hover on a notification type, and click the edit icon.

   

   Important

   Some notifications are not configurable. In these cases, the edit icon does not appear.

3. Check to enable or uncheck to disable the subscriptions. You can also configure a new integration.

   • Email - Enter one or more roles or users to receive notification emails. Email will be checked by default for Recommended and Required notification types, and the OrganizationAdmin role configured by default to receive emails.
   • Webhook - To add a new integration, click Add a webhook URL and enter a Name for the integration and the Webhook URL.

   The webhook will receive messages in the following format:

   {
      id: string [required]
      title: string
      message: string
      created_at: string
   }
   

   • Slack - To add a new integration, click add a slack URL and enter a Name for the integration, such as the channel or team name that will receive the notification, and the Slack URL.
   • Microsoft Teams - To add a new integration, click add a Microsoft Teams URL and enter a Name for the integration, such as the channel or team name that will receive the notification, and the Microsoft Teams URL.
   

4. Click Verify for each URL you enter, and Confluent Cloud will send a test message to the URL. Once a URL is verified, you can click Save to save the integration, and check it to add a subscription using that integration.

   If the URL cannot be verified, you cannot save your changes.

5. Once you have selected integrations and successfully added and selected a URL for each integration, under Test and Finish. Click Update to save your changes.