Alert configuration objects define notification settings for various events within Cloud66. Alerts can be configured at the stack level or application group level, with support for multiple notification channels.
alert_namestringThe name of the alert to configure (e.g., "deployment_failed", "server_down", "deployment_success").
subscriptionsarrayArray of subscription channel configurations that define how and where notifications are sent.
Subscription Channels
Each subscription object in the subscriptions array supports different notification channels:
channelstringThe notification channel type. Supported values: "email", "slack", "webhook", "browser".
slack_urlstringRequired when channel is "slack". The Slack webhook URL for posting notifications.
webhook_urlstringRequired when channel is "webhook". The HTTP endpoint URL to receive webhook notifications.
Channel Types
- email: Basic email notifications sent to account users
- slack: Notifications posted to Slack channels via webhook integration
- webhook: HTTP POST notifications to custom endpoints
- browser: In-browser notifications displayed in the Cloud66 dashboard
Common Alert Types
- deployment_failed: Triggered when stack deployments fail
- deployment_success: Triggered when stack deployments succeed
- server_down: Triggered when servers become unavailable
- server_up: Triggered when servers come back online
- backup_failed: Triggered when backup operations fail
- backup_success: Triggered when backup operations succeed
Example
{
"alert_name": "deployment_failed",
"subscriptions": [
{
"channel": "email"
},
{
"channel": "slack",
"slack_url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
},
{
"channel": "webhook",
"webhook_url": "https://api.example.com/alerts"
}
]
}