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.
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.
Viewing 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.
Viewing Step History
To view the history of a step, such as when the step was last executed and to filter a step based on its status:
- Click the step.
- Click Step History.
This displays the Step History window.
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.
Deleting a Pipeline
Since a pipeline is associated with its respective pipeline source, to delete a pipeline, delete the pipeline source. For more information, see Deleing a Pipeline Source.
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 |
|
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 Steps
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 Pipeinfo
Click the Pipeinfo tab to view the head.json for the run. This JSON file provides a complete trace for your run. For more information, see Signed Pipelines.
This information is only available after the run reaches terminal state.
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".
