Find executions

Tens of thousands of pipelines might execute in a production environment in a short time period. Use the following controls on the Pipeline executions page to find a pipeline of interest:

  • Select the smallest time period possible to reduce the number of executions in the list.
    Note: The time period filter is available only in the Not-running pipelines table.
  • Click the arrow on a sortable column, , to sort ascending or descending.
  • Use the Filter presets or click the funnel icon on a specific column to filter it. You can filter the Type, Status, and Project
    Note: The Filter presets is available only in the Not-running pipelines table.
  • Click Table configuration and filters to open the Table configuration and filters dialog where you can hide or show columns and set filters.

Filters apply to searches and the execution list for the current session. To remind you that filters are active, the filter icon fills, , and a dot decorates the Table configuration and filters control, .

The following sections describe how to:

Clear filters

To clear filters, do any of the following:
  • Click an active preset filter to clear it.
  • Clear specific filters or all filters from the Table configuration and filters control, . Unset specific filters or click Clear all filters, and click Apply.
  • Clear a column filter by clicking its filter icon , . For the multi-select Status and Project column filters, clear values individually or by clicking the select all checkbox twice. For the Type column filter, select All.

Use search

Enter all or part of a pipeline name, task name, or owner email address in the Search box. After a search, the page URL contains the search string, filters, and column preferences. You can bookmark it to perform the same search later or copy it to share with colleagues.

You can also use the search box to search by pipeline parameters, for parent and child executions, or by RUUID.

Find failing or failed executions

Find failed executions in one of the following ways:

  • Click the Errors filter preset. This selects all executions with a status of failed or completed with errors.
  • From the Status column:
    1. Click the filter icon, .
    2. Select Failing (available in the Running pipelines table) or Failed (available in the Not-running pipelines table).
  • From the Table configuration and filters control, :
    1. Scroll to the Status column.
    2. Select Failing (available in the Running pipelines table) or Failed (available in the Not-running pipelines table).
    3. Click Apply.

Use multiple filters

You can apply multiple filters with the Filter presets (available in the Running pipelines table), by clicking on individual columns, or from the Table configuration and filters dialog:

  1. On the right side of the table header, click the Table configuration and filters control, .
  2. Select the appropriate filter values.
  3. Click Apply.

Find by project

Find the execution of a pipeline from a specific project in one of the following ways:

  • From the Project column:
    1. Click the filter icon, .
    2. Select shared, a Project space, or expand a Project space to select individual projects.
  • From the Table configuration and filters control, :
    1. Scroll to the Project column.
    2. Click Select All, shared, a Project space, or expand a Project space to select individual projects.
    3. Click Apply.

The filter includes executions in projects for which you have at least read permission. Enter a term in the Search bar to search the filtered projects.

Search by pipeline parameters

From the Search box, you can search by parameter for pipelines that are invoked by a task or as child pipelines by a Pipeline Execute Snap. The search returns pipeline executions based on the captured pipeline parameter values and error parameter values configured in the pipeline properties. The search string is case-insensitive and if a status filter isn't active, returns a list of all matching executions regardless of their status. If a status filter is active, the execution list matches the filtered statuses.

To search pipelines using parameter values, the following must be true:

Find by invocation type

You can filter by one invocation type at a time. Find an execution by invocation type in one of the following ways:

  • From the Type column:
    1. Click the filter icon, .
    2. Select the invocation type.
  • From the Table configuration and filters control, :
    1. Scroll to the Type column.
    2. Select an invocation type.
    3. Click Apply.
The Type column filter includes the following options:
Filter by type

Search for parent and child pipeline executions

With the Nested option selected, when you enter a term in the Search box, the Show all children option appears in the table header. If checked, a search that returns a parent execution also returns all children regardless of whether they meet the search criteria. If unchecked, a search that returns a parent execution only returns children that match the search criteria.

In the image below, the Show all children option is enabled. The child executions don't match the search term copy, but they do display with the parent execution expanded.


Show all children option enabled.

In the image below, the Show all children option is disabled. With the ExpressionPipelineCopy execution expanded, only the child execution that matches the search term, copy, displays.


Show all children option disabled.

Search by runtime ID (RUUID)

To search by RUUID, add the prefix pipe_runtime_id= in the search string. For child executions, expand the parent as many levels as necessary. To simplify locating a child execution, clear the Show all children checkbox, which reduces the result tree to just children that match search term.