> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Ingestion runs

> Track every import: status, timing, who triggered it, and full structured logs.

An **ingestion run** is a single execution of the ingestion pipeline — the record of
when a file was imported, parsed, and promoted into Solya's data model. Runs give you
full visibility into what happened during each import and make it easy to diagnose
problems.

## Run statuses

| Status      | Meaning                                                          |
| ----------- | ---------------------------------------------------------------- |
| **Pending** | The run has been requested and is queued.                        |
| **Running** | The import is in progress.                                       |
| **Success** | The import completed successfully.                               |
| **Failed**  | The import stopped on an error — see the logs and error message. |

## How a run is triggered

* **Manual** — a user starts it from the app.
* **Scheduled** — it runs automatically on a schedule.
* **API** — it's started by an external call.

## What a run shows

* **Status** and the **trigger type** (manual / scheduled / API).
* **Who triggered it** — the user, when applicable.
* **Timing** — when it was requested, started, and completed.
* **Structured logs** — timestamped entries at `Debug`, `Info`, `Warn`, and `Error`
  levels emitted during the import.
* **Error message** — a readable explanation when a run fails.

## Working with ingestion runs

<Steps>
  <Step title="Open the runs page">
    Go to **Data platform → Data sources → Ingestion runs** to see the history of all
    imports. Filter by status, date range, trigger type, or who started the run.
  </Step>

  <Step title="Start a run">
    Trigger a new import with **Run ingestion**. Its status moves from *Pending* to
    *Running*, then to *Success* or *Failed*.
  </Step>

  <Step title="Inspect a run">
    Open a run to read its full logs, timing, and any error message in the detail view.
  </Step>

  <Step title="Diagnose failures">
    For a failed run, the error message and `Error`-level log entries tell you what
    went wrong so you can fix the source file or the
    [ingestion spec](/en/data-layer/ingestion-spec) and retry.
  </Step>
</Steps>