You can log on to the DataWorks console and add a RAM user or a RAM role as an alert contact on the Alert Contacts page. DataWorks sends alert notifications to the alert contact if an alert is triggered based on the alert rule you configured for nodes. This allows the alert contact to handle exceptions at the earliest opportunity. This topic describes how to configure and view alert contacts.

Prerequisites

A RAM user or a RAM role is created and added to a DataWorks workspace. For more information about how to create a RAM user or a RAM role, see Create a RAM user and RAM role overview. For more information about how to add a RAM user or a RAM role to a DataWorks workspace, see Add workspace members and assign roles to them.

Precautions

  • When you specify the mobile phone number of an alert contact, you must add a country code before the mobile phone number. For example, you must specify a mobile phone number in the Chinese mainland in the format of 86139********.
  • Only Alibaba Cloud accounts, RAM users to which the AliyunDataWorksFullAccess policy is attached, tenant administrators, or tenant security administrators can configure information about alert contacts. They can also customize permissions of a custom role, grant roles the permissions to view alert resources, specify the maximum number of alert notifications that can be sent per day, and view the permissions of an alert contact. For more information, see Create a custom policy.
  • If the email address is invalid, the system sends an alert notification to the alert contact that you configured on the Manage Contacts page. You can click Manage Contacts in the upper-right corner of the Common Settings page of your Alibaba Cloud account to go to this page. The alert contact is also the person who receives notifications such as those related to product overdue payment, suspension, and imminent release. In this case, the alert contact that you configured on the Alarm contact page in the DataWorks console cannot receive the alert notification.

Go to the Alert Contacts page

  1. Go to the SettingCenter page.
  2. In the left-side navigation pane, choose Alerts > Alert Contacts to go to the Alert Contacts page of the current logon account.
    On the Alert Contacts page, you can specify a RAM user or a RAM role as an alert contact. If an error occurs during the running of a node, DataWorks sends alert notifications to the alert contact that you specified by phone call or email. This allows the alert contact to handle exceptions at the earliest opportunity. For more information about how to specify a RAM user as an alert contact, see Specify a RAM user as an alert contact. For more information about how to specify a RAM role as an alert contact, see Specify a RAM role as an alert contact.

Specify a RAM user as an alert contact

On the RAM User tab, you can view all the RAM users of the current logon account, including the display names, mobile phone numbers, and email addresses of the RAM users. If no mobile phone number or email address is specified for a RAM user, None is displayed in the mobile phone number or email address column for the RAM user. In this case, the RAM user is not added as an alert contact and DataWorks does not send an alert notification to the RAM user if a monitoring task generates an alert.

If you want to add a RAM user as an alert contact, perform the following steps:

Synchronize information about multiple alert contacts in Resource Access Management (RAM) to DataWorks at a time

If the contact information about RAM users of the current logon account has been configured in the RAM console, you can click Synchronize Contact Information of RAM Users to overwrite all the custom contact information on the RAM User tab with the contact information that you configured for the RAM users. For information about how to view and modify the contact information that is configured for RAM users, see Use a RAM user to log on to the DataWorks console and use DataWorks.
Note
  • The synchronization overwrites the personal information about alert contacts in DataWorks that you maintained.
  • You must configure valid contact information for RAM users in the RAM console. Otherwise, the contact information of the RAM users cannot overwrite the custom contact information of the RAM users in DataWorks.
  • If all the alert contact information in the current workspace is synchronized from the RAM console, Synchronize Contact Information of RAM Users is dimmed.

Maintain contact information of DataWorks alert contacts in DataWorks

Specify the mobile phone number or email address of an alert contact.

  1. On the RAM User tab, find the RAM user for which you want to configure contact information and click Edit in the Actions column.
  2. In the Configure Alert Contact dialog box, configure the Phone Number and Email Address parameters.
    Note You can configure both or either of the Phone Number and Email Address parameters based on your business requirements. DataWorks then sends alert notifications by using the method that you specified if an alert is generated.
    Configure Alert Contact dialog box
  3. Click Confirmation. The contact information is added.
    After you add the contact information, the status of the contact information changes to Waiting for Activation. You must activate the contact information for the contact information to take effect. Status change
  4. Activate the contact information.
    After you configure the Phone Number or Email Address parameter for an alert contact, you will receive a text message or an email. You must activate the contact information by following the instructions in the text message or email. The contact information takes effect only after you activate it.
    Note
    • The configured mobile phone number or email address takes effect only after you activate them.
    • The activation link in the text message or email that you received is valid for 24 hours. Check the text message or email to activate the contact information within 24 hours.

Specify a RAM role as an alert contact

On the RAM Role tab, you can view the list of RAM roles within the current logon account that are added to the selected workspace. In the list, you can view the information about the RAM roles, such as the role name, mobile phone number, and email address. If no mobile phone number or email address is configured for a RAM role, None is displayed in the Mobile phone number or Mailbox column for the RAM role. In this case, the RAM role is not added as an alert contact and DataWorks does not send an alert notification to the RAM role even if a monitoring task generates an alert.

RAM role

If you want to add a RAM role as an alert contact, perform the following steps:

Maintain contact information of DataWorks alert contacts in DataWorks

Specify the mobile phone number or email address of an alert contact.

  1. On the RAM Role tab, find the RAM role for which you want to configure contact information and click Edit in the Actions column.
  2. In the Configure Alert Contact dialog box, configure the Phone Number and Email Address parameters.
    Note You can configure both or either of the Phone Number and Email Address parameters based on your business requirements. DataWorks then sends alert notifications by using the method that you specified if an alert is generated.
    Configure Alert Contact dialog box
  3. Click Confirmation. The contact information is added.
    After you add the contact information, the status of the contact information changes to Waiting for activation. You must activate the contact information to make it take effect. Activation method
  4. Activate the contact information.
    After you configure the Phone Number or Email Address parameter for an alert contact, you will receive a text message or an email. You must activate the contact information by following the instructions in the text message or email. The contact information takes effect only after you activate it.
    Note
    • The configured mobile phone number or email address takes effect only after you activate them.
    • The activation link in the text message or email that you received is valid for 24 hours. Check the text message or email to activate the contact information within 24 hours.