Automation Runs

Monitor and manage automated pricing rule executions in real-time

What are Automation Runs?

Automation Runs are execution records that track when pricing rules are applied to your products. Each time you apply a pricing rule, Calibrate creates a Run that monitors the entire execution process, from queuing to completion, providing full visibility into what changed and why.

Why Monitor Runs?

•
Transparency: See exactly which products were affected and how prices changed
•
Reliability: Monitor execution status and catch failures early
•
Recovery: Retry failed price updates without re-running entire rules
•
Audit Trail: Complete history of all automated price changes for compliance

Access: Navigate to Automation → Runs in the project sidebar, or visit /p/[your-project]/automation/runs

Run Statuses

Each run progresses through several statuses as it executes. Understanding these statuses helps you monitor execution and troubleshoot issues.

PREVIEWPREVIEW

Rule execution is being previewed. No changes have been applied yet.

QUEUEDQUEUED

Run is waiting to be processed by the automation worker.

APPLYINGAPPLYING

Run is currently executing. Price changes are being applied to your platform.

APPLIEDAPPLIED

Run completed successfully. All price changes were applied.

FAILEDFAILED

Run encountered errors. Some or all price changes may have failed.

ROLLED_BACKROLLED_BACK

Run was rolled back. All changes have been reverted to previous prices.

Viewing Automation Runs

Runs Table

The Automation Runs page displays all rule executions in a sortable table. Each row shows:

•
Rule Name: The pricing rule that was executed
•
Status: Current execution status with color-coded badge
•
Targets: Number of products affected, with breakdown by status (applied/failed/queued)
•
Created: When the run was initiated
•
Actions: View details or retry failed targets

Filtering Runs

Use the status filter buttons at the top of the page to view runs by status:

•
All: Show all runs regardless of status
•
Status Filters: Click any status button (Queued, Applied, Failed, etc.) to filter runs
•
Active Filter: The selected filter is highlighted to show which view is active

Real-Time Progress Monitoring

For runs with status QUEUED or APPLYING, Calibrate automatically polls the execution progress every 2 seconds, updating the UI in real-time.

Progress Indicators

•
Percentage: Shows completion percentage (e.g., "50%")
•
Count: Displays completed vs total targets (e.g., "10/20")
•
Status Updates: Toast notifications appear when runs complete or fail

Note: Progress polling automatically stops when a run reaches a final status (APPLIED, FAILED, or ROLLED_BACK) to conserve resources.

Run Details

Click the View button on any run to open a detailed drawer with comprehensive information about the execution. The drawer includes four tabs:

Overview Tab

Summary information about the run

•
Current status and timestamps (created, started, finished)
•
Total number of targets affected
•
Target status breakdown (applied, failed, queued)
•
Error messages if the run failed
•
Retry button for runs with failed targets

Explain Tab

Technical details about the rule execution

•
Transform JSON: The exact price transformation that was applied
•
Explain Trace: Detailed rationale showing why products were selected and how prices were calculated
•
Useful for debugging and understanding rule behavior

Targets Tab

Individual product price changes

•
Complete list of all products targeted by the run
•
Before/After price snapshots in JSON format
•
Per-target status (QUEUED, APPLIED, FAILED)
•
Error messages for failed targets
•
Product and variant IDs for reference

Audit Trail Tab

Complete history of actions taken on this run

•
Chronological list of all audit events
•
Actions performed (apply, retry_failed, etc.)
•
Actor information (who performed the action)
•
Timestamps for each event
•
Full explain data for compliance and debugging

Retrying Failed Targets

If a run has failed targets (products where price updates couldn't be applied), you can retry them without re-running the entire rule. This is especially useful when failures are due to temporary issues like network timeouts or rate limiting.

How to Retry

Navigate to the Automation Runs page
Find the run with failed targets (status will show "FAILED" or have failed count in Targets column)
Click the Retry Failed button in the Actions column, or open the run details and click Retry Failed in the Overview tab
Calibrate will reset all failed targets to QUEUED status and the automation worker will process them again
Monitor progress in real-time as the retry executes

When to Retry:

Network connectivity issues that have been resolved
Platform rate limits that have reset
Temporary API errors from your e-commerce platform
Authentication token expiration (after refreshing credentials)

Important: Only retry if you've addressed the root cause of the failure. Retrying without fixing underlying issues (like invalid product IDs or pricing constraints) will result in the same failures.

Best Practices

Monitor Active Runs

Keep the Automation Runs page open when executing large rules to monitor progress and catch issues early.

Review Failed Runs Promptly

Check failed runs within a few hours to retry before data becomes stale or products change.

Use Explain Tab for Debugging

When a rule doesn't behave as expected, check the Explain tab to see the exact transform logic and rationale.

Check Audit Trail for Compliance

Use the Audit Trail tab to generate reports showing who executed rules and when, for compliance purposes.

Filter by Status for Quick Actions

Use status filters to quickly find runs that need attention (e.g., all FAILED runs for retry).

Troubleshooting

Issue: Run stuck in QUEUED status

This usually means the automation worker is processing other runs. Wait a few minutes, or check if there are many active runs. If stuck for more than 10 minutes, contact support.

Issue: Many targets failed

Check the Targets tab to see error messages. Common causes: invalid product IDs, pricing constraints (floor/ceiling), or platform API errors. Fix the root cause before retrying.

Issue: Progress not updating

Refresh the page. Progress polling may have stopped if the run completed. Check the run status badge to see current state.

Issue: Retry Failed button not appearing

The button only appears for runs with failed targets. If all targets succeeded, there's nothing to retry. Check the Targets column to see the breakdown.