CI Insights
Optimize your CI run time, catch flaky tests, and give developers actionable insights so your team ships code faster.
CI Insights helps you monitor your pipelines, detect flaky tests and jobs, and improve your CI efficiency. This guide walks you through enabling CI Insights via GitHub and covers basic configuration steps.
Understanding CI Insights
Section titled Understanding CI InsightsComponents
Section titled ComponentsSelf-hosted runners
Monitor your self-hosted runners’ capacity, performance, cost, and reliability.
Jobs
Monitor job health, duration, cost, and flaky behavior.
Auto-Retry
Automatically retry failed CI jobs caused by flaky tests or transient failures.
Job Selection
Skip the CI jobs a pull request does not need, using scopes.
Flaky Detection
Section titled Flaky DetectionCI Insights flags a flaky job when the same job, in the same pipeline, runs more than once on the same commit (SHA1) and the runs end with different conclusions, even though the code did not change. Cancelled runs are ignored, since a cancellation says nothing about the code.
A flaky test comes from the same kind of disagreement between repeated runs of one commit, or from a test that keeps failing now and then on new commits. See Health Status for how a test moves between healthy, flaky, and broken.
To set up systematic flaky test detection in your CI pipeline, see our dedicated Flaky Test Detection guide.
CI Setup Guides
Section titled CI Setup GuidesSelect your CI system below to enable CI Insights and configure flaky test detection.
Buildkite
Enable CI Insights & flaky test detection for Buildkite.
GitHub Actions
Enable CI Insights & flaky test detection for GitHub Actions.
Jenkins
Enable CI Insights & flaky test detection for Jenkins.
Test Framework Configuration
Section titled Test Framework ConfigurationTo capture test-level data from your CI pipeline, configure your test framework to upload results to Mergify. See the Test Engine test framework guides for framework-specific setup instructions.
Was this page helpful?
Thanks for your feedback!