Ingest statuses explained
Every upload, connector pull and Q&A pair becomes a job with two labels: a State (how far it has got) and a Stage (what the pipeline is doing). The Ingest status tab lists both, and refreshes itself every few seconds while anything on the page is running.
State — how far the job has got
| State | What it means | What you can do |
|---|---|---|
| Queued | Accepted, waiting for a worker to pick it up. | Wait. |
| Processing | A worker is running the Stage shown beside it. | Wait. The Progress bar reflects the state, not how much of the work is done. |
| Indexed | Finished. The content is in the index and answers can cite it. | Nothing. |
| Failed | The end of the road for this item — nothing further will happen to it. | Read the red Error tag beside the stage. |
Those four are the whole set.
Stage — where in the pipeline it is
| Stage | What is happening |
|---|---|
| Parsing | Reading the file and pulling out its text. |
| Chunking | Splitting that text into the passages an answer can cite. |
| Deduplicating | Checking those passages against what is already held. |
| Embedding | Turning each passage into something a question can match. |
| Indexing | Writing the result to the index. |
| Rendering preview | Building the preview shown when a document is opened. |
A Q&A pair only passes through Embedding and Indexing; its row is titled with the question and sub-labelled Q&A pair. Three further stages are housekeeping: Purging (clearing a deleted document), Reassigning access (applying changed access tags) and Superseded.
Superseded is not a failure
A row reading Indexed with the stage Superseded was overtaken — a newer version or a deletion landed while it ran. It carries no Error tag and nothing is missing.
Reading a failure
The Stage column keeps showing the stage that broke, so you can see where a job stopped. Hover or focus the Error tag beside it for a plain-language explanation plus the underlying message. There is no retry control — Elie already retries what is worth retrying, and once it stops the tag reads Automatic retries were exhausted — this needs attention from an administrator.
The same labels on Documents
A document carries its own overall status using those four labels, plus Deleting and Deleted while a removal is in flight. Its status filter accepts several values at once; the State filter on Ingest status takes one — select it again to clear it.
Next
- Uploading documents — where most of these jobs come from.
- Managing sources — jobs a connector creates.
- Knowledge Base troubleshooting — what to do about a Failed row.