--- title: "Configuring the Root-Cause Analyzer" slug: "configuring-the-root-cause-analyzer" tags: ["Process Mining", "Root Cause"] updated: 2025-06-10T16:14:42Z published: 2025-06-10T16:14:42Z canonical: "documentation.decisions.com/configuring-the-root-cause-analyzer" --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring the Root-Cause Analyzer ## Overview The **Root-Cause Analyzer** of the [Diagnoser](/process-mining/docs/diagnoser-overview) visualizes the root-cause of the selected attribute to identify underlying issues and where they originate. This process is enhanced with built-in Machine Learning capabilities, allowing Users to detect root-causes more quickly. The resulting information then aids Users to create potential solutions. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-10_09h28_32.png) --- ## Nodes and Edges The Root-Cause Analyzer diagram is comprised of a **Root Node**, several intermediate **Leaf N****odes,** and **E****dges**. ### Nodes The **R****oot Node** represents all cases within the Event Log. From here, edges connect it to its leaf nodes. **Leaf nodes** represent a group of similar cases and display the following information: - The average value of the target parameter for the root-cause analysis, e.g., duration. - The number of cases within the group, i.e., node - The accuracy of the root-cause analysis for the given node The number of cases affects the color of the node: darker colors denote a larger group in the node and vice versa. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1646676267374.png) Double-clicking on a node opens additional information, such as the number of cases and root-cause analysis accuracy. Nodes with plus icons contain further leaf nodes. Users may filter the Event Log to retain only the cases included by the sequence of root causes leading to the specified node. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-10_09h46_37.png) ### Edges An **E****dge** represents a root-cause leading to a specific value for the target parameter and displays the following information: - The root-cause. - The impact of the root-cause. - The number of cases influenced by the root-cause. The impact changes the color of the edge between gradient of green to red. Green details a positive impact, while red details a negative impact. Impacts in between are represented with different shades of yellow depending on the level of neutrality of the node. The number of cases affects the thickness of the edge: thicker edges denote a higher number of cases and vice versa. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1646677234844.png) --- ## Example 1. Open an Event Log and select the plus icon at the bottom of the window. Select **Diagnoser,** then **OK** to create a Diagnoser tab. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1646667056769.png) 2. Open the Diagnoser tab and change it from the default [Impact Analyzer](/process-mining/docs/configuring-the-impact-analyzer) page to the **Root-Cause Analyzer** page by selecting its button above the center diagram. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-10_12h09_00.png) 3. In the Root-Cause Analyzer, navigate to the settings on the right of the diagram. For **Find** **the Root-Cause of,** select a parameter to investigate. This example examines **Case Duration**. 4. Underneath the prior setting, select the following attributes to analyze. This example selects all attributes representing Case Duration. **Cost Amount** and **Cost Currency** attributes are automatically selected. 1. Users can also limit the analysis based on the following selected options: - **All Values:** This option discovers root causes for all possible values of the attribute without grouping. - **Grouped:** This option groups selected values under the **Desired Outcome** group, and groups remaining values under the **Undesired Outcome** group**.** - **Single Values:** This option keeps the selected values as they are and groups the remaining values under the **Undesired Outcome** group**.**![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-10_12h09_00(1).png)After selecting all desired attributes to examine, select **Detect Root Causes** to construct the diagram with the new settings. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-10_12h09_00(2).png) 5. Notice the root node now contains two edges splitting the log's cases between the default root-cause and the root-cause. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-09_14h28_02.png) 6. To further examine the leaf nodes, double-click on leaf nodes with the plus icon to expand and view their nested branches. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/ezgif.com-video-to-gif-converter%20(34).gif) --- ## Filtering the Root-Cause Analyzer Upon clicking on a node to view further details, Users may select **Add Filter** to automatically [Create a Filter](/process-mining/docs/filtering-the-process-map) that retains only cases influenced by the sequence of root causes leading to the selected node. Nested leaf nodes generate a filter for each layer to capture this sequence. For example, a leaf node two layers down from the root node will generate two filters. After selecting this button, the filter may be edited, disabled, or deleted by navigating to the filter window to the top right of the window. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/ezgif.com-cut%20(1).gif) --- ## Downloading the Root-Cause Diagram At the top left of the diagram window, expanding the selection menu offers Users the option to download the root-cause analysis diagram as either a PNG or JPG image file, similar to a [Process Map](/process-mining/docs/process-map-analyzer-overview). ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-06-09_14h35_10.png) --- ## Feature Changes | Description | Version | Release Date | Developer Task | | --- | --- | --- | --- | | The Root Cause Analyzer can now limit the analysis based on selected options: All, Grouped, or Single Values. | [3.0](https://documentation.decisions.com/v99/docs/pm-version3x0?highlight=DT-039610) | April 2024 | [DT-039610] |