View changeset graphs

A changeset graph visualizes streams and branches and their change history across multiple releases. You can filter changeset graphs and display changesets in groups.

Changeset health

A changeset graph provides development teams and release managers with a visual understanding of what changes are being worked on, where, and why. Plugins provide an opinion on the health of changes and an indication of release readiness.

Changeset health is displayed visually using a combination of the plugin opinions of the changes and the review state:

Icon Description
The changeset is currently healthy and the review was successful.
The changeset is not healthy or the review failed.
The changeset is unstable.
Plugins are currently running on the changeset.
Plugins are scheduled to run on the changeset.
No plugins ran on the changeset and no review is available.
The changeset was stopped.

When the review and plugin actions are completed, a changeset icon has a solid border, for example:

When the review or any plugins are in progress, a changeset icon has a cog wheel border, for example:

Back to top

View and filter changeset graphs

A changeset graph enables you to:

  • Visualize all your streams and branches in one place including merges. Each circle or group represents a changeset or a group of changesets.

  • Review the health and readiness of your changesets and determine if they are ready to be merged or released.

  • Watch in real time as streams and branches are branched, merged, and moved through the lifecycle.

When viewing a changeset graph, you can limit the displayed data to a set of streams or branches or a specific period of time.

To view and filter a changeset graph:

  1. On the top navigation bar, select a space from the spaces list.
  2. To view the graph for all products in the space, select Graph on the sidebar.

    To view the graph for a product or stream/branch, drill down to open the relevant product and then the branch. Then select Graph on the sidebar.

  3. To filter the displayed data, click the date filter on the toolbar and specify the following filtering options:

    Field Description
    Stream Name

    When viewing data for a product or space, you can limit the selection to specific streams or branches.

    Enter a wildcard pattern to match stream/branch names, for example, QLARIUS:JAV*. For multiple wildcard strings, separate each string with a comma.

    Tip: To hide specific streams or branches, add a minus character (-) at the start of the string, for example: -*JAV*.

    Start Date / End Date Select a predefined date range. To display data for a custom time period, select Since or Until and pick a date in the calendar.

    For Dimensions CM streams, select additional options, as needed:

    • Include favorites only.

    • Exclude topic streams.

    • Include parent streams.

  4. Click Apply. The view refreshes and displays the data that matches your filters.

  5. (Optional) Sort the streams and branches on the graph by name, creation date, last activity, or in ascending or descending order.

  6. (Optional) To make the view more compact, group changesets on a graph by days or weeks. On the toolbar, click Changeset, and select a grouping option, Daily or Weekly.

    The number of changesets in a group is indicated as follows:

  7. Use the graph to view the changeset details:

    Action Description
    Hover over a branch label

    Displays the changeset history for the stream/branch and for Git tags.

    Hover over a changeset

    Displays the changeset summary, including the user who delivered the change, delivery date and time, stream version, chain result, and review state.

    Highlights the merge lines that connect the changeset to other changesets.

    Click a changeset,
    CTRL+click multiple changesets

    Displays the details of one or more changesets:

    • The changeset number and description.
    • The stream or project version that owns the changeset.
    • The user whose delivery created the changeset.
    • The date and time the changeset was created.
    • The review created by the delivery.

      Hover over the review to display the review's current state. Click the review to open the review page.

      Administrators only: If a changeset did not create a review automatically, click Create Review to create one manually.

    • The result of the chain that ran on the changeset.
    Point to a changeset group Displays the stream version range and the result of the chains that ran on the most recent changeset.

Back to top

See also: