Execution History
The execution history shows all automation runs, helping you monitor performance and debug issues.
Viewing Execution History
Section titled “Viewing Execution History”Access execution history from:
- Automations page - Click an automation to see its executions
- Execution modal - View details for a specific execution
Execution List
Section titled “Execution List”The execution list displays:
| Column | Description |
|---|---|
| Status | Success, Failed, Running, or Pending |
| Trigger Event | What triggered this execution |
| Started | When the execution began |
| Duration | How long the execution took |
| Session | Link to the created session |
Filtering Executions
Section titled “Filtering Executions”Filter the list by:
- Status - Show only successful, failed, or running
- Date range - Executions within a time period
- Trigger type - Filter by event source
Execution Details
Section titled “Execution Details”Click an execution to view detailed information:
Trigger Information
Section titled “Trigger Information”See what triggered this execution:
Trigger: GitHub IssueRepository: my-org/my-appIssue: #42 - Login button not workingLabels: bug, authTriggered at: 2024-01-15 10:30:42 UTCAction Results
Section titled “Action Results”View what the action produced:
Action: Start SessionSession ID: ses_abc123Status: CompletedDuration: 3m 42sModel: Claude 3.5 SonnetSession Link
Section titled “Session Link”Click through to the full session to see:
- Complete conversation history
- Agent tool calls and outputs
- Any artifacts produced
Error Information
Section titled “Error Information”For failed executions, view error details:
Error: Failed to create sessionReason: AI provider rate limit exceededTimestamp: 2024-01-15 10:30:45 UTCExecution States
Section titled “Execution States”Running
Section titled “Running”Execution is currently in progress:
- Trigger received
- Session being created or active
- Agent working on the task
Success
Section titled “Success”Execution completed successfully:
- Session created and finished
- No errors encountered
- Results available
Failed
Section titled “Failed”Execution encountered an error:
- Trigger failed to process
- Session creation failed
- Agent encountered an error
- Timeout exceeded
Pending
Section titled “Pending”Execution is queued:
- Waiting for resources
- Rate limited (will retry)
Debugging Failed Executions
Section titled “Debugging Failed Executions”Common Failure Causes
Section titled “Common Failure Causes”| Cause | Solution |
|---|---|
| AI provider rate limit | Wait and retry, or use a different provider |
| Invalid credentials | Update credentials in Settings |
| Repository access denied | Check GitHub App permissions |
| Session timeout | Increase timeout or simplify task |
| Agent error | Review agent prompt, check session logs |
Investigation Steps
Section titled “Investigation Steps”- Check trigger data - Was the right event received?
- Review configuration - Are action settings correct?
- Examine session - If created, what did the agent do?
- Check credentials - Are API keys valid?
- Review logs - Look for specific error messages
Retrying Executions
Section titled “Retrying Executions”For failed executions:
- Open execution details
- Click Retry
- Execution re-runs with the same trigger data
Monitoring Best Practices
Section titled “Monitoring Best Practices”Regular Reviews
Section titled “Regular Reviews”Check execution history periodically:
- Daily for critical automations
- Weekly for routine workflows
- After any configuration changes
Success Rate Tracking
Section titled “Success Rate Tracking”Monitor your success rate:
- Healthy: greater than 95% success
- Needs attention: 80-95% success
- Investigate: less than 80% success
Alert on Failures
Section titled “Alert on Failures”Set up notifications for failed executions:
- Enable email notifications in Settings
- Configure Slack integration (if available)
- Monitor dashboard for failure indicators
Metrics and Analytics
Section titled “Metrics and Analytics”Execution Volume
Section titled “Execution Volume”Track how often automations run:
- Executions per day/week/month
- Peak execution times
- Trigger distribution
Performance Metrics
Section titled “Performance Metrics”Monitor execution performance:
- Average execution duration
- Time to first response
- Session completion time
Cost Tracking
Section titled “Cost Tracking”Understand automation costs:
- API token usage per execution
- Compute time consumed
- Total cost per automation
Next Steps
Section titled “Next Steps”- Build new automations
- Configure event triggers
- Set up GitHub integration