All Products
Search
Document Center

DataWorks:Configure and view alert contacts

Last Updated:Dec 05, 2024

You can configure a RAM user or RAM role as an alert contact on the Alarm Contact page in the DataWorks console. This way, if an alert rule is triggered by a task, DataWorks sends alert notifications in a related language, such as Chinese or English, to the configured alert contact. This can help the alert contact identify and handle the related issue at the earliest opportunity. You can also configure an alternate alert contact. If alert notifications cannot be sent to the alert contact that you configure, DataWorks automatically sends alert notifications to the alternate alert contact. This topic describes how to configure and view alert contacts.

Precautions

  • Configuration description

    • When you configure a mobile phone number for an alert contact, you must add a country code before the mobile phone number. For example, 86139******** is a mobile phone number in the Chinese mainland.

    • If the email addresses and mobile phone numbers that you configure for the alert contact and alternate alert contact are incorrect, DataWorks automatically sends alert notifications to the contact that is configured for your Alibaba Cloud account in the Product Overdue Payment, Suspension, and Imminent Release Notifications row on the Common Settings page in the Message Center console. In this case, the alert contact and alternate alert contact that you configure in DataWorks cannot receive alert notifications.

    • The alert language that you configure in Management Center is applied to Operation Center. When an alert rule is triggered, Operation Center sends an alert text message or email in this language.

  • Permission description

    Only an Alibaba Cloud account, a RAM user that is attached the AliyunDataWorksFullAccess policy, a tenant administrator, or a security administrator can configure information about an alert contact. You can also create a custom role, and grant the role the permissions to view alert resources and alert contacts and the permissions to specify the maximum number of alert notifications allowed per day. For more information, see Create a custom policy.

  • Description of contact information update

    If the contact information of the alert contact is changed but not updated in DataWorks, you must log on to the DataWorks console by using the account of the alert contact and update the information.

Prerequisites

A RAM user or a RAM role is created and added to a DataWorks workspace.

Go to the Alarm Contact page

  1. Go to the Management Center page.

    Log on to the DataWorks console. In the top navigation bar, select the desired region. In the left-side navigation pane, choose More > Management Center. On the page that appears, select the desired workspace from the drop-down list and click Go to Management Center.

  2. In the left-side navigation pane, choose Alarm Settings > Alarm Contact to go to the Alarm Contact page.

    On this page, you can configure a RAM user or RAM role as an alert contact. This way, if an error occurs on a task and triggers an alert rule, DataWorks sends alert notifications in a related language, such as Chinese or English, to the mobile phone number or email address of the alert contact. This helps the alert contact identify and handle the related issue at the earliest opportunity. You can also configure an alternate alert contact. If alert notifications fail to be sent to the configured alert contact, DataWorks automatically sends alert notifications to the alternate alert contact.

Configure a RAM user as an alert contact

On the RAM sub-account tab of the Alarm Contact page, you can view the RAM users that are added to the current workspace by using the logon account, and the display names, mobile phone numbers, and email addresses of the RAM users. If no mobile phone number or email address is displayed in the Mobile phone number column or the Mailbox column of a RAM user, the RAM user is not configured as an alert contact.

You can use one of the following methods to configure RAM users as alert contacts.

Synchronize contact information configured for RAM users from the RAM console to DataWorks

If the contact information of RAM users that are added to the current workspace by using the logon account is configured in the RAM console, you can click Synchronous access control (RAM) contact information to use the contact information in the RAM console to overwrite the contact information of the RAM users on the Alarm Contact page in the DataWorks console. For information about how to view or modify the contact information of a RAM user, see Use a RAM user to log on to the DataWorks console and use DataWorks.

Note
  • The contact information of multiple RAM users on the Alarm Contact page is overwritten at a time.

  • You must make sure that the contact information you configure for the RAM users in the RAM console is valid. If no contact information is configured for a RAM user or the configured contact information is invalid, the contact information of the RAM user on the Alarm Contact page cannot be overwritten.

  • If the contact information of all the RAM users added to the current workspace is synchronized from the RAM console, the Synchronous access control (RAM) contact information button is dimmed.

Configure contact information for RAM users in the DataWorks console

You can configure contact information (mobile phone numbers or email addresses) for RAM users that you want to use as alert contacts on the Alarm Contact page in the DataWorks console based on your business requirements.

  1. On the RAM sub-account tab of the Alarm Contact page, find the RAM user for which you want to configure contact information and click Edit in the Operation column.

  2. In the Configure Alert Contact dialog box, configure the Mobile Phone Number, Email Address, and Alarm Language parameters.

    You can select Chinese, English, or Automatic for the Alarm Language parameter.

    Note

    If an overseas account uses a mobile phone number in the Chinese mainland to receive alert notifications, the account can receive only Chinese text messages.

    If you select Automatic for the Alarm Language parameter, the system matches the language based on the site at which you use the account to access the corresponding Alibaba Cloud logon page.

    • China site (aliyun.com): Chinese.

    • International site (alibabacloud.com) and other sites: English.

  3. Click Confirmation. The contact information is configured.

    After the contact information is configured, Wait for activation is displayed in the Mobile phone number and Mailbox columns on the Alarm Contact page. The contact information takes effect only after you activate it.状态该变

  4. Activate the contact information.

    If you configure your mobile phone number or email address for a RAM user, you will receive a text message or an email. You must click the link provided in the text message or email to activate the contact information.

    Note
    • The contact information that you configure can take effect only after you activate it.

    • The link that is provided in the text message or email is valid for 24 hours. We recommend that you check your text message or email and activate the contact information at the earliest opportunity.

Configure a RAM role as an alert contact

On the RAM Role tab of the Alarm Contact page, you can view the RAM roles that are added to the current workspace by using the logon account, and the mobile phone numbers and email addresses of the RAM roles. If no mobile phone number or email address is displayed in the Mobile phone number column or the Mailbox column of a RAM role, the RAM role is not configured as an alert contact.

To configure a RAM role as an alert contact, perform the following steps:

  1. Find the RAM role that you want to configure as an alert contact and click Edit in the Operation column.

  2. In the Configure Alert Contact dialog box, configure the Mobile Phone Number, Email Address, and Alarm Language parameters.

    You can select Chinese, English, or Automatic for the Alarm Language parameter.

    Note

    If an overseas account uses a mobile phone number in the Chinese mainland to receive alert notifications, the account can receive only Chinese text messages.

    If you select Automatic for the Alarm Language parameter, the system matches the language based on the site at which you use the account to access the corresponding Alibaba Cloud logon page.

    • China site (aliyun.com): Chinese.

    • International site (alibabacloud.com) and other sites: English.

  3. Click Confirmation. The contact information is configured.

    After the contact information is configured, Wait for activation is displayed in the Mobile phone number and Mailbox columns on the Alarm Contact page. The contact information takes effect only after you activate it.RAM角色激活联系方式

  4. Activate the contact information.

    If you configure your mobile phone number or email address for a RAM user, you will receive a text message or an email. You must click the link provided in the text message or email to activate the contact information.

    Note
    • The contact information that you configure can take effect only after you activate it.

    • The link that is provided in the text message or email is valid for 24 hours. We recommend that you check your text message or email and activate the contact information at the earliest opportunity.

Configure an alternate alert contact

If the contact information that you configure for the alert contact is invalid, alert notifications will fail to be sent to the alert contact. In this case, DataWorks automatically sends alert notifications to an alternate alert contact that you configure. You can configure a RAM user or RAM role in the current workspace as an alternate alert contact.

image

References

For more information about how to configure alert rules for a task, see Overview.