Overview

The Pipeline History displays a list of all runs executed by a pipeline. It also renders a real time, interactive, diagram of the pipeline and the results of its most current run.


Choosing a Pipeline

To display the Pipeline History, go to Working with Pipelines, then click on one of the pipelines in the list.

Once you are viewing the Pipeline History, you can change which pipeline to display through the dropdown at the top of the view.

Selecting a Branch

When a pipeline source has been configured as multibranch, you can select which branch's pipeline to view through a dropdown at the top of the view.


Viewing a Pipeline

The pipeline diagram is an interactive, visual representation of the pipeline config. Resources are displayed as circular icons, while steps are displayed in rectangles.

You can perform the following operations in the pipeline diagram:


Searching a Pipeline

Click the search icon on the top-left corner to open the search bar. 

The search bar shows the list of objects matching the search text and displays them in a dropdown list.

Once you select an item from the dropdown, the matching item in the diagram will be brought to the center and highlighted with a yellow border. If the item appears in the diagram more than once, you can cycle through them using the arrow icons on the search bar or keyboard shortcuts (enter to iterate forward, shift + enter to iterate backward).

To close the search bar, either click the x icon on the search bar or use the keyboard shortcut esc when the search input is focus.

Filtering a Pipeline

Use the filter field to filter pipelines by status. You can select multiple statuses and all the pipelines matching the selected status is highlighted. In addition, the number of pipelines matching each status is displayed next to the filter field.


Refresh page to play Gif

Zooming a Pipeline

While the diagram gives you a full view of your entire pipeline, you might want to zoom in to focus on specific sections in detail.

Click the  button to expand the pipeline diagram and enter zoom mode.

You can zoom in or out of any part of the pipeline with your mouse scroll wheel or with pinch-to-zoom on your mouse keypad:

Click the  button to reset the zoom level.

Click the  button to exit zoom mode.

Information about a Step or Resource

Click on any of the pipeline elements to display summary information about that element.

Triggering and Canceling a Step

You can click any step to manually trigger a step or cancel one that has been triggered.

For more information on these facilities, see Running a Pipeline.

View Pipeline YAML

Click the button to to view the pipeline config in a pop-up window.

Open Pipeline Source

Click the  button to open a new tab in your web browser for the GitRepo pipeline source where the pipeline config is stored.

Viewing all Runs

The Runs section of the pipeline view lists every run of the pipeline.

Status
The completion status of the run.
Run Number
The sequential number of the run in the history.
Duration
The total execution time of the run.
Triggered At
Date and time that the run commenced execution.
Triggered By
  • For runs that were created due to a source control event such as, commit/pr/tag/release, the user who triggered the run is shown.
  • For manual triggers, the user who manually triggered the run is shown.
Context
Shows whether the run was triggered automatically (by a commit) or manually.

Filtering the Runs

Select the filter in the dropdown box to list only those runs in the history whose outcome matches a particular status. The filter defaults to "All" to display all runs in the history.

Viewing Specific Runs

Click one of the runs to view more details about it. The table lists all the steps for the run, and can be filtered and/or sorted based on each column.

Viewing Resources

The Resources tab lists all the input and output resources for a run. 

Click the View  icon to view more information about a resource. Depending on the resource, you can even view the commit information for the yaml file that is used in the step.

Viewing Run Logs

Click the row of any run to invoke the Pipeline Run Logs view for that run. In that view, you can browse the log of execution, test results, and other information for steps in the pipeline.

You can also invoke the Pipeline Run Logs view for the most current run by clicking a step in the pipeline diagram, then in the resulting information box for that step click "View Logs".