Indexverwaltung
Überwachung der Indexintegrität, Auslösen von Neuindizierungen, Verwalten von Delta-Synchronisierungen und Anzeigen von Synchronisationsinformationen.
The Index Management page at /[orgSlug]/search/[indexSlug]/indexing provides tools for monitoring and maintaining your search index. It covers index health metrics, reindex operations, delta synchronization, and sync history.
Index status cards
The top section shows four summary cards with real-time metrics for the selected index:
| Card | Data source |
|---|---|
| Documents | Total document count in the collection |
| Searches today | Search requests served today |
| Size | Storage size in MB/GB (if available) |
| Avg. latency | Mean search response time in milliseconds |
A badge next to the index name indicates whether the collection is Live (serving traffic).
Health chart
A 7-day bar chart compares:
- Documents — total document count (static across the period)
- Searches — daily search request volume
This gives a quick visual sense of whether search usage is growing or declining.
Last sync info
Shows when the last full sync completed. This is derived from the most recent sync_job activity event for the index. A timestamp of "never" indicates no sync has been recorded yet.
Full reindex
The Full Reindex panel lets you rebuild an index with zero downtime. It creates a new versioned search index ({orgShortId}_{slug}_v{n+1}), populates it from the current data source, verifies it, and atomically swaps the alias so the new version starts serving traffic immediately.
When to reindex
- After changing the collection schema (e.g. adding a new searchable field)
- After modifying stopword lists
- After a major data migration or bulk document update
- To recover from a corrupted or inconsistent collection state
Advanced options
Click Show advanced to configure additional reindex behavior:
| Option | Description |
|---|---|
| Detect schema | Re-detect the collection schema from the current data |
| Regenerate embeddings | Recompute AI embeddings for all documents |
Progress tracking
After triggering a reindex, the panel shows real-time progress:
- Status — pending, running, completed, or failed
- Progress bar — percentage of the job completed
- Cancel — abort a running reindex if needed
The reindex job ID is tracked and polled every 3 seconds until completion.
Delta sync
The Delta Sync panel synchronizes only the changes since the last sync operation, rather than rebuilding the entire index. This is faster and more efficient for incremental updates.
When to use delta sync
- After the CMS connector has pushed new or updated documents
- To process pending items in the
SearchIngestBuffertable - For regular, scheduled synchronization (e.g., hourly)
Results
After a delta sync completes, the panel shows:
| Metric | Description |
|---|---|
| Processed | Total items processed |
| Upserted | Documents created or updated |
| Deleted | Documents removed |
| Remaining | Items still pending in the buffer |
Delta sync vs. full reindex
| Aspect | Delta sync | Full reindex |
|---|---|---|
| Scope | Changed documents only | All documents |
| Speed | Fast (seconds to minutes) | Slow (minutes to hours) |
| Downtime | None (no alias swap) | Zero-downtime (alias swap) |
| Schema changes | Not affected | Rebuilt with new schema |
| Use case | Daily incremental updates | Schema changes, major migrations |
Reindex history
The page maintains a record of past reindex operations. Each entry shows:
| Column | Description |
|---|---|
| Job ID | Unique identifier for the job |
| Status | pending / running / completed / failed |
| Started at | When the job was initiated |
| Completed at | When the job finished (if done) |
| Error message | Error details (if failed) |
API reference
Index management operations are available as oRPC procedures in packages/api/modules/indexing/:
| Procedure | Description |
|---|---|
indexing.reindex | Start a full reindex |
indexing.deltaSync | Run incremental delta sync |
indexing.cancelReindex | Cancel a running reindex |
indexing.reindexStatus | Poll reindex job status |
indexing.reindexHistory | List past reindex jobs |
indexing.healthStats | Get index health statistics |
indexing.schedule.list | List scheduled reindex tasks |
indexing.schedule.create | Create a scheduled reindex |