You can query the catalog either through the API or the web frontend. In both cases, you query with a “query string”, which allows you to filter the results down or find artifacts of interest.
The “query string” follows a simple syntax:
- Any plain keyword is searched as a keyword (ie, “data” finds all artifacts with “data” in the metadata)
- Search against attributes with
<attribute_name>:<attribute_value>. This will match all attributes with that name/value pair. Additionally, you may use the
<=operators for comparison-based searching of attribute values.
- You may use groupings for attribute searches, such as
(robot_serial > 10 and robot_serial < 40). You may use the
orkeywords inside groupings.
- Search for specific artifact types with
type:<artifact_type>. For example,
type:logwill find all logs.
- Sorting by a particular column with
- Limiting the number of requests with
- Find artifacts belonging to a collection with
- Use the keywords failed, successful, or running to find all artifacts with jobs in one of those states.
It is expected that more keywords will be added over time.
As a quick example, here is a search for all logs that failed ingest:
Here is a search for all artifacts with the ‘jeep’ keyword in them and with the