bitrise.io

Build Insights

Published at 2021-09-30

Build Insights is a monitoring tool that allows you to track metrics detailing the performance of your Bitrise builds. Track your metrics on app-, Workflow-, and Step-level and use the data to optimize your builds. With the Insights tool, we are targeting three main areas:

Getting started with Insights

Insights constantly tracks the performance of all the apps of your Workspaces. You can get aggregated build data of all your apps on the Workspace’s Insights dashboard and you can view the list of apps belonging to that Workspace, allowing you to get to the detailed metrics of each app.

To get to your Insights dashboard:

  1. Log in to your Bitrise account.
  2. In the top right corner, open the account selector dropdown menu and select a Workspace.
  3. On the header, click Insights. This takes you to the Insights dashboard of the selected Workspace.

The Insights dashboard

On the dashboard, you can see aggregated build data of the selected Workspace. You have access to two main categories of metrics: build stats and build usage. Both display the aggregated metrics of all the Workspace’s apps for the selected timeframe.

You can switch between Workspaces at any time: in the top right corner, open the account selector dropdown menu and select a Workspace.

The Build stats section displays metrics such as average successful build time, total build count, or build usage.

The Build usage section allows you to view credit usage (for credit-based accounts) or build time usage (for concurrency-based accounts). You can choose between viewing the cumulative data, or interval-based data (for example, credit usage per each week throughout the last 8 weeks).

Getting the data of a specific app

On the Insights dashboard, choose an app to view its metrics.

  1. Find the app. You can either:
    • Search for the app’s name in the search bar.
    • Scroll down to the Apps section and find the app there.
  2. Click the app’s name.

Viewing data from a specific timeframe

By default, all Insights pages display your metrics on a weekly basis from the last 4 weeks. Modify the basis and timeframe by opening the respective dropdown menu in the top right of the page, and selecting the options you need.

You can choose to view the data on an hourly, daily, weekly, or monthly basis, and you can either select from pre-defined timeframes or set a custom timeframe.

App overview

Opening an app’s build monitoring in Insights takes you to the Overview page where you can see your app’s main metrics, build trends, and an overview of Workflow performance.

For more details and definitions of the metrics shown in the App overview page, see Available metrics.

Analyzing Workflow performance

To look at the performance data of each Workflow separately, scroll down to the Workflows section and click the Workflow you want to see.

On the Workflow page, you can see the same metrics as on the App overview page but filtered for the Workflow in question. You can also get detailed data on all the latest builds of that Workflow, and their aggregated metrics.

In the Steps section, you can check the build metrics for each Step of the Workflow separately.

For the details and definitions of the metrics shown on a given Workflow’s page, see Available metrics and Latest builds.

Available metrics

Basic build metrics

The following metrics are available on app-, Workflow, and Step level as well:

Successful build time

The Successful build time graph is available on both the App overview page and on any specific Workflow’s page. It displays how much time your successful builds took.

Latest builds

The Latest builds graph is available on the app overview page and on the page of a specific Workflow: it shows all latest builds - depending on your selected timeframe - that ran and the final statuses of that build. A red build is a failed build, a green build is a successful build.

You can check each of the builds individually to find out:

If you click on the colour bar representing a given build, you will be taken to the build log of that build.