All Products
Search
Document Center

DataWorks:Perform basic O&M operations on auto triggered nodes

Last Updated:Oct 24, 2024

Auto triggered nodes are nodes that are periodically scheduled based on their scheduling configurations after they are committed to the scheduling system. You can view auto triggered nodes in a workspace and perform O&M operations on the desired auto triggered node in the list of auto triggered nodes on the Cycle Task page in Operation Center. For example, you can manually run or enable the scheduling system to automatically run the auto triggered node, view the details of the auto triggered node, or suspend or undeploy the auto triggered node. This topic describes the O&M operations that you can perform on an auto triggered node.

Usage notes

  • Auto triggered nodes can be automatically scheduled to generate instances only in Operation Center in the production environment. Auto triggered nodes cannot be automatically scheduled to generate instances in Operation Center in the development environment.
  • After you perform operations such as addition, modification, and undeployment on node code, scheduling configurations, resources, or functions in the production environment, you must commit and deploy the objects to make the configurations take effect.
  • After you modify an auto triggered node, you must deploy the node. After the node is deployed, the modification takes effect in the production environment. The following issues may occur when you deploy the node: The node fails to be deployed, the deployment process is blocked, or the version of the deployed node does not meet your requirements. In these cases, we recommend that you go to the Cycle Task page in Operation Center to troubleshoot issues. For more information, see View and manage auto triggered nodes.

Overview

The following table describes the O&M operations that you can perform on auto triggered nodes.
O&M operationDescription
View auto triggered nodesYou can view the details of an auto triggered node and perform operations on the node in the list of auto triggered nodes or in the directed acyclic graph (DAG) of the node on the Cycle Task page.
Run auto triggered nodes
  • Running modes: Nodes that are deployed to the production environment are scheduled to run at the points in time that you specify. You can view the node scheduling results on the Cycle Instance page in Operation Center. You can also test the nodes and backfill historical data or future data for the nodes in the production environment and view the node running results on the Patch Data and Test Instance pages in Operation Center.
  • Conditions for running an auto triggered node and issue troubleshooting: You must understand the conditions that must be met to run an auto triggered node and identify the related causes if the auto triggered node is not run.
  • Emergency O&M operations: If an ancestor node of an auto triggered node is not run and blocks the running of the auto triggered node, you can remove the dependency between the auto triggered node and the ancestor node. If data quality issues occur on multiple descendant nodes of an auto triggered node, you can forcefully rerun the auto triggered node and its descendant nodes.
Manage auto triggered nodes
  • Node deployment and node undeployment
    • Deploy an auto triggered node: Before you can view an auto triggered node on the Cycle Task page in Operation Center, you must deploy the node to the scheduling system in the production environment.
    • Undeploy an auto triggered node: If an auto triggered node does not need to be run, you can undeploy the auto triggered node. If auto triggered nodes in a specified workflow do not need to be run, you can undeploy the auto triggered nodes in the workflow at a time.
      Note After you undeploy an auto triggered node, the auto triggered node is moved to the recycle bin. You can restore the auto triggered node from the recycle bin.
  • Node management
    • Freeze an auto triggered node: If an auto triggered node and its descendant nodes do not need to be run for a specific period of time, you can freeze the auto triggered node.
    • Configure monitoring and alerting for an auto triggered node: You can find the auto triggered node that you want to monitor in the list of auto triggered nodes and configure a custom alert rule to monitor the status of the node or monitor the resource group used to run the node. You can also configure a data quality monitoring rule to monitor the table data generated by the auto triggered node.
    • Manage priorities of auto triggered nodes: You can use the baseline management feature to adjust the priority of an auto triggered node. Scheduling resources are preferentially allocated to nodes with higher priorities.
    • Change the resource group used to run an auto triggered node: You can modify the attributes that are related to the running of an auto triggered node. For example, you can change the resource group for scheduling or resource group for Data Integration that is used to run an auto triggered node.
    • Change the node owner: You can change the owners of multiple nodes at a time.
View operation records of auto triggered nodesYou can view the operation logs, versions, and operation history of an auto triggered node.

View auto triggered nodes

In the list of auto triggered nodes, you can view the auto triggered nodes that are committed and deployed to the scheduling system in the production environment. You can check whether the code, scheduling parameter configurations, scheduling dependencies, and lineage of the auto triggered nodes meet your business requirements. You can view the details of an auto triggered node and perform the related operations on the node in the list of auto triggered nodes or in the DAG of the node. For more information, see View and manage auto triggered nodes.
Note
  • Only the auto triggered nodes that are deployed to the production environment are displayed in the list of auto triggered nodes on the Cycle Task page in Operation Center.
  • The following types of nodes are not automatically scheduled: nodes that do not depend on other nodes and nodes that are used as the ancestor nodes of other nodes and depend on their descendant nodes.

Run auto triggered nodes

