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.

Build Insights dashboard homepage

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.

    Build insights: choosing an app

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.

Selecting a timeframe in Build Insights

You can choose to view the data on an hourly, daily, weekly, or monthly basis.

Insights Pro

With Insights Pro, the premium version of Build Insights, you have a couple of extra options:

  • You can set a custom timeframe.

  • 2-year data retention, compared to the 60 days you get with Basic.

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.

insights-workflows.png

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 in Insights.