Search Index
MaestroHub maintains a universal search index that enables fast, full-text search across all your entities. The Search Index page lets administrators monitor the health of this index and rebuild it when necessary.
Open the page from System Management > Search Index tab.
Automatic indexing — Under normal operation the search index stays up to date on its own. Every time an entity is created, updated, or deleted, the index is refreshed in real-time. Manual intervention is only needed after a system migration or if you suspect index corruption.
Index Statistics
The main card displays an overview of the current index state:
- Total Indexed Documents — the aggregate count of all documents currently in the search index.
- Counts by Entity Type — a breakdown showing how many documents are indexed for each entity type.
The following entity types are indexed:
| Entity Type | Description |
|---|---|
| Pipelines | Data pipeline definitions |
| Pipeline Nodes | Individual nodes within pipelines |
| Models | Data models |
| Connections | Configured data source and destination connections |
| Users | User accounts |
| Connection Functions | Functions associated with connections |
Click Refresh to reload the statistics from the server.
Rebuilding the Index
If the search index becomes out of sync — for example after a system migration, database restore, or unexpected shutdown — you can rebuild it from scratch.
Click Rebuild Index to start the process. The rebuild:
- Clears the existing search index for your organization.
- Fetches all entities from every module (pipelines, connections, models, users, and functions).
- Converts each entity into a searchable document.
- Writes the full set of documents into the index atomically.
While a rebuild is running, search results may be incomplete until the process finishes. The rebuild runs in the background and typically completes within seconds for most installations.
Monitoring Progress
Once a rebuild starts, a progress section appears below the statistics showing:
- Current phase — the step the rebuild is currently executing (fetching entities, building documents, or writing to index).
- Processed / Total — how many entities have been processed out of the total.
- Progress bar — a visual indicator of overall completion percentage.
When the rebuild completes, the progress section is replaced by a status line confirming the number of documents indexed and the total duration.
When to Rebuild
In most cases the automatic indexing keeps everything in sync. Consider a manual rebuild when:
- You have migrated MaestroHub to a new server or restored from a backup.
- Search results appear stale or incomplete.
- You have upgraded MaestroHub and the release notes recommend a reindex.
- The statistics show zero indexed documents when entities clearly exist.