Software delivery activity

7 minute read

The CloudBees platform Software delivery activity dashboard enables users to understand project development performance within a selected time frame and component set.

Details of the following are displayed:

  • Component, workflow, and run totals.

  • Commits and pull requests trends.

  • Code churn (code change rate).

  • Snapshot of code progression.

  • Percentages of successful builds and deployments.

  • Average development cycle times.

  • Average deployment time.

Use the following features to access the data on this dashboard:

  • Hover to display the full content for any data that is truncated with an ellipsis (…​).

  • Use scroll bars (vertical and horizontal) to display hidden content.

Access and filter software delivery activity

Select components and the time frame of data for analysis in the software delivery activity dashboard. By default, all components and the last seven days of data are displayed.

  1. Select Analytics  Software delivery activity.

  2. (Optional) Filter for the data you want to display by selecting the following:

    1. Select FILTER.

    2. Select one or more Components from the options.

    3. Select a Duration from the following options:

      Table 1. Duration filter definitions
      Duration Definition

      Current week

      Current week in the month, Monday to Sunday schedule. For example, if current day is Tuesday, only data from Monday and Tuesday are displayed.

      Previous week

      Previous week in the month, Monday to Sunday schedule.

      Two weeks back

      Two weeks prior in the month, Monday to Sunday schedule.

      Current month

      First day of current month up to current day.

      Previous month

      First day to last day of previous month.

      Two months back

      First day to last day of two months prior.

      Last 7 days

      The past seven days.

      Last 30 days

      The past 30 days.

      Last 90 days

      The past 90 days.

      Custom range

    4. Select APPLY.

The data are filtered accordingly and displayed in the software delivery activity dashboard.

Set a custom date range

To set a custom date range:

  1. Select FILTER.

  2. Select Custom range.

  3. Select dates for the time frame start and end.

The custom date range is set accordingly and displayed in blue on the date picker. You can view the analytics data for any desired time frame, as in the example below:

Custom time frame
Figure 1. Example Custom range selected.

Customize the dashboard

Customize the dashboard to display only the charts and tables that matter the most to you.

Only charts and tables with Delete in the upper-right corner can be edited.

To customize the dashboard:

  1. Select Analytics on the left pane, and then select the dashboard.

  2. Select Vertical ellipsis on the top right of the dashboard.

  3. Select Edit dashboard.

  4. (Optional) Remove a chart or table from the dashboard.

    1. Select Delete next to the chart or table you want to remove.

    2. Select Save.

  5. (Optional) Add back a chart or table to the dashboard.

    1. Select Add chart/table to display a list of the available charts or tables.

    2. Select Add to dashboard next to the item to add.

    3. Select Apply.

  6. (Optional) Rearrange items on the dashboard by dragging them into place.

The dashboard is customized accordingly.

Components, workflows, and runs information

Get an overview of components, workflows, and workflow runs for the filtered component data in a specified time frame.

As displayed below, the charts include totals, active, and inactive components and workflows. The runs chart displays total, successful, and failed runs.

Totals of components
Figure 2. Example Components, Workflows, and Workflow runs charts.

The charts display the following details:

  1. Total number.

  2. A donut chart of active vs inactive percentages.

  3. Numbers of active and inactive.

  4. Numbers of successful and failed.

  5. A stacked bar chart of numbers of successful vs failed runs, by date.

The Components chart also displays the number of associated repositories, and the Workflows chart displays the number of associated branches.

Select a number, or a section of the donut chart, to list:

  • Component name

  • Repository URL

  • Status

  • Last activity date and time

If you select a section of the donut chart, or the active or inactive numbers, the data displayed is for only that subset of components.

In the list, perform any of the following:

  • Select FILTER to filter by status.

  • Search for specific components by entering all or part of any column item into Search.

  • Select a component name to display runs from that component in a new browser tab.

Select a number, or a section of the donut chart, to list:

  • Workflow name

  • Component name

  • Branch name

  • Status

  • Last activity date and time

If you select a section of the donut chart, or the active or inactive numbers, the data displayed is for only that subset of workflows.

In the list, perform any of the following:

  • Select FILTER to filter by status.

  • Search for specific workflows by entering all or part of any column item into Search.

  • Select a component name to display runs from that component in a new browser tab.

Select a number or a stacked bar in the workflow runs chart to list:

  • Workflow name

  • Component name

  • Branch name

  • Run ID

  • Status

  • Run start time

If you select a stacked bar of the chart, or the success or failure numbers, the data displayed is for only that subset of runs.

In the list, perform any of the following:

  • Select FILTER to filter by status.

  • Search by entering all or part of any column item into Search.

  • Select a component name to display runs from that component in a new browser tab.

  • Select a run ID to display run details in a new browser tab.

