diff --git a/images/cloud/reference/billing/spend-alerts-actions.png b/images/cloud/reference/billing/spend-alerts-actions.png new file mode 100644 index 00000000..af3daf42 Binary files /dev/null and b/images/cloud/reference/billing/spend-alerts-actions.png differ diff --git a/images/cloud/reference/billing/spend-alerts-config.png b/images/cloud/reference/billing/spend-alerts-config.png new file mode 100644 index 00000000..763a7fd3 Binary files /dev/null and b/images/cloud/reference/billing/spend-alerts-config.png differ diff --git a/products/cloud/navigation.json b/products/cloud/navigation.json index 9113915d..ebc7d763 100644 --- a/products/cloud/navigation.json +++ b/products/cloud/navigation.json @@ -158,6 +158,7 @@ }, "products/cloud/reference/billing/network-data-transfer", "products/cloud/reference/billing/payment-thresholds", + "products/cloud/reference/billing/spend-alerts", "products/cloud/reference/billing/managing-payment-methods", "products/cloud/reference/billing/billing-compliance" ] diff --git a/products/cloud/reference/billing/index.mdx b/products/cloud/reference/billing/index.mdx index c2beb231..d1487498 100644 --- a/products/cloud/reference/billing/index.mdx +++ b/products/cloud/reference/billing/index.mdx @@ -12,5 +12,6 @@ This section of the documentation covers topics related to billing, and contains |---------------------------------------|----------------------------------------------------------------------| | [Overview](/products/cloud/reference/billing/billing-overview) | Pricing examples and FAQs for billing. | | [Payment Thresholds](/products/cloud/reference/billing/payment-thresholds) | Learn more about how payment thresholds work and how to adjust them. | +| [Spend Alerts](/products/cloud/reference/billing/spend-alerts) | Configure spend alerts to monitor usage against thresholds within a billing period. | | [Troubleshooting Billing Issues](/products/cloud/reference/billing/billing-compliance) | Troubleshoot common billing issues. | | [Marketplace](/products/cloud/reference/billing/marketplace) | Landing page for further marketplace related topics. | diff --git a/products/cloud/reference/billing/spend-alerts.mdx b/products/cloud/reference/billing/spend-alerts.mdx new file mode 100644 index 00000000..7913cd48 --- /dev/null +++ b/products/cloud/reference/billing/spend-alerts.mdx @@ -0,0 +1,67 @@ +--- +sidebarTitle: 'Spend alerts' +slug: /cloud/manage/billing/spend-alerts +title: 'Configure organization spend alerts' +description: 'Configure spend alerts to monitor ClickHouse Cloud usage against thresholds within a billing period.' +keywords: ['billing', 'spend alerts', 'usage thresholds', 'notifications', 'cost monitoring', 'organization billing'] +doc_type: 'guide' +--- + +import { Image } from "/snippets/components/Image.jsx"; + +Spend alerts notify you when your organization's usage reaches configured thresholds within a billing period, so you can avoid unexpected charges. They send notifications only; for thresholds that trigger automatic invoicing, see [Payment thresholds](/products/cloud/reference/billing/payment-thresholds). + +## Prerequisites {#prerequisites} + +- You must have an **Organization Admin** or **Billing Admin** role to configure and view spend alerts. + +## How spend alerts work {#how-spend-alerts-work} + +- Alerts are based on gross usage within a billing period and reset at the start of each new cycle. +- Alerts fire every hour, based on the gross usage calculated at that time, so an alert fires after a threshold is exceeded. + + +**Spend alerts don't cap usage** + +Reaching 100% of your spend alert doesn't restrict or cap your usage — spending continues to accumulate beyond the 100% threshold. + + +## Set up a spend alert {#set-up-spend-alert} + + + +### Open the spend alerts dialog {#open-spend-alerts-dialog} + +1. Navigate to **Organization > Billing** in the ClickHouse Cloud console. +2. Click **Actions > Add spend alerts**. + +Billing page with the Actions menu open and Add spend alerts highlighted + + +### Configure and save the alert {#configure-and-save} + +1. Enter a spend alert amount in dollars or credits per billing period. +2. Select your notification channels: **Email**, **UI**, and/or **Slack**. +3. Click **Save**. + +Organization spend alerts dialog with spend limit, automatic threshold alerts, and notification channels + + + +## Automatic threshold alerts {#threshold-alerts} + +Three alerts are automatically created and triggered based on your configured spend alert amount: + +| Threshold | Trigger | Example ($10 alert) | +|-----------|---------------------------------|---------------------| +| **50%** | Half of spend reached | $5 | +| **75%** | Three-quarters of spend reached | $8 | +| **100%** | Full spend reached | $10 | + +## Notification channels {#notification-channels} + +| Channel | Description | +|-----------|--------------------------------------------------------------------------------------------| +| **Email** | Sends alerts to the configured email address. Click the edit icon to change the recipient. | +| **UI** | Displays alerts in the ClickHouse Cloud console. | +| **Slack** | Sends alerts to a Slack channel. Click the edit icon to configure. |