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
AliyunDataWorksFullAccesspolicy, 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.
For information about how to create a RAM user and a RAM role, see Create a RAM user and RAM role overview.
For information about how to add a RAM user or RAM role to a DataWorks workspace, see Add workspace members and assign roles to them.
Go to the Alarm Contact page
Go to the Management Center page.
Log on to the DataWorks console. In the top navigation bar, select the desired region. Then, click Management Center in the left-side navigation pane. On the page that appears, select the desired workspace from the drop-down list and click Go to Management Center.
In the left-side navigation pane, choose 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.
For information about how to configure a RAM user as an alert contact, see the Configure a RAM user as an alert contact section in this topic.
For information about how to configure a RAM role as an alert contact, see the Configure a RAM role as an alert contact section in this topic.
For information about how to configure an alternate alert contact, see the Configure an alternate alert contact section in this topic.
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.
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.
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.
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.
NoteIf 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.
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.
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.
NoteThe 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:
Find the RAM role that you want to configure as an alert contact and click Edit in the Operation column.
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.
NoteIf 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.
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.
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.
NoteThe 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.
References
For more information about how to configure alert rules for a task, see Overview.