Search query syntax
In the list view of each entity kind (components, systems, etc.), you can search for entities using a simple query language.
Default search
If you search for a term without specifying an attribute, it will search within the qualified name of an entity (a combination of its namespace and name). For example:
This will find all entities that contain "my-component" in their qualified name.
Attribute search
You can also search for entities with specific attributes. The format is attribute:value. For example:
This will find all entities with "gateway" in their title.
The following attributes are available for filtering:
*: Full-text search across all fields (*:'some thing',*:foo).meta: Search in all metadata fields (name, namespace, title, description, labels, annotations, tags, links).name: The name of the entity.namespace: The namespace of the entity.title: The title of the entity.description: The description of the entity.tag: A tag associated with the entity.label: A label associated with the entity (searches both key and value).annotation: An annotation associated with the entity (searches both key and value).owner: The owner of the entity.system: The system that the entity is a part of (for components, apis, resources).type: The type of the entity (e.g., for components, apis, groups).lifecycle: The lifecycle state of the entity (e.g., for components and apis).
Operators
The following operators are supported for attribute searches:
:(contains): Checks if the attribute value contains the given search term (case-insensitive).~(regex): Matches the attribute value against a regular expression.
Example with regex:
Combining expressions
You can combine multiple expressions using AND and OR. Parentheses can be used for grouping. If no operator is specified, AND is used by default.
Examples:
Negation
You can negate an expression using !.
Example: