orchkaDocs

Execution Monitoring

Orchka provides a powerful set of tools to monitor your workflow executions in real-time and review historical runs.

Overview Panel

The Executions page opens with an Overview card containing five stat tiles (total runs, successful, failed, success rate, average duration) and a stacked bar chart of daily succeeded-vs-failed runs across the last 30 days. See Dashboard Overview for the full breakdown.

Execution History

Below the overview is the execution list — every run in your active organization, newest first.

Each row shows:

  • Status: The current state of the execution.
  • Workflow: The name of the workflow that was executed.
  • Started At: When the execution began.
  • Duration: Total time taken for the execution.

The toolbar above the list supports:

  • Search — filter by workflow name; partial, case-insensitive
  • Status filter — dropdown with All / Running / Completed / Failed / Cancelled. Selection writes to the URL as ?status=…, so filtered views are shareable and survive reloads.

Filtering is server-side: the database query applies the filter in its WHERE clause, not the client. This means a workspace with millions of executions filters as fast as one with a hundred.

Pagination

The list is paginated with a smart, scalable control:

  • At most ~9 page chips are rendered regardless of total
  • A summary reads "23–46 of 1,247"
  • Below 640px width, chips collapse into "page / total"
  • Click any ellipsis (…) to open a "Go to page" popover — essential when there are hundreds of pages

Organization Scoping

The list shows only executions belonging to your active organization. Switching the org in the sidebar narrows the list to that org's executions. Personal executions don't appear in team orgs, and vice versa. See Organizations & Teams for details.

Execution Detail View

Clicking on an execution entry opens the Execution Detail View. This view is designed to provide deep visibility into what happened during a specific run.

Trace Timeline

The execution detail features a D3-powered Trace Timeline. This visualization maps out every step of the workflow against a horizontal time axis.

  • Step Visualization: Each node execution is represented as a segment on the timeline.
  • Duration Mapping: The length of each segment corresponds to the time it took for that specific node to execute.
  • Relative Positioning: Quickly identify bottlenecks by seeing which steps took the longest or where delays occurred between steps.

Status Indicators

Each step in the trace is color-coded based on its outcome:

  • ● Success: The node completed successfully.
  • ● Failed: The node encountered an error.
  • ● Pending/Running: The node is currently executing or waiting.

Data Inspection

Deeply inspect the data flowing through your workflow with the integrated Payload Viewer.

Payload Viewer

Located within the Execution Detail view, the Payload Viewer uses a premium, searchable JSON tree structure to display:

  • Input: The exact data passed to the node.
  • Output: The result produced by the node.
  • Error Details: If a node fails, the full error message and stack trace (if available) are shown.

Features

  • Collapsible Nodes: Navigate large JSON structures easily.
  • Syntax Highlighting: Type-safe and readable data representation.
  • Breadcrumb Navigation: Keep track of where you are in complex objects.

Real-time Updates

When you execute a workflow from the editor, the monitoring system provides live feedback:

  • Live Trace: Watch nodes light up on the canvas and appear in the trace timeline as they execute.
  • Instant Logs: View logs and data as soon as they are generated by the backend.

Error Recovery

If an execution fails, Orchka's monitoring tools help you identify the root cause quickly:

  1. Locate the red failed step in the Trace Timeline.
  2. Select the step to view its Error Payload.
  3. Fix the configuration in the editor and Re-execute.

Storage Model

Execution data is split between two stores to keep the live execution path fast:

  • Steps stream to Redis as nodes complete. The execution detail page reads from Redis in real time so you see updates instantly.
  • A summary row in Postgres is created when the run starts and updated to its terminal state on completion or failure. Step records are persisted to Postgres only when the run finishes (or on first read after the fact, lazily backfilled from Redis).
  • A daily rollup (execution_stat) is incremented transactionally on every terminal state, powering the overview cards and chart without needing to scan the execution table.

Composite indexes on (organizationId, startedAt) and (organizationId, status, startedAt) make every list and stats query constant-time regardless of historic volume.

On this page