Software delivery activity

6 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.

For any data that is truncated with an ellipsis (…​), hover to display the full content. Use the scroll bars (vertical and horizontal), if necessary, to view the full content.

Access and filter software delivery activity

Select components and the time frame of data for analysis in the software delivery activity dashboard.

  1. Select Analytics  Software delivery activity.

  2. 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 software delivery activity dashboard.

Set a custom date range

View analytics data for any desired time frame, as in the example below:

Custom time frame
Figure 1. Example Custom range selected.

To set a custom date range:

  1. Select FILTER.

  2. Select Custom range.

  3. (Optional) Select the Left chevron to go to a previous month and year.

  4. Select a date for the time frame start.

  5. (Optional) Select the Right chevron to go to a subsequent month and year.

  6. Select a date for the time frame end.

The custom date range is set accordingly and displayed in blue on the date picker.

Customize the dashboard

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

To customize the dashboard:

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

  2. Select the 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 the 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 FROM LIBRARY to display a list of the available charts or tables.

    2. Select ADD TO DASHBOARD next to the item you want.

    3. Select APPLY.

  6. (Optional) Rearrange the items on the dashboard.

    1. Select the Move icon on a chart or table you want to move.

    2. Drag the item to a different location on the dashboard.

System health and runs overview
Figure 2. Editing a dashboard, with move and remove icons highlighted.

The dashboard is customized accordingly.

Only those charts and tables with a in their upper-right corner can be edited.

Components, workflows, and runs information

Get an overview of components, workflows, and 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 3. 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 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 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 tab.

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

Totals of runs
Figure 4. 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 5. 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 6. 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 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 7. 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 8. Code progression snapshot.
run-initiating commits
Figure 9. Example list of Run-initiating commits.

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

run-initiating commits
Figure 10. 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 11. 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 12. 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