---
title: Runners
description: Monitor your CI runner fleet's performance, cost, and reliability to detect issues before they impact your pipelines.
---

The Runners page gives you visibility into your CI runner fleet. Track
performance, spot bottlenecks, and identify degraded runners before they
slow down your pipelines.

Whether you're optimizing costs, investigating slow queue times, or
monitoring runner health, this page centralizes the metrics you need to
keep your CI infrastructure running smoothly.

:::note
  Before using the Runners page, you need to have CI Insights enabled on
  your repository. See the [CI Insights setup guides](/ci-insights) to
  get started.
:::

## Configuring Your Fleet

Before any runner data appears, you need to configure which runners to
track. Click **Configure Runner Groups** to set up your fleet.

**Runner groups** let you organize runners by their group name. You can
track one or more groups at a time. **Labels** let you optionally filter
runners further (e.g., by operating system or architecture).

Only runners matching your configuration will appear in the table. You
can edit this configuration at any time by clicking the **Edit** button
in the fleet configuration section.

:::tip
  Start with a single runner group to get familiar with the metrics,
  then expand your configuration as needed.
:::

## Monitoring Your Runners

Once configured, the runners table gives you an at-a-glance view of each
runner's performance, queue times, throughput, and health status. Use the
date range selector to focus on a specific time window.

Expanding any runner row reveals detailed metrics including duration
percentiles (median, p95, p99), queue time breakdowns, total runs, failure
rate, and cost data.

Each runner is assigned a **health status** (Healthy, Unstable, or
Degraded) that surfaces runners needing attention based on their success
rate and relative performance compared to their group.

:::tip
  High average queue times may indicate your fleet needs scaling. If a
  runner shows a Degraded status, investigate potential infrastructure
  issues. Use the "vs Group" comparison to quickly spot outliers
  underperforming relative to their peers.
:::