Table of Contents

Tips for troubleshooting data flow rules

From the Data Flow Run dialog box, you can view detailed reports on any errors that occur while a data flow is being processed. By analyzing these the error reports, you can quickly diagnose the root cause of an error.

Viewing error details

Each error message provides information about the data flow shape in which the error occurred and a link to a stack trace. You can review the method calls in the stack trace to understand the point at which your application encounters an error and which exceptions are raised.

  1. To view the stack trace, click Details in the error message.
  2. Optional: To improve the readability of the stack trace, right-click inside the error window, and then click View page source.

Error details

A data flow error message and error details

Viewing the error count per component

You can view the number of failed records per component in a data flow to detect which shapes are the source of errors.

  1. In the Data Flow Run dialog box, click the Run details tab.
  2. In the #Failed records column, view the number of failed records that is displayed for the data flow component in which the errors occurred.
  3. View the error list per data flow component by clicking the number of errors in the #Failed records column.
    1. Click View details to view the stack trace with an error.
    2. Click View input record to view the record that caused an error.

Error details

A list of errors for a data flow component

Viewing the error count per node

You can view the number of partitions, which are equal segments of data that are spread across distinctive decision data nodes, that a data flow processes. In the case of an error, you can view on which node it occurred. You can also view the throughput per each node, which might give an indication as to which node is the slowest one.

  1. Scroll down to the bottom of the Data Flow Run dialog box.
  2. On the Distribution details tab, view the data flow distribution details.
  3. View the error list per node:
    1. In the #Failures column, click the number of errors for the data flow component to view the list of errors.
    2. Click View details to view the stack trace with an error.
    3. Click View input record to view the record that caused an error.

Distribution details

The Distribution details tab on the Data Flow Run page

Enabling debug logging

When error details do not give you enough information to fix an error, you can enable debug logging for the com.pega.dsm.dnode package to include more output in the generated log files. For example, you can view the SQL query that was running on an external database table when the error occurred.

  1. Click Designer Studio > System > Operations > Logs.
  2. On the Logs tab, click Logging Level Settings.
  3. In the Logger name field, press the Down Arrow key and select the name of a class that starts with (or is in the package) com.pega.dsm.dnode.
  4. In the Current level list, select the logging level. For more information, see Logging Level Settings tool.
  5. Close the Logging Level Settings window dialog box to save your settings.

Logging level

Selecting a logging level for decision management components

Suggest Edit

66% found this useful


Related Content

Have a question? Get answers now.

Visit the Pega Support Community to ask questions, engage in discussions, and help others.