Send alert notifications to custom webhooks

Before you begin

• An EDAS application is deployed and running

• Access to the messaging platform where you want to receive alerts (Lark, WeChat, DingTalk, or any service that accepts HTTP callbacks)

Step 1: Get a webhook URL from Lark

If you already have a webhook URL from your messaging platform, skip to Step 2.

Create a custom bot in a Lark group and copy its webhook URL.

1. Open Lark and log in.

2. Click the + icon, then click New group to create a group for alert notifications.

3. Click the Settings icon, then click the BOTs tab.

4. On the BOTs tab, click Add Bot.

   

5. On the Add Bot page, select Custom Bot.

   

6. Enter a Bot name and Description, then click Add.

   

7. Click Copy next to Webhook URL, then click Save.

   

Save the copied URL for use in the next step.

Step 2: Create a webhook contact

1. Log on to the EDAS console.

2. On the Applications page, select a region in the top navigation bar and an option from the Microservice Namespace drop-down list. Select ECS Clusters from the Cluster Type drop-down list, then click the name of your application.

3. In the left-side navigation pane, choose Alert Management > Contact.

4. On the Notification Objects page, click the Webhook Integration tab, then click Create Webhook in the upper-right corner.

5. In the Create Webhook panel, configure the following settings.

{
  "msg_type": "text",
  "content": {
    "text": "Alert Name: {{ .commonLabels.alertname }} \n Alert Triggered At: {{ .startTime }} \n Alert Message: {{ for .alerts }} {{ .annotations.message }}  {{if .generatorURL }} Link to Details: {{.generatorURL}} {{ end }} \n {{ end }}"
  }
}

{
  "msg_type": "text",
  "content": {
    "text": "Alert Name: {{ .commonLabels.alertname }} \n Alert Cleared At: {{ .endTime }} \n Alert Message: {{ for .alerts }} {{ .annotations.message }}  {{if .generatorURL }} Link to Details: {{.generatorURL}} {{ end }} \n {{ end }}"
  }
}

{
  "Alert Name": "{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}",
  "Cluster Name": "{{ .commonLabels.clustername }} {{ end }}{{if eq \"app\" .commonLabels._aliyun_arms_involvedObject_kind }}",
  "Application Name": "{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}",
  "Notification Policy": "{{ .dispatchRuleName }}",
  "Alert Triggered At": "{{ .startTime }}",
  "Alert Message": "{{ for .alerts }} {{ .annotations.message }} {{ end }}"
}

Step 3: Link the webhook to a notification policy

Associate the webhook with a notification policy to start receiving alerts.

1. In the left-side navigation pane, click Notification Policy.

2. On the Notification Policies page, create or modify a notification policy:

   • Set Contacts to the webhook contact you created in Step 2.

   • Select WebHook for the Notification Methods parameter.

For details on notification policy configuration, see Create and manage a notification policy.

If the webhook endpoint does not respond within 5 seconds, the notification delivery fails.

Verify the result

After linking the webhook to a notification policy, trigger a test alert or wait for an actual alert to fire. A successfully delivered notification appears in your Lark group with the alert name, trigger time, and alert message.

Troubleshooting