Back to Gitlabhq

Runner fleet dashboard for groups

doc/ci/runners/runner_fleet_dashboard_groups.md

18.11.22.4 KB
Original Source

{{< details >}}

  • Tier: Ultimate
  • Offering: GitLab.com, GitLab Self-Managed
  • Status: Beta

{{< /details >}}

{{< history >}}

  • Introduced as a beta in GitLab 17.0 with a flag named runners_dashboard_for_groups. Disabled by default.
  • Feature flag runners_dashboard_for_groups removed in GitLab 17.2.

{{< /history >}}

Users with the Maintainer or Owner role for a group can use the runner fleet dashboard to assess the health of group runners.

Dashboard metrics

The following metrics are available in the runner fleet dashboard:

MetricDescription
OnlineNumber of online runners. In the Admin area, this metric displays the number of runners for the entire instance. In a group, this metric displays the number of runners for the group and its subgroups.
OfflineNumber of offline runners.
Active runnersNumber of active runners.
Runner usage (previous month)<sup>1</sup>Number of compute minutes used by each project on group runners. Includes the option to export as CSV for cost analysis.
Wait time to pick a job<sup>1</sup>Displays the mean wait time for runners. This metric provides insights into whether the runners are capable of servicing the CI/CD job queue in your organization's target service-level objectives. The data that creates this metric widget is updated every 24 hours.

Footnotes:

  1. For GitLab Self-Managed, to view the Runner usage and Wait time to pick a job metrics, you must configure the ClickHouse integration.

View the runner fleet dashboard for groups

Prerequisites:

  • You must have the Maintainer role for the group.
  • For GitLab Self-Managed, to view the Runner usage and Wait time to pick a job metrics, configure the ClickHouse integration.

To view the runner fleet dashboard for groups:

  1. In the top bar, select Search or go to and find your group.
  2. Select Build > Runners.
  3. Select Fleet dashboard.