Automation Dashboard & Rate Limits

The Automation Dashboard in project settings gives operators a single place to monitor recipe health, approvals, and usage limits. Use this guide to onboard new teams and answer common rate-limit questions.

Getting Started

1. Open the dashboard: Project → Settings → Automation. The page is also reachable via the command palette (Cmd/Ctrl + K → automation:dashboard).
2. Review the overview card: Shows run totals, success/pending/error counts, and links to the latest automation runs.
3. Enable/disable recipes: The Recipes table lists all synced recipes with origin (core, custom, repo). Toggle per project to disable without editing YAML.
4. Check pending approvals: The right rail surfaces outstanding approvals generated by automation. Clicking an entry opens the issue timeline at the relevant event.
5. Inspect usage insights: The Usage meter mirrors the billing dashboard, highlighting remaining automation quota and short-window throttles.

Onboarding Checklist

• Confirm the connected workflow repository is syncing (Workflow Sync Status widget).
• Walk through the built-in tour (Start Tour button) to highlight recipe toggles, usage card, and approval stream.
• Run the “SLA Breach Escalation” dry-run to show AI context + approval creation.
• Circulate your launch/GA checklist to stakeholders so everyone understands success criteria.

Tip: The guided tour automatically launches the first time an admin visits the dashboard. You can relaunch it from the “Guided Tour” card in the sidebar.

Rate Limit FAQ

How are automation limits calculated?
Each plan has both a monthly allocation (tracked via UsageEvent metrics) and a short-window throttle (enforced by PlanRateLimiter). Hitting either will block new runs until usage decreases or the window resets.

What happens when we exceed the limit?
The runtime cancels the automation before applying actions, records a warning in the activity feed, and notifies organization admins (in-app + email) with the remaining time until reset. Bulk operations mark the operation as failed with the error in metadata.

Where can I see remaining quota?
The Automation Dashboard usage card, the global Usage Dashboard, and the /api/v1/ext/rate_limit endpoint expose remaining counts for automation.recipe and automation.bulk.

Can we request higher limits?
Enterprise plans can request overrides via Support. Starter/Professional tiers should upgrade plans to increase allotments.

Do undo actions count against limits?
Undoing a bulk operation does not consume additional automation quota; only the initial apply is counted.

Troubleshooting

• Missing recipes: Use the Sync Core Recipes action from the dashboard (or kiket automation sync-core) or confirm the connected repository/branch contains the YAML.
• Approvals not appearing: Ensure workflow_approvals migrations ran and that notifications are enabled for reviewers.
• Usage card empty: Verify the organization has an active subscription and run AggregateUsageSnapshotsJob if testing locally.
• Rate-limit warnings immediately: Confirm short-window settings were not overridden in PlanRateLimiter::DEFAULT_LIMITS; review Redis cache state via the observability dashboard or kiket doctor rate-limits.