Monitor
Monitor and troubleshoot workflow executions
Every time a workflow executes, Flint creates a run record with complete details about what happened. Use these records to monitor performance, troubleshoot issues, and understand how your workflows behave in production.
Accessing Workflow Runs
- Go to Workflows in the sidebar
- Select a workflow
- Click the Runs tab
You'll see a list of all executions with status, trigger time, and duration.
Run Statuses
| Status | Meaning |
|---|---|
| Running | Currently executing |
| Completed | Finished successfully |
| Failed | Stopped due to an error |
| Waiting | Paused at an intervention |
| Cancelled | Manually stopped |
Viewing Run Details
Click any run to see:
Timeline
A step-by-step view of the workflow execution. Each step shows:
- Start time and duration
- Input data received
- Output data produced
- Status (success, error, skipped)
Files
Documents and attachments involved in the run. Click to preview or download.
Logs
Detailed system logs for debugging. Includes:
- API calls made
- Errors and warnings
- Variable values at each step
Logs are retained for 30 days. For compliance requirements, export logs before they expire.
Troubleshooting Failed Runs
Find the Failed Step
Open the run and look for the step marked with a red error indicator.
Check the Error Message
Expand the step to see the specific error. Common issues:
- Connection failed Integration credentials expired
- Invalid data Input didn't match expected format
- Timeout External service took too long
- Rate limited Too many API calls
Review Input Data
Check what data the step received. Often the issue is upstream—incorrect data from a previous step.
Check Logs
For detailed debugging, review the logs tab. Look for warnings before the error.
Fix and Retry
Once you've identified the issue:
- Fix the workflow configuration
- Re-run the workflow with the original trigger data (if available)
- Or wait for the next trigger
Filtering Runs
Use filters to find specific runs:
| Filter | Use Case |
|---|---|
| Status | Show only failed runs |
| Date range | View runs from a specific period |
| Trigger type | Show only webhook-triggered runs |
Run Actions
Cancel a Running Workflow
If a workflow is stuck or taking too long:
- Open the run
- Click Cancel Run
- Confirm
The workflow stops immediately. Any pending interventions are cancelled.
Retry a Failed Run
Some failures can be retried (e.g., after fixing an integration):
- Open the failed run
- Click Retry
- The workflow re-executes from the beginning
Retrying re-executes the entire workflow. If earlier steps have side effects (sending emails, creating records), they will happen again.
Performance Monitoring
Track workflow performance over time:
- Average duration Is your workflow getting slower?
- Success rate What percentage complete successfully?
- Queue time How long before execution starts?
See the Analytics page for dashboards and metrics.