Use Webhook callbacks to receive alert notifications at a custom URL, allowing you to build automated monitoring and response workflows. This guide walks you through the configuration and testing process.

Configuration Steps

1. Create an Alert Rule

To use the Webhook feature, you must first create an alert rule that will trigger the notification.

1. Go to Cloud Monitor → Alert Service → Alert Rules.
2. Click Create Alert Rule.
3. Set the rule name and define the alert conditions.
4. In the Notification Method section, select Webhook Callback.

2. Configure the Webhook URL

When creating the alert rule, you need to specify the destination URL for the Webhook callback.

1. Enter the URL where you want to receive alert notifications. Make sure this is a publicly accessible URL and that your server is configured to handle POST requests.
2. Save your changes.

Note: Your Webhook endpoint must be able to correctly parse and respond to POST requests from the Cloud Monitor system to avoid notification failures.

Testing the Webhook Callback

To confirm that your configuration is correct, perform a test.

1. Click the Test button next to the Webhook URL input field. This simulates an alert and sends a test payload to your URL.
2. Verify that your endpoint received the test payload from the monitoring system.

The callback is sent as a POST request containing a JSON body with the following parameters. Make sure your endpoint can handle additional parameters, as new fields may be added in the future.

Here is an example of the JSON payload your endpoint will receive:

{
  "loginName": "user@example.com",
  "alarmTime": "2025-07-09T15:22:00Z",
  "ruleName": "High Bandwidth Alert",
  "monitor": "Total bandwidth exceeded 100Gbps."
}

Parameter	Type	Description
loginName	string	The account name associated with the alert rule.
alarmTime	string	The timestamp when the alert was triggered.
ruleName	string	The name of the alert rule that was triggered.
monitor	string	The content or description of the alert.

If you do not receive the test notification, check your network connection and endpoint configuration to ensure they are working correctly.

Troubleshooting

If you are not receiving notifications, check the following common issues:

• Incorrect URL: Verify that the Webhook URL is correct and publicly accessible.
• POST Request Handling: Ensure your endpoint is configured correctly to handle POST requests and parse the JSON payload.
• Network Connectivity: Check whether firewall rules or network issues are blocking incoming requests from the monitoring system.

Once configured, your Webhook integration enables automated, real-time event notifications. You can then build custom logic to parse these alerts and trigger automated responses, significantly improving incident management efficiency.