Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Alert Integrations for App Services

  • Capella App Services
  • concept
An alert integration lets Capella send metric-based notifications to a third-party tool.

Capella alert integrations are designed to integrate into your existing workflows, and centralize metrics-based alerts for operational clusters and App Services inside your projects. Metrics-based Capella alerts can include high disk IOPS usage and data encryption key rotation failures. All alert integrations are configured at the project level in your organization.

You can also view alerts in the Capella UI and receive them by email.

Alert integrations send only metrics-based alerts. Capella alert integrations do not send operational alerts, which are alerts caused by operational disruption.

When Capella flags an alert, it sends a JSON payload with structured alert data to a supported third-party tool. Capella applies a first-in, first-out queue to send 1 alert notification at a time. Typically, Capella sends alert notifications within milliseconds of creation. After Capella sends a notification, the third-party tool controls queuing and the timing of delivery via the connection method.

Supported Third-Party Tools

In Capella, you can configure a new alert integration with the following third-party tools:

Slack

Use a Slack alert integration to send Capella alerts to a Slack workspace. In Capella, you can:

  • Configure your alert payload with variables and static values to support your alerting needs. The template for Slack integrations uses the Slack Block Kit message format.

  • Connect to Slack with a bot token or webhook URL.

For more information about configuring a Slack alert integration, see Configure a Slack Alert Integration for App Services. For more information about Slack alert payloads, see Slack JSON Payload for App Services.

Microsoft Teams

Use a Microsoft Teams alert integration to send Capella alerts to a Microsoft Teams channel. In Capella, you can:

  • Configure your alert payload with variables and static values to support your alerting needs. The template for Microsoft Teams integrations uses the Adaptive Cards message format.

  • Connect to Microsoft Teams with a webhook URL.

For more information about configuring a Microsoft Teams alert integration, see Configure a Microsoft Teams Alert Integration for App Services. For more information about Microsoft Teams alert payloads, see Microsoft Teams JSON Payload for App Services.

Webhooks

Use a generic Webhooks alert integration to send Capella alerts to any third-party tool that supports webhooks. For example, you can send alerts to ServiceNow, an incident management tool.

Capella automatically configures a fixed alert payload structure that’s compatible with the webhook format. Connect to your third-party tool with a destination URL for the webhook, along with either basic or bearer token authentication and authorization.

For more information about configuring a Webhook alert integration, see Configure a Webhook Alert Integration for App Services. For more information about Webhook alert payloads, see Webhook JSON Payload for App Services.

Alert Payload

The notification message that an alert integration sends includes an alert payload in JSON format. The structure of your alert payload can vary depending on the third-party tool you’re integrating with:

  • When you configure a Slack or Microsoft Teams integration in Capella, you can customize the structure of your alert payload with an Advanced Template.

  • Webhooks alert integrations have a fixed payload structure that you cannot modify in Capella.

For more information about the alert payload structure for each supported third-party tool, including an example payload, see:

When you configure workflows in the receiving platform, you can refer to the alert payload to identify actionable values. Your third-party tool might use values in the payload to route, prioritize, or enrich messages from Capella. For example, you might use an alert’s severity field to automatically route high-severity alerts to the appropriate destination, such as a channel or assignment group.

Advanced Template

The Advanced Template is only available for Slack and Microsoft Teams integrations.

The Advanced Template option in the Capella UI includes a JSON editor for customizing your alert payload. Capella initializes the template with default variables. You can modify the template for your workflow requirements by customizing variables, static values, or the layout of the alert payload. A real-time preview displays a valid alert payload with placeholders that update as your template changes. Capella also validates your JSON formatting and flags any syntax issues.

For more information about how to customize your alert payload templates, see Add a Slack Alert Integration or Add a Microsoft Teams Alert Integration.

Next Steps

Configure your alert integration to send Capella metrics-based alerts to a third-party tool. To get started with:

For more information about monitoring your App Services, see