Skip to content

Commit 43ae41b

Browse files
committed
Add cluster_name label requirement to GCP Cloud Monitoring docs
Alerts must include a cluster or cluster_name label for Robusta to properly route them. Added instructions for setting this via custom labels in the alerting policy's Documentation section.
1 parent d20f448 commit 43ae41b

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

docs/configuration/alertmanager-integration/gcp-monitoring.rst

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,9 @@ GCP Cloud Monitoring Integration with Robusta
44
.. note::
55
This feature is available with the Robusta SaaS platform and self-hosted commercial plans. It is not available in the open-source version.
66

7+
.. note::
8+
Every alert must carry a ``cluster`` or ``cluster_name`` label. Set it to the Robusta ``cluster_name`` configured for the target cluster, or use ``external`` when the alerts do not belong to a specific runner.
9+
710
This guide explains how to forward **GCP Cloud Monitoring alerts** to Robusta via a managed notification channel webhook.
811

912
Requirements
@@ -45,7 +48,12 @@ Step 3: Use the Webhook in Alerting Policies
4548
1. Navigate to **Monitoring -> Alerting -> Policies**.
4649
2. Create a new alerting policy or edit an existing one.
4750
3. In the **Notifications** section, select the **RobustaWebhook** notification channel.
48-
4. Save the alerting policy.
51+
4. **Add a cluster label** (required): In the policy's **Documentation** section, add a custom label:
52+
53+
- **Key**: ``cluster_name``
54+
- **Value**: Your Robusta cluster name (e.g., ``my-gcp-cluster``) or ``external`` for non-Kubernetes alerts
55+
56+
5. Save the alerting policy.
4957

5058
Validation
5159
----------

0 commit comments

Comments
 (0)