Introduction
Once you’ve created a workflow, it’s important to test it thoroughly before going live. Dify offers a full set of debugging tools that let you troubleshoot issues, track variable flow, and review detailed execution logs — all in one place.
Dify provides a comprehensive debugging toolset to help you quickly locate issues, inspect variable transmission, and view detailed logs.
This article introduces the full workflow debugging process, including single-node debugging, variable inspection, execution history, and end-to-end testing.
Debugging a Workflow Application
Single Node Debugging
If a specific node causes the workflow to fail, you can debug that node individually to quickly identify the issue.
To test a single node, click the debug icon in its top-right corner. Try entering some simple test data and observe the output. You can gradually introduce more complex input to see how the node responds.
For more details, see Debug Node.
Step-by-Step Node Debugging
This method lets you trace how data flows through each step — from one node to the next — helping you catch issues in real-time.
For detailed usage, see Variable Inspection.
View Node Execution History
Click “Last Run” in the node panel to review logs from the most recent execution — including inputs, outputs, timing, and any errors.
See Debug History - Node Logs for more details.
Debugging the Entire Workflow
After you’ve confirmed that each individual node works as expected, it’s time to test the entire workflow from start to finish.
Use the Preview feature to experience the final user interface. This mode displays the input fields, output area, and interaction flow — ideal for confirming user experience expectations. During preview, the system performs an auto-check to ensure all nodes are configured correctly and connected.
Configuration Checklist
Before you run the full workflow, Dify will automatically check for missing parameters, misconfigurations, or disconnected nodes — and prompt you to fix them.
While running the workflow, you can view each node’s execution status on the right panel, including input/output and logs. Use the status indicators (green = success) to identify where a failure may have occurred.
It’s recommended to perform multiple test rounds with varying data types and complexities to verify workflow stability before going live.
View Application Logs
After publishing your application, you can monitor how it’s performing and how users interact with it. Dify’s logs and monitoring tools help you troubleshoot issues, track performance trends, and better understand user behavior.
For more information, see: