Runner fleet dashboard for administrators
DETAILS: Tier: Ultimate Offering: GitLab Self-Managed
- Introduced in GitLab 16.6
As a GitLab administrator, you can use the runner fleet dashboard to assess the health of your instance runners. The runner fleet dashboard shows:
- Recent CI errors caused by runner infrastructure
- Number of concurrent jobs executed on most busy runners
- Compute minutes used by instance runners
- Job queue times (available only with ClickHouse)
Dashboard metrics
The following metrics are available in the runner fleet dashboard:
| Metric | Description |
|---|---|
| Online | Number of runners that are online for the entire instance. |
| Offline | Number of runners that are currently offline. Runners that were registered but never connected to GitLab are not included in this count. |
| Active runners | The total number of runners that are currently active. |
| Runner usage (previous month) | The total compute minutes used by each project or group runner in the previous month. You can export this data as a CSV file for cost analysis. |
| Wait time to pick a job | The average time a job waits in the queue before a runner picks it up. This metric provides insights into whether your runners are capable of servicing the CI/CD job queue in your organization's target service-level objectives (SLOs). This data is updated every 24 hours. |
View the runner fleet dashboard
Prerequisites:
- You must be an administrator.
To view the runner fleet dashboard:
- On the left sidebar, at the bottom, select Admin.
- Select Runners.
- Select Fleet dashboard.
Most of the dashboard works without any additional actions, with the exception of Wait time to pick a job chart and features proposed in epic 11183. These features require setting up an additional infrastructure.
Export compute minutes used by instance runners
Prerequisites:
- You must have administrator access to the instance.
- You must enable the ClickHouse integration.
To analyze runner usage, you can export a CSV file that contains the number of jobs and executed runner minutes. The CSV file shows the runner type and job status for each project. The CSV is sent to your email when the export is completed.
To export compute minutes used by instance runners:
- On the left sidebar, at the bottom, select Admin.
- Select Runners.
- Select Fleet dashboard.
- Select Export CSV.
Enable more CI analytics features with ClickHouse
DETAILS: Tier: Ultimate Offering: GitLab.com, GitLab Self-Managed Status: Beta
- Introduced as an experiment in GitLab 16.7 with flags named
ci_data_ingestion_to_click_houseandclickhouse_ci_analytics. Disabled by default.- Enabled on GitLab.com and self-managed in GitLab 16.10. Feature flags
ci_data_ingestion_to_click_houseandclickhouse_ci_analyticsremoved.- Changed to beta in GitLab 17.1.
WARNING: This feature is in beta and subject to change without notice. For more information, see epic 11180.
To enable additional CI analytics features, configure the ClickHouse integration.
For an overview, see Setting up runner fleet dashboard with ClickHouse.
Feedback
To help us improve the runner fleet dashboard, you can provide feedback in issue 421737. In particular:
- How easy or difficult it was to set up GitLab to make the dashboard work.
- How useful you found the dashboard.
- What other information you would like to see on that dashboard.
- Any other related thoughts and ideas.