All Products
Search
Document Center

ActionTrail:Configure alert rules for ActionTrail events

Last Updated:Feb 11, 2026

You can configure alert rules in ActionTrail to automatically monitor for specific events and send notifications when those events occur. This helps you respond quickly to potential security, threats or non-compliant activities in your Alibaba Cloud account.

Prerequisites

Before you can create alert rules, you must complete the following:

Important

The alerting feature uses SLS, which incurs costs for data storage, queries, and notifications. For more information, see SLS billing overview.

Step 1: Create an alert rule

You can create an alert rule from a predefined template for common use cases or create a custom rule for specific needs.

Create an alert rule from a template

ActionTrail provides templates for common security events, such as a change to a VPC network route.

  1. Log on to the ActionTrail console.

  2. In the left-side navigation pane, click Alerts.

  3. On the Alert Rules tab, click the arrow next to Create Alert and choose Create from Template.

  4. Find the template you want to use (such as VPC Network Route Change Alert) and click it.

  5. In the panel that appears, click OK.

    The alert rule is created and enabled automatically. You can see its status is Running on the Alert Rules tab.

Create a custom alert rule

For advanced use cases, you can create a custom alert rule with your own query and conditions. On the Alert Rules tab, click Create Alert. For detailed instructions, see Create a custom alert rule.

Step 2: Configuring notification settings (Optional)

You can customize how you receive alert notifications by creating contacts, notification templates, and action policies.

Creating contacts and contact groups

You can add individual users as contacts and organize them into contact groups to receive notifications.

  1. To create a contact:

    1. Log on to the ActionTrail console.

    2. In the left-side navigation pane, click Alerts.

    3. Navigate to Notification Objects > User Management and click Create.

    4. In the Create User dialog box, enter the user's details, such as ID, name, phone number, and email address, then click OK.

  2. To create a contact group:

    1. Navigate to Alerts > Notification Objects > User Group Management and click Create.

    2. In the Add User Group dialog box, enter an ID and name, select the users to add to the group, and click OK.

Creating notification templates

ActionTrail uses a default template for alert notifications. You can create custom templates to control the format and content of notifications sent via different channels, such as email, SMS, or Slack.

  1. Log on to the ActionTrail console.

  2. In the left-side navigation pane, click Alerts.

  3. Navigate to Notification Management > Alert Template and click Create.

  4. In the Add Alert Template dialog box, enter an ID and name.

  5. For each notification method (such as email, Slack, and Webhook), define the language, subject/title, and content. You can use template variables to include dynamic data from the alert.

  6. Click Confirm.

Creating action policies

Action policies control how notifications for an alert rule are routed and throttled. ActionTrail provides several built-in action policies. You can create custom ones. You can define conditions to send different notifications to different contact groups based on the alert's content.

  1. Log on to the ActionTrail console.

  2. In the left-side navigation pane, click Alerts.

  3. Navigate to Notification Management > Action Policy and click Create.

  4. In the Add Action Policy dialog box, enter an ID and name.

  5. Configure the policy logic by adding Condition and Action Group nodes.

    1. Define one or more conditions to match specific alerts. For example, create a condition that matches alerts where the Alibaba Cloud Account ID is 123456789012****.

    2. Define an action group that specifies the notification method (such as email), the notification template, and the contact group to notify when the conditions are met.

    3. Click Confirm.

References