Pipeline Run Details View

This site is the new docs site currently being tested. For the actual docs in use please go to https://www.jenkins.io/doc.

The Blue Ocean Pipeline Run Details view shows the information related to a single Pipeline Run, and allows users to edit or replay that run. Below is a detailed overview of the parts of the Run Details view.

Blue Ocean status

Blue Ocean will not receive further functionality updates. Blue Ocean will continue to provide easy-to-use Pipeline visualization, but it will not be enhanced further. It will only receive selective updates for significant security issues or functional defects.

Alternative options for Pipeline visualization, such as the Pipeline: Stage View and Pipeline Graph View plugins, are available and offer some of the same functionality. While not complete replacements for Blue Ocean, contributions are encouraged from the community for continued development of these plugins.

The Pipeline syntax snippet generator assists users as they define Pipeline steps with their arguments. It is the preferred tool for Jenkins Pipeline creation, as it provides online help for the Pipeline steps available in your Jenkins controller. It uses the plugins installed on your Jenkins controller to generate the Pipeline syntax. Refer to the Pipeline steps reference page for information on all available Pipeline steps.

Overview of the Pipeline Run Details
  1. Run Status - An icon indicating the status of this Pipeline run. The color of the navigation bar matches the status icon.

  2. Pipeline Name - The name of this run’s Pipeline.

  3. Run Number - The id number for this Pipeline run. Id numbers are unique for each Branch and Pull Request of a Pipeline.

  4. View Tabs - Access the Pipeline, Changes, Tests, and Artifacts views with one of the tabs for this run. The default view is "Pipeline".

  5. Re-run Pipeline - Execute this run’s Pipeline again.

  6. Edit Pipeline - Open this run’s Pipeline in the Pipeline Editor.

  7. Configure - Open the Pipeline configuration page in Jenkins.

  8. Go to Classic - Switch to the "Classic" UI view of the details for this run.

  9. Close Details - Closes the Details view and returns the user to the Activity view for this Pipeline.

  10. Branch or Pull Request - The branch or pull request for this run.

  11. Commit Id - The commit id for this run.

  12. Duration - The duration of this run.

  13. Completed Time - When this run was completed.

  14. Change Author - Names of the authors with changes in this run.

  15. Tab View - Shows the information for the selected tab.

Pipeline Run Status

Blue Ocean makes it easy to see the status of the current Pipeline Run, by changing the color of the top menu bar to match the status:

  • Blue for "In progress"

  • Green for "Passed"

  • Yellow for "Unstable"

  • Red for "Failed"

  • Gray for "Aborted"

Special cases

Blue Ocean is optimized for working with Pipelines in Source Control, but can display details for other kinds of projects. Blue Ocean offers the same tabs for all supported projects types, but those tabs display different information depending on the type.

Pipelines outside of Source Control

For Pipelines that are not based in Source Control, Blue Ocean shows the "Commit Id", "Branch", and "Changes", but those fields are left blank. In this case, the top menu bar does not include the "Edit" option.

Freestyle Projects

For Freestyle projects, Blue Ocean offers the same tabs, but the Pipeline tab only displays the console log output. The "Rerun" or "Edit" options are not available in the top menu bar.

Matrix projects

Matrix projects are not supported in Blue Ocean. Viewing a Matrix project will redirect to the "Classic UI" view for that project.

Tabs

Each tab of the Run Detail view provides information on a specific aspect of a run.

Pipeline

Pipeline is the default tab and gives an overall view of the flow of this Pipeline Run. It shows each stage and parallel branch, the steps in those stages, and the console output from those steps. The overview image above shows a successful Pipeline run. If a particular step during the run fails, this tab automatically defaults to showing the console log from the failed step. The image below shows a failed Run.

Failed Run

Changes

The Changes tab displays the information of any changes made between the most recently completed and current runs. This includes the commit id for the change, change author, message, and date completed.

List of Changes for a Run

Tests

The Tests tab shows information about test results for this run. This tab only contains information if a test result publishing step is present, such as the "Publish JUnit test results" (junit) step. If no results are recorded, this table displays a message. If all tests pass, this tab will report the total number of passing tests. If there are failures, the tab will display log details from the failures as shown below.

Test Results for Unstable Run

When a previous run has failures, and the current run fixes those failures, this tab notes the fixes and displays their logs.

Test Results for Fixed Run

Artifacts

The Artifacts tab shows a list of any artifacts saved using the "Archive Artifacts" (archiveArtifacts) step. Selecting an item in the list downloads it. The full output log from the Run can be downloaded from this list.

List of Artifacts from a Run