Workflow Debugger¶

Real-time Workflow Validation¶

The Workflow Debugger introduces a new way to build, test, and validate workflows directly, eliminating the guesswork traditionally involved in creating match conditions.

Workflows can be highly expressive and powerful, but historically they have also been fragile: a single typo in a regular expression or a mismatched field name could cause a workflow to silently fail to match any logs. With the Workflow Debugger, those frustrations are a thing of the past.

To access the Workflow Debugger, open any workflow and click the Debug icon in the top-right corner.

Key Features¶

Direct Device Attachment: Connect a development device instantly using a short code, allowing real-time testing against a real or simulated environment.
Live Log Streaming: See device logs as they arrive. The same capability provided by bd tail, now seamlessly integrated into the UI.
Visual Step Execution: Each node in the workflow graph lights up when its match condition is triggered, displaying execution counts in near real-time (<1s latency).
Resource and Session Insights: Observe device resource utilization and live session replay alongside the workflow's progress.
Instant Feedback: Instantly verify whether your workflow will correctly match on emitted logs before deployment, reducing iteration time and boosting confidence.

Global Workflow Step Counts¶

Beyond local debugging, global step counts are now available for all deployed workflows. These counts, powered by lightweight debug telemetry, show how often each workflow step has been matched across your entire fleet.

This visualization makes it easy to identify:

Steps that frequently match and drive actions
Steps that never match (potentially due to typos or outdated log structures)
Bottlenecks or unexpected branches in complex workflows

By combining real-time debugging with global visibility, you can build robust, high-fidelity workflows with ease.