Runs

The Runs section is a command execution and monitoring interface that allows users to track, manage, and visualize automated processes in real-time. It provides both list and Gantt chart views of running commands and their statuses.

Table of Contents

  1. Overview
  2. System States
  3. Main Features
    1. Dashboard Overview
    2. Run Visualization
    3. Run Management
  4. Using the Runs Interface
    1. Viewing Runs
    2. Managing Runs
  5. Best Practices
  6. Troubleshooting

Overview

System States

Ready

In the ready state, any queued runs will execute sequentially.

Busy

In the busy state, commands within a run are currently being run through the queue.

Offline

In the offline state, any queued runs will stay in the queue, waiting to be executed.

Main Features

Dashboard Overview

Statistics Panel

  • Total Runs Counter
  • Completed Runs
  • Active Runs
  • Last Updated Time

Status Indicators

  • Queue Status
  • Current System State
  • Error Notifications

Run Visualization

List View (Swim Lane)

  • Hierarchical view of runs and their commands
  • Expandable/collapsible run details
  • Status indicators for each run
  • Progress tracking
  • Command details

Gantt Chart View

Features:

  • Timeline visualization of runs
  • Real-time updates
  • Tool-based color coding
  • Interactive timeline controls

Zoom levels:

  • Seconds
  • Minutes
  • Hours

Run Management

Controls

  • Start/Stop Runs
  • Delete Runs (with confirmation)
  • Skip Run
  • Expand/Collapse Run Details

Status Tracking

Status Description
STARTED Run is currently executing
COMPLETED Run has finished successfully
FAILED Run encountered an error and could not complete

Using the Runs Interface

Viewing Runs

List View

Each run is displayed as a card showing:

  • Run ID
  • Status
  • Progress
  • Start Time
  • Duration
  • Associated Tools

Expanding a run shows:

  • Detailed command list
  • Command status
  • Command parameters
  • Execution time

Gantt Chart View

Timeline Navigation:

  • Pan left/right
  • Zoom in/out
  • Auto-scroll toggle
  • Time scale selection

Run Visualization:

  • Color-coded by tool
  • Command duration bars
  • Current time indicator
  • Progress tracking

Managing Runs

Starting a Run

1
Select the run from the queue
2
Verify run parameters
3
Click Start or use automated scheduling

Monitoring Active Runs

  • Track progress in real-time
  • View current command execution
  • Monitor tool status
  • Check for errors or warnings

Error Handling

Error notifications appear at the top with detailed error messages available.

Options to:

  • Skip failed command
  • Retry run
  • Cancel run

Best Practices

Queue Management

  • Regularly clear completed runs
  • Monitor queue length
  • Balance load across tools

Error Handling

  • Address errors promptly
  • Document error patterns
  • Implement preventive measures

Performance Optimization

  • Monitor run durations
  • Identify bottlenecks
  • Optimize command sequences

Monitoring

  • Keep auto-scroll enabled for active monitoring
  • Use appropriate time scales for different operations
  • Regular status checks

Troubleshooting

Common Issues and Solutions

Stalled Runs

  • Check tool connectivity
  • Verify command parameters
  • Review error logs

Queue Buildup

  • Clear completed runs
  • Review scheduling
  • Check tool availability

Performance Issues

  • Optimize command sequences
  • Check network connectivity
  • Monitor system resources

Warning: Canceling an active run may leave tools in an undefined state. Always check tool status after canceling a run.

Tip: You can export run data as CSV or JSON for further analysis or record-keeping by clicking the "Export" button in the run details view.