Search
Find pipelines, connections, topics, dashboards and other entities in a workspace with Ctrl+K, and rebuild the search index when results look wrong.
- Shortcut
- Ctrl+K · ⌘K on macOS
- Rebuild permission
- universalsearch:rebuild
Global search finds entities in your current workspace by name and content. It reads from a search index that MaestroHub keeps up to date on its own.
Open search
- Press Ctrl+K (⌘K on macOS) on any page.
- Or type in the Find anything field at the right end of the top bar. It shows matching pages and entities as you type. Press Enter with no result highlighted to open the full search dialog.
In the dialog, use ↑ and ↓ to move through the results, Enter to open one, and Esc to close.
What search finds
Search covers these entities in the current workspace:
| Filter | What it finds |
|---|---|
| Pipelines | Pipeline definitions |
| Connections | Configured connections |
| Functions | Functions defined on a connection |
| Global functions | JavaScript functions in the workspace's function library |
| UNS Topics | Topics in the Unified Namespace |
| Dashboards | Dashboards |
| Apps | App Studio apps (App Studio is in release 3.0 as Beta, a paid add-on) |
Use the filter buttons under the search box to narrow the results to one type. If your entities carry labels, you can also filter by a label.
Results show only the entities you have permission to read.
Search index health
The footer of the search dialog shows how many documents the index holds, for example 1240 indexed. Click it to see the count for each entity type.
New, changed and deleted entities are indexed automatically. MaestroHub also rebuilds a workspace's index by itself when it starts and finds that index empty, for example after an upgrade.
Rebuild the index
Rebuilding clears the workspace's search index and indexes every entity again from the current data.
- Press Ctrl+K (⌘K on macOS) to open search.
- Click the indexed count in the footer.
- Click Rebuild index.
The footer shows Rebuilding index… with a percentage while the rebuild runs, and a message confirms the number of indexed documents when it finishes. The rebuild keeps running if you close the dialog. Search results can be incomplete until it finishes.
You need the universalsearch:rebuild permission to rebuild the index. The Workspace Administrator and System Administrator roles have it. Without it, the popover shows Rebuilding requires an administrator. instead of the button.
When to rebuild
Rebuild the index when:
- An entity you know exists does not appear in search results.
- Search results show names or content that changed a while ago.
- The indexed count is zero while the workspace has entities.