Documentation menu
Getting started
Dashboard & analytics
- Dashboard at a glance
- Cost analysis
- Pipeline performance
- Optimization insights
- Knowledge Base
- Connect your AI agent
Managed runners
- Runners overview
- Run your first job
- The Runners page
- Custom runners (AI Scan)
- Self-healing
- Runner image & software
- Limits & concurrency
Caching
Team & notifications
Billing & plans
Help
The dashboard at a glance
The dashboard layout, every sidebar destination, the global filter bar, and the banners that tell you what Latchkey is doing in the background.

The dashboard has three standing parts: the sidebar (where you go), the filter bar (what data you are looking at), and the page itself. This guide covers all three, plus the banners Latchkey uses to tell you what is happening in the background.
The sidebar#
Every destination in one place. Entries marked admin are only visible to workspace owners and admins; everyone else sees the rest.
Below those, the sidebar links to this documentation, a feedback form, and support.
The filter bar#
Every analytics page shares one filter bar at the top:
- Runner type selector: All Runners, Latchkey Runners, or GitHub Runners.
- Repository and Workflow multi-selects. The repository picker adds search, select-all, and clear-all. Analytics pages show data for the repositories and workflows you select; if nothing is selected, pages prompt you to pick a repository first.
- Date range picker with 7D, 30D, 90D, 1Y, and YTD presets plus a custom calendar range. The default window is the last 14 days. (The Cost Analysis page swaps in billing-oriented presets: MTD, 7D, 30D, 3M, 6M, and 12M.)
- Reset filters to go back to defaults in one click.
- Display settings (gear icon) with a "Show decimals" toggle that switches between rounded and precise values.
- Notification bell with your in-app notification history.
How the filters compose#
The selectors all narrow the same result set: runner type, repository, and workflow act together, and the date range bounds the window everything is computed over. Selecting one repository and one workflow, then tightening the date range, is the standard way to isolate a single pipeline's behavior over a specific stretch of time. Because every analytics page shares the same bar, the scope you set applies wherever you navigate next: the cost you see on Cost Analysis and the durations you see on Pipeline Performance describe the same slice of your CI.
No repository selected
- Analytics pages do not guess a scope for you
- You are prompted to pick a repository first
- Pick one from the Repository selector to populate the page
Repositories selected
- Pages show data for exactly the repositories and workflows you chose
- Narrow further with the workflow selector and date range
- Reset filters takes you back to defaults in one click
If a repository you expect is missing from the selector, it is most likely not monitored yet. Monitoring is managed by owners and admins from the Monitoring modal; see Managing repositories.
Fullscreen charts and live refresh#
Two behaviors worth knowing about the data on screen. Every chart expands to a fullscreen view with the filter bar still available, so you can slice and present in the same view without losing your scope. And the page refreshes automatically, shortening its refresh interval while any workflow is in progress: during active CI runs, results land in near real time with no manual reload.
Banners worth knowing#
- Backfill progress: shows while historical data for a newly enabled repository is importing.
- AI processing: shows on the Insights page while the optimization agent is analyzing.
- Free tier warning: appears when you have used 80% (and again at 100%) of your included runner minutes.
- Trial notices: a countdown when your trial is ending, and a full-screen prompt to subscribe once it has ended.
None of these require action to keep the dashboard working; they are Latchkey narrating its own background work. Each one has a natural next stop when you want more detail:
| Banner | What it tells you | Where to go next |
|---|---|---|
| Backfill progress | Historical runs for a newly enabled repository are still importing | Managing repositories explains what backfill covers |
| AI processing | The optimization agent is analyzing your workflows right now | Optimization insights is where results land |
| Free tier warning | You have used 80% (then 100%) of your included runner minutes | Runner usage and free minutes |
| Trial notices | Your trial is ending, or has ended | Plans and trial |
Command & Control (Overview)#
The Overview page condenses the three analytics areas into one screen, and each section links to its detail page:
- Optimization Insights: a health badge (GOOD, WARNING, or CRITICAL) with counts of high, medium, and low priority recommendations, plus potential monthly savings. When nothing is open, the card shows a "You're all caught up" state, and new recommendations surface as your workflows run.
- Pipeline Performance: workflow health gauge, repositories and workflows monitored, mean time to recovery (MTTR), and a summary of total runs, average duration, fail rate, cancel rate, and rebuild success rate.
- Cost Analysis: theoretical cost with a week-over-week trend, your top three repositories by spend (each linking to GitHub), billable cost over time with a dotted forecast extension, and free-tier minute tracking for both GitHub and Latchkey runners.
Reading the Overview in 60 seconds#
The Overview is built to be scanned, not studied. Here is one way to make a quick pass a habit; the order is a suggestion, not a product requirement:
Check the health badge
GOOD, WARNING, or CRITICAL sets the tone for the whole pass. If it is not GOOD, note the count of high-priority recommendations; that is what you will drill into on the Insights page later.
Scan the performance summary
Look at the workflow health gauge, MTTR, and fail rate. You are not looking for absolute numbers; you are looking for movement versus what is normal for your team. Anything surprising, follow the section link into Pipeline Performance.
Read the cost trend
The week-over-week trend on theoretical cost is your single fastest "is spend drifting?" signal. Glance at the top-spend repositories for anything unexpected near the top; the full story lives on Cost Analysis.
Glance at free-tier tracking
The Overview tracks free-tier minutes for both GitHub and Latchkey runners. If either is running hot, you will also get a banner at 80%, but catching it early here is cheaper than reacting later.
Click through the one section that moved
Each Overview section links to its full page. A useful discipline: pick the single section that changed the most since your last look and go deep on that one, instead of skimming all three.