Totals of runs
Figure 3. Example Workflow runs with Success status.

Get an overview of commit trends for the filtered component data in a specified time frame to better understand developer activity.

Commits trend

As in the example below, the Commits trend provides the number of commits grouped by date:

Commits overview
Figure 4. Example Commits trend chart.

The trend chart includes the following:

  1. Total commits: Select to display commits trend details.

  2. Active developers: Select to list the active developers and their total commits. Perform any of the following in the list:

    • Select FILTER to filter by author email.

    • Search by entering all or part of an author email into Search.

    • Select a commit number to display a list of the commits trend details for that author.

  3. Commits (scale on left y-axis).

  4. Weekly commits per active developers (scale on right y-axis).

Hover over a date to display the number of commits and weekly commits per active developer for that date, or select it to display the commits trend details on that date.

Commits trend details

The list of commits trend details includes the following:

  • Commit ID

  • Component name

  • Repository URL

  • Branch

  • Author email

  • Commit date and time

Commits list
Figure 5. Example commits trend details.

In the list, perform any of the following:

  1. Select FILTER to filter by component name or branch.

  2. Search by entering all or part of any column item into Search.

  3. Select a component name to display its runs in a new browser tab.

  4. Scroll to display the commit date and time.

Select the Pull request trend and Code churn charts

Hover over the Pull request trend and code churn charts to display the data with the date range.

commits list
Figure 6. Pull requests trend and Code churn charts.

Click on Code progression snapshot

Select the yellow bar to display the list of run-initiating commands.

code progression snapshot
Figure 7. Code progression snapshot.
run-initiating commits
Figure 8. Example list of Run-initiating commits.

Select the pie chart to display the total builds filtered by status.

run-initiating commits
Figure 9. Example list of total builds.

Explore commits trend, pull requests trend, and code churn

Select chart links to display details or update the display.

Charts 4 - 6 detailed
Figure 10. Example Commits trend, Pull requests trend, and Code churn charts.
  1. Commits trend: The total commits, active developers, and commits per active developer are displayed.

    • Select a data point to display the number of commits and commits per active developer for that date.

    • Select the Total commits number link to display a list of commits for the selected time frame. The list includes:

      • Commit ID

      • Component name

      • Repository

      • Branch

      • Author

    • Select a data label to show/hide its data on the chart. A grayed-out data label indicates that the data is hidden.

  2. Pull requests trend:

    • The total number of the following types of pull requests are displayed for each date in the selected time frame.

      • Approved

      • Changes requested

      • Open

      • Rejected

    • Select a bar to display the number of each type of pull request for that date.

    • Select the Total pull requests number link to display a list of pull requests for the selected time frame. The list includes:

      • Pull request ID

      • Component name

      • Repository

      • Source branch

      • Target branch

      • Status

      • Created date and time

    • Select a data label to show/hide its data on the chart. A grayed-out data label indicates that the data is hidden.

  3. Code churn: Total code additions and deletions are displayed for the selected time frame.

    • Select a data point to display the date’s number of additions and deletions.

    • Select a data label to show/hide its data on the chart. A grayed-out data label indicates that the data is hidden.

Explore the code progression snapshot

Run-initiating commits, builds, and successful deployments are all part of understanding code progression.

Code progression charts detailed
Figure 11. Example Code progression snapshot charts.
  1. Run-initiating commits: The gray bars display the distribution of run-initiating commits among environments.

    • Select the number link to display a list of commits that have started a run during the selected time frame. The list includes:

      • Commit ID

      • Commit description

      • Run ID

      • Status

      • Created date and time

      • Component name

      • Environment

Compare metrics

Use this feature to compare metrics among all organizations (orgs) and sub-organizations (sub-orgs) in the tenant. You can compare metrics within select charts in the analytics dashboards. In the generated list of all orgs/sub-orgs, sort by the org/sub-org name or its status. Select an org to drill down to the component level to display a more fine-grained status list. Hover over a status item to display more information.

You can only compare metrics for charts with Two arrows on the upper right.

To compare metrics:

  1. Select Analytics on the left pane, and then select a dashboard.

  2. Select any Two arrows on the upper right of a chart to display the list of orgs/sub-orgs and their status.

    The number of items in the compare metrics list equals the total displayed in the chart.
  3. (Optional) Hover over a status to display more information.

  4. (Optional) Select Sort down or Sort up next to a column heading to sort on that heading.

  5. (Optional) Select an org to list more information about each sub-org and/or component within that org.

  6. (Optional) Select a sub-org to list more details about each sub-org and/or component within that sub-org.

The list of the status of all orgs/sub-orgs/components for the specific metric is displayed.