You can understand the modes in which nodes in DataWorks are run and perform O&M diagnostics based on the running situations of nodes in an efficient manner.

Running modes

DataWorks generates auto triggered node instances that are scheduled to run on the next day for an auto triggered node every night. You can click Backfill Data or Test in the Actions column of the auto triggered node to generate a data backfill instance or a test instance for the auto triggered node.
Instance typeScenarioRelationship with an auto triggered node

(How an instance is generated)

Instance trigger method

(How an instance is triggered to run)

Auto triggered node instancePeriodic extract, transform, and load (ETL) operations are required. Every night, DataWorks generates auto triggered node instances that are scheduled to run on the next day based on the snapshot information of an auto triggered node at a specific point in time.
Note Auto triggered nodes cannot be automatically scheduled to generate instances in Operation Center in the development environment.
DataWorks triggers an auto triggered node instance for running.
Data backfill instanceYou want to backfill data of a historical period of time or a period of time in the future for the current auto triggered node and its descendant nodes. This indicates that you must perform ETL operations on the data of that period of time. You must backfill data for the current auto triggered node to generate data backfill instances for the node. After you backfill data, the data backfill instances are generated and triggered to run.
Test an auto triggered task and view test instances generated for the taskYou want to test the current auto triggered node to check whether the node can be run as expected.
Note The code of the auto triggered node is run during the test.
You must test the current auto triggered node to generate test instances for the node. After you perform the test, the test instances are generated and triggered to run.

Conditions for running an auto triggered node and issue troubleshooting

Conditions for running an auto triggered node

An auto triggered node can be scheduled to run only when the following conditions are met: Ancestor nodes of the auto triggered node are successfully run, the scheduling time of the auto triggered node has arrived, scheduling resources are sufficient, and the auto triggered node is not frozen. For more information, see Prerequisites for an auto triggered node to successfully run. Flowchart

Troubleshooting for issues related to node running

Problem description and causes: The scheduling time of an auto triggered node arrives, but the node is not run. The possible causes of this issue may be that the ancestor nodes of the auto triggered node are still running until the scheduling time of the auto triggered node arrives, no sufficient resources can be used to run the auto triggered node, and the auto triggered node is frozen.

Solution: If an auto triggered node fails to run, you can use the upstream analysis feature provided in the DAG of the auto triggered node to quickly identify ancestor nodes that block the running of the auto triggered node. Then, you can use the intelligent diagnosis feature to diagnose failure causes or related issues of the ancestor nodes. The intelligent diagnosis feature can also be used to quickly troubleshoot issues when dependencies between the auto triggered node and its ancestor nodes are complex. This helps improve O&M efficiency. Upstream analysis featureFor more information, see Why is an auto triggered instance not run after its scheduling time arrives?, Nodes that are waiting for resources, and Node freezing and unfreezing.

Emergency O&M operations

  • If an auto triggered node depends on multiple ancestor nodes and one of the ancestor nodes is not run, you can find the instance generated for the auto triggered node on the Cycle Instance page, open the DAG of the instance, right-click the instance in the DAG, and then choose Emergency Operations > Delete Dependencies. In the Delete Dependencies with Parent Nodes dialog box, you can specify the name of the ancestor node that is not run to remove the dependency between the auto triggered node and the ancestor node.
    Note You must check whether this operation affects data output based on the code of the node for which the instance is generated and the lineage of the instance.
  • If data quality issues occur on multiple descendant nodes of an auto triggered node, you can find the instance generated for the auto triggered node on the Cycle Instance page, open the DAG of the instance, right-click the instance in the DAG, and then choose Emergency Operations > Force Rerun or choose Emergency Operations > Force Rerun Descendant Nodes to forcefully rerun the auto triggered node and its descendant nodes. For more information, see Appendix: Forcefully rerun the descendant instances of an auto triggered node instance.

Manage auto triggered nodes

Deploy auto triggered nodes

Before you can view an auto triggered node in the list of auto triggered nodes on the Cycle Task page in Operation Center, you must deploy the node to the scheduling system in the production environment. For more information, see Deploy nodes. Deploy an auto triggered node

Undeploy auto triggered nodes

If you no longer require an auto triggered node or a workflow, you can undeploy the node or all nodes in the workflow. After you undeploy an auto triggered node, you cannot find the node on the Cycle Task page. For more information, see Undeploy nodes.

Freeze auto triggered nodes

Important Do not perform operations on the projectname_root node, which is the root node of your workspace. All instances of auto triggered nodes in the workspace depend on this node. If this node is frozen, the instances of auto triggered nodes cannot be run.
OperationScenarioDescription
Freeze an auto triggered nodeIf an auto triggered node and its descendant nodes do not need to be run for a specific period of time, you can freeze the auto triggered node.
  • Freeze operation: In automatic scheduling scenarios, an auto triggered node can start to run only after all ancestor nodes of the node are successfully run. If one of the ancestor nodes is frozen, the running of the auto triggered node is blocked. If an auto triggered node and its descendant nodes do not need to be run for a specific period of time, you can freeze the root node in the workflow to which the auto triggered node belongs.
  • Impacts: After you freeze an auto triggered node, auto triggered node instances generated for the auto triggered node are also frozen, and the descendant instances of the auto triggered node instances cannot be run.
Freeze an instanceIf an instance generated for an auto triggered node does not need to be run, you can freeze the instance. The freeze operation takes effect only on the current instance. Other instances that are generated on the same day as the current instance and the instances that are generated later than the current day are not affected.
Set Recurrence to Dry Run for an auto triggered nodeIf an auto triggered node does not need to be run for a specific period of time, but you do not want the running of the descendant nodes of the node to be blocked, you can set the Recurrence parameter to Dry Run for the auto triggered node. The auto triggered node in the dry-run state generates dry-run instances. The system does not run the dry-run instances to generate data, does not generate run logs for the dry-run instances, and does not display running duration for the dry-run instances. Dry-run
Note The operation of setting the Recurrence parameter to Skip Execution for an auto triggered node on the DataStudio page achieves the same effect as the operation of freezing the auto triggered node in Operation Center. The modifications to an auto triggered node on the DataStudio page take effect only in the development environment. If you want the modifications to take effect in the production environment, you must deploy the auto triggered node to the production environment. For more information, see Deploy nodes.
Note For more information about the impacts of freezing or unfreezing an auto triggered node or auto triggered node instance, see Node freezing and unfreezing.

Manage node priorities

You can use the baseline management feature to adjust the priority of an auto triggered node in a baseline. Scheduling resources are preferentially allocated to the auto triggered nodes with higher priorities. For more information, see Manage baselines.

Configure monitoring and alerting for an auto triggered node

You can find the auto triggered node that you want to monitor and configure a custom alert rule and a data quality monitoring rule for the node.
  • You can configure a custom alert rule to monitor the status of an auto triggered node. For more information, see Manage custom alert rules.
  • You can configure a data quality monitoring rule for an auto triggered node to monitor the table data that is generated when auto triggered node instances, data backfill instances, or test instances generated for the node are run. For more information, see Overview.
  • You can configure a custom alert rule to monitor a resource group used to run an auto triggered node based on the number of instances that are generated for the node and waiting for resources in the resource group or based on the resource usage of the resource group. For more information, see Manage custom alert rules.

Change the resource group used to run an auto triggered node

DataWorks allows you to change the resource group for scheduling or resource group for Data Integration used to run an auto triggered node. For more information, see General reference: Change the resource groups used by tasks.
Note If you want to redefine scheduling properties of an auto triggered node, you can go to the DataStudio page, find the desired auto triggered node, and modify the configurations of the scheduling properties on the configuration tab of the auto triggered node. For more information, see Configure basic properties. You can also go to the batch operation tab to perform an operation on multiple auto triggered nodes at a time. For more information, see Perform operations on multiple DataWorks objects at a time.

Change the node owner

Before you can change the owner of a node, you must turn on Change Node Owner by RAM User. Turn on Change Node Owner by RAM User

After Change Node Owner by RAM User is turned on, the workspace administrator can perform the following operations:

  • Change the owner of a node or the owners of multiple nodes at a time on the DataStudio page.
    1. Change the owner of a node: The workspace administrator can change the owner of a node in the General section of the Properties tab on the DataStudio page.
    2. Change the owners of multiple nodes at a time: The workspace administrator can change the owners of multiple nodes at a time on the DataStudio page. For more information, see Perform operations on multiple DataWorks objects at a time.

    After you change the owner of a node in the development environment, you must deploy the node to the production environment. This way, the change can take effect.

  • Change the owner of a node or the owners of multiple nodes at a time in the production environment.
    OperationIllustration
    Change the owner of a nodeChange the owner of a node
    Change the owners of multiple nodes at a timeChange the owners of multiple nodes at a time
    Note After you change the owner of a node in the production environment, the owner of the node in the development environment is also changed.

View operation records of auto triggered nodes

Entry pointDescriptionIllustration
Operation Log tab of the DAG page of an auto triggered node or auto triggered node instanceYou can view the operation records of an auto triggered node or auto triggered node instance on the Operation Log tab. Operation Log tab
Versions tab on the DataStudio pageIf no details about an operation that is performed on and deployed for an auto triggered node are recorded, you can go to the configuration tab of the auto triggered node and compare an existing version of the node with the version of the node in the production environment to obtain details about version changes. For more information, see Deploy nodes. Version comparison
Operation History page in Operation CenterYou can go to the Operation History page in Operation Center to view the operation records of an auto triggered node, an auto triggered node instance, or a baseline. For more information, see View operation records in Operation Center. Operation logs

FAQ

For more information about the FAQ for the O&M operations that can be performed on an auto triggered node, see FAQ about auto triggered nodes.