Skip to main content

Execution History

The Execution History page provides a comprehensive view of all flow executions, allowing you to monitor, analyze, and manage your automation runs.

Overview​

The Execution History page displays:

  • Parent Flow Executions: Main flow runs with complete execution details
  • Performance Metrics: Execution duration, success rates, and statistics
  • Filtering Options: Filter by status, flow, device, and date range
  • Bulk Operations: Select and delete multiple executions

Key Features​

  • Status Filter: Filter by execution status (SUCCESS, FAILED, RUNNING, etc.)
  • Flow Filter: Filter by specific flow ID
  • Device Filter: Filter by device used for execution
  • Date Range: Filter executions within a specific time period
  • Clear Filters: Reset all filters with one click

Execution Management​

  • Individual Deletion: Delete single executions with confirmation
  • Bulk Deletion: Select multiple executions for batch deletion
  • Execution Details: View detailed execution information and steps
  • Navigation: Click on executions to view detailed results

Video Recordings​

  • Automatic Recording: Screen recordings are automatically captured during flow execution
  • S3 Storage: Video files are stored in S3 for reliable access and archival
  • Video Playback: View execution videos directly in the execution detail page
  • Download Support: Download video recordings for offline analysis or sharing
  • Video Format: Recordings are saved in Matroska (MKV) format and served as MP4
  • Recording Association: Each execution can have an associated video recording file

Statistics and Analytics​

  • Performance Stats: Toggle statistics panel to view:
    • Total executions count
    • Success rate percentage
    • Average execution duration
    • Execution trends over time
  • 30-Day Default: Statistics show data from the last 30 days

User Interface​

Header Section​

  • Page title and description
  • Action buttons for stats, bulk operations, and filter management
  • Statistics panel (toggleable)

Filters Panel​

  • Dropdown selectors for status, flow, and device filters
  • Date range picker for temporal filtering
  • Real-time execution count display

Results Table​

  • Sortable columns (Date, Flow, Status, Duration, Device)
  • Checkbox selection for bulk operations
  • Load more button for pagination
  • Individual action buttons per execution

Usage Examples​

Viewing Recent Executions​

  1. Navigate to Execution History
  2. View default list of recent parent flow executions
  3. Use "Show Stats" to see performance metrics

Filtering Failed Executions​

  1. Click the Status filter dropdown
  2. Select "FAILED" from the options
  3. View only failed executions for troubleshooting

Bulk Cleanup​

  1. Use filters to find old executions
  2. Select executions using checkboxes
  3. Click "Delete Selected" with confirmation

Performance Analysis​

  1. Toggle "Show Stats" panel
  2. Review success rates and average durations
  3. Filter by specific flows to analyze performance

Viewing Execution Videos​

  1. Navigate to an execution detail page
  2. Locate the "Execution Video" card in the right column
  3. Use video controls to play, pause, and seek through the recording
  4. Click "Download" button to save the video file locally
  5. Videos are streamed from S3 for efficient playback

Technical Details​

Data Loading​

  • Uses React Query for efficient data fetching
  • Implements infinite scroll with 50-item pages
  • Automatic cache invalidation on component mount
  • Error handling with retry functionality

Filtering Logic​

  • Server-side filtering for optimal performance
  • Real-time filter application without page reload
  • Combined filters support (AND logic)
  • Filter state preservation during navigation

Troubleshooting​

Common Issues​

  • No Executions Showing: Check filters and try clearing them
  • Stale Data: Page refresh automatically invalidates cache
  • Slow Loading: Consider using date range filters for large datasets
  • Delete Failures: Ensure you have proper permissions and retry

Error Handling​

  • Component-level error boundaries prevent crashes
  • User-friendly error messages with retry options
  • Automatic retry for failed data fetching
  • Toast notifications for operation feedback

Best Practices​

  1. Regular Cleanup: Use bulk delete to remove old executions
  2. Filter Usage: Apply filters before loading large datasets
  3. Performance Monitoring: Check stats panel regularly for trends
  4. Error Analysis: Use failed execution filter for debugging
  5. Date Ranges: Limit date ranges for better performance

Integration​

The Execution History integrates with:

  • Flow Management: Links to flow details and settings
  • Device Management: Shows device information and status
  • Recording System: Associates video recordings with executions, stored in S3
  • S3 Storage: Video files are automatically uploaded to S3 after execution completion
  • Analytics: Provides data for performance monitoring