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 changeset graphs

A changeset graph enables you to:

  • Visualize all your streams, branches, and projects in one place including branches and 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.

To view a changeset graph:

  1. From the spaces list at the top right, select a space.
  2. To restrict the scope of the search, drill down to open the relevant product, Git repository, or stream/branch.
  3. In the sidebar, select Changeset Graph.

  4. (Optional) Filter the information displayed on the graph, as described in Filter a changeset graph or history.

    Additionally, you can sort the streams and branches on the graph by name, creation date, last activity, and in ascending or descending order.

  5. (Optional) You can group changesets by days or weeks. For details, see Group changesets.

  6. Use the graph to view the changeset details:

    Action Description
    Hover over a stream's label Displays the changeset history for the stream/branch.
    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

Filter a changeset graph or history

Filter a changeset graph or history view to limit the displayed data. You can focus on a specific option, set of streams/branches, or period of time.

To filter a changeset graph or history:

  1. From the spaces list at the top right, select a space.
  2. To restrict the scope of the search, drill down to open the relevant product, Git repository, or stream/branch.
  3. In the sidebar, select Changeset Graph or Changeset History.

  4. To filter the displayed data, click the date filter and specify the following selection criteria:

    Field Description
    Stream Name

    Enter a wildcard 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 view data for a custom time period, select Since or Until and pick a date in the calendar.
    Options

    Select additional options, as needed:

    • Include favorites only.

    • Exclude topic streams.

    • Include parent streams.

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

Back to top

Group changesets

To make the view more compact, group changesets on a graph by days or weeks.

The number of changesets in a group is displayed at the top right, for example:

To modify how changesets are displayed by default, see Set changeset graph and date range defaults.

To view changesets as groups:

  1. From the spaces list at the top right, select a space.
  2. To restrict the scope of the search, drill down to open the relevant product, Git repository, or stream/branch.
  3. In the sidebar, select Changeset Graph.

  4. To group changesets by days or weeks, click Changeset in the toolbar and select a grouping option, Daily or Weekly.

Tip: Use keyboard shortcuts to navigate around the page. For details, see Keyboard shortcuts.

Back to top

See also: