You use search to find where specific items or other components are located. For example, you might want to search for enabled or disabled pipelines. Because if a pipeline is disabled, it cannot run.
What can I search
- Pipeline Dashboards, Custom Dashboards
- Gerrit Triggers and Servers
- Git Webhooks
- Docker Webhooks
- User Operations
- Trigger Activity for Gerrit, Git, and Docker
You can perform grid-based filter search on the Activity page for each trigger.
How does search work
|Where you search||Criteria to use for search|
|Pipeline Dashboards||Project, Name, Description, Tags, Link|
|Custom Dashboards||Project, Name, Description, Link (UUID of an item on the dashboard)|
|Executions||Name, Comments, Reason, Tags, Index, Status, Project, Show, Executed by, Executed by me, Link (UUID of the execution), and Input parameters, Output parameters, or Status message by using this format:
|Pipelines||Name, Description, State, Tags, Created by, Created by me, Updated by, Updated by me, Project|
|Endpoints||Name, Description, Type, Updated by, Project|
|Gerrit triggers||Name, Status, Project|
|Gerrit servers||Name, Server URL, Project|
|Git Webhooks||Name, Server Type, Repo, Branch, Project|
- Link is the UUID of a pipeline, execution, or widget on a dashboard.
- Input parameter, Output parameter, and Status message notation and examples include:
Example: statusMessage:Execution failed
- Status or state depends on the search page.
- For executions, possible values include: completed, failed, rollback_failed, or canceled.
- For pipelines, possible state values include: enabled, disabled, or released.
- For triggers, possible status values include: enabled or disabled.
- Executed, Created, or Updated by me refers to me, the logged in user.
|Methods you can use to search||How to enter it|
|Type a portion of the search parameter.
For example, to add a status filter that lists all the enabled pipelines, type ena.
|To reduce the number of items found, add a filter.
For example, to add a name filter type Tes. The filter works as an AND with the existing Status:disabled filter and only displays the disabled pipelines that have Tes in the name.
When you add another filter, the remaining options appear: Name, Description, Tags, Link, Project, and Updated by.
|To reduce the number of items displayed, click the filter icon on properties of a pipeline or a pipeline execution.
For example on the pipeline card, click the icon to add the filter for the SmartTemplate tag to the existing filters for: Status:Enabled, Project:test, Updated by:user and Tags:Canary.
|Use a comma separator to include all items in two execution states.
For example, type fa,can to create a status filter that works as an OR to list all failed or canceled executions.
|Type a number to include all items within an index range.
For example, type 35 and select < to list all executions with an index number less than 35.
|Pipelines that are modeled as tasks become nested executions and are not listed with all executions by default.
To show nested executions, type nested and select the Show filter.
How do I save a favorite search
You can save favorite searches to use on each page by clicking the disk icon next to the search area.
- You save a search by typing the parameters for search and clicking the icon to give the search a name such as my enabled.
- After saving a search, you click the icon to access the search. You can also select Manage to rename, delete, or move the search in the list of saved searches.
Searches are tied to your user name and only appear on the pages for which the search applies. For example, if you saved a search named my enabled for Status:enabled on the pipelines page, the my enabled search is not available on the Gerrit triggers page, even though Status:enabled is a valid search for a trigger.
Can I save a favorite pipeline
If you have a favorite pipeline or dashboard, you can pin it so that it always appears at the top of your pipelines or dashboards page. On the pipeline card, click.