Using Insights

Language Icon 20 days ago · 3 min read
Cloud Server v4+
Contribute Go to Code

Overview

The CircleCI Insights dashboard provides an overview of the health and usage of your projects' build processes, including time-series and aggregated data on credit usage, success rates, and pipeline duration.

Insights is not a financial reporting tool, and should not be used for precise credit reporting. Credit reporting from Insights does not use the same source of truth as the billing information that is found in the Plan Overview page in the CircleCI web app, nor does the underlying data have the same data accuracy guarantees as the billing information. This may lead to discrepancies between credits reported from Insights, and the billing information in the Plan Overview page. For precise credit reporting, always use the Plan Overview page in the CircleCI web app.

Data is not real-time and there may be up to a 24 hour delay.

This document describes how to access and use the Insights dashboard on CircleCI cloud and server.

Usage

Insights across your organization can be accessed from the sidebar of the CircleCI web application.

To access a specific project’s Insights, view a pipeline’s workflow and click the Insights button. Alternatively, you may access the Insights page by opening a pipeline’s Actions menu while viewing the pipelines dashboard.

  • Access_by_sidebar

  • Access_by_workflow

  • Access_by_pipeline

Access insights from the CircleCI web app sidebar
Access insights from a workflow in the CircleCI web app
Access insights from a pipeline in the CircleCI web app

Workflow overview

The Insights workflow overview provides metrics plotted over time for all branches, or a select branch, of a particular project workflow. The following data is charted under the workflow overview:

  • Status (success versus failed) of up to 100 most recent workflow runs

  • Workflow success rate

  • Workflow duration (50th versus 95th percentile)

  • Workflow credit usage

Job overview

Select the Jobs tab next to Overview to view the following cumulative data on a per-job basis:

  • Total credits used

  • Duration (95th percentile)

  • Total runs

  • Success rate

See also

Refer to the Collect Test Data document for guidance on configuring Insights into your most failed tests.