On the Alert Contacts page, you can add a RAM user or a RAM role as an alert contact. After you configure an alert contact, an alert notification is sent to the alert contact if a node fails to run in DataWorks. The alert notification helps you identify and 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.

Limits

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 mainland China in the format of 86139********.

Go to the Alert Contacts page

  1. Log on to the DataWorks console.
  2. In the left-side navigation pane, choose Alerts > Alert Contacts.
  3. In the top navigation bar, select the region where your workspace resides 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 a node fails to run in DataWorks, an alert notification is sent to the mobile phone number or email address of the alert contact. This way, you can identify and 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 user as an alert contact.

Specify a RAM user as an alert contact

RAM userOn the RAM Users 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 column or the Email 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 even if a monitoring task generates an alert. If you want to add a RAM user as an alert contact, perform the following steps:
  • Customize the contact information.

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

    1. On the RAM Users tab, find the RAM user for which you want to configure contact information and click Edit in the Actions column.
    2. In the Set Alert Contact dialog box, set the Mobile Phone Number and Email Address parameters.
      Note You can set both or either of the Mobile Phone Number and Email Address parameters based on your business requirements. You can receive alert notifications by using the method that you specify.
      Set Alert Contact
    3. Click OK. 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 set the Mobile 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.
  • Synchronize the contact information that is configured for RAM users with one click.

    If the contact information about RAM users of the current logon account has been configured in the RAM console, you can synchronize the contact information about the RAM users to the RAM Users tab of the Alert Contacts page with one click.

    Click Synchronize Contact Information of RAM Users to overwrite all the custom contact information on the RAM Users tab with the contact information that you configured for the RAM users. For more information about how to view and modify the contact information that is configured for RAM users, see Use DataWorks as a RAM user.
    Note
    • You must configure valid contact information for RAM users.
    • If all the alert contact information in the current workspace is synchronized from the RAM console, the Synchronize Contact Information of RAM Users feature cannot be used.
  • Apply the configured contact information with one click.
    Click Apply All Contact Information with One Click to apply the contact information that you configured to node monitoring in Operation Center, quality rule monitoring in Data Quality, and approval process management in Security Center. If an alert is triggered for a monitoring task later on, an alert notification is sent by using the method that you specify.
    Note
    • Apply All Contact Information with One Click is available only when an alert contact is changed or the contact information of an alert contact is changed. For example, you can click Apply All Contact Information with One Click to use the latest alert contact information only after the mobile phone number of an alert contact is changed.
    • You must configure valid contact information for RAM users. Otherwise, the new contact information does not take effect.

Specify a RAM role as an alert contact

RAM RoleOn the RAM Role tab, you can view all the RAM roles of the current logon account, including the role names, mobile phone numbers, and email addresses of the RAM roles. If no mobile phone number or email address is configured for a RAM role, None is displayed in the Mobile Phone Number or Email column for the RAM role. In this case, the RAM role is not added as an alert contact. As a result, DataWorks does not send an alert notification to the RAM role even if a monitoring task generates an alert. If you want to add a RAM role as an alert contact, perform the following steps:
  • Customize the contact information.

    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 Set Alert Contact dialog box, set the Mobile Phone Number and Email Address parameters.
      Note You can set both or either of the Mobile Phone Number and Email Address parameters based on your business requirements. You can receive alert notifications by using the method that you specify.
      Set Alert Contact
    3. Click OK. 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. Activation method
    4. Activate the contact information.
      After you set the Mobile 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.
  • Apply the configured contact information with one click.
    Click Apply All Contact Information with One Click to apply the contact information that you configured to node monitoring in Operation Center, quality rule monitoring in Data Quality, and approval process management in Security Center. If an alert is triggered for a monitoring task later on, an alert notification is sent by using the method that you specify.
    Note
    • Apply All Contact Information with One Click is available only when an alert contact is changed or the contact information of an alert contact is changed. For example, you can click Apply All Contact Information with One Click to use the latest alert contact information only after the mobile phone number of an alert contact is changed.
    • You must configure valid contact information for RAM users. Otherwise, the new contact information does not take effect.