diff --git a/doc/user/content/ingest-data/troubleshooting.md b/doc/user/content/ingest-data/troubleshooting.md index d6ef5947f29c7..45ef2033e226f 100644 --- a/doc/user/content/ingest-data/troubleshooting.md +++ b/doc/user/content/ingest-data/troubleshooting.md @@ -38,15 +38,14 @@ SELECT * FROM mz_internal.mz_source_statuses WHERE name = ; ``` -If your source reports a status of `stalled` or `failed`, you likely have a -configuration issue. The returned `error` field will provide more details. -If your source reports a status of `starting` for more than a few minutes, -[reach out to our team](http://materialize.com/convert-account/) for support. - -If your source reports a status of `running`, but you are not receiving data -when you query the source, the source may still be ingesting its initial -snapshot. See [Has my source ingested its initial snapshot?](#has-my-source-ingested-its-initial-snapshot). +| Status | Description/recommendation | +|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| +| `paused` | Source is running on a cluster with 0 replicas. To resolve this, [increase the replication factor](/sql/alter-cluster/#replication-factor-1) of the cluster. | +| `stalled` | You likely have a configuration issue. The returned `error` field will provide more details. | +| `failed` | You likely have a configuration issue. The returned `error` field will provide more details. | +| `starting` | If this status persists for more than a few minutes, [reach out to our team](http://materialize.com/convert-account/) for support. | +| `running` | If your source is in a `running` state but you are not receiving data when you query the source, the source may still be ingesting its initial snapshot. See [Has my source ingested its initial snapshot?](#has-my-source-ingested-its-initial-snapshot). | ## Has my source ingested its initial snapshot? diff --git a/doc/user/content/sql/system-catalog/mz_internal.md b/doc/user/content/sql/system-catalog/mz_internal.md index c328ed6dcb072..6d6745c4379c1 100644 --- a/doc/user/content/sql/system-catalog/mz_internal.md +++ b/doc/user/content/sql/system-catalog/mz_internal.md @@ -1150,7 +1150,7 @@ debugging. | `name` | [`text`] | The name of the source. | | `type` | [`text`] | The type of the source. | | `last_status_change_at` | [`timestamp with time zone`] | Wall-clock timestamp of the source status change. | -| `status` | [`text`] | The status of the source: one of `created`, `starting`, `running`, `stalled`, `failed`, or `dropped`. | +| `status` | [`text`] | The status of the source: one of `created`, `starting`, `running`, `paused`, `stalled`, `failed`, or `dropped`. | | `error` | [`text`] | If the source is in an error state, the error message. | | `details` | [`jsonb`] | Additional metadata provided by the source. In case of error, may contain a `hint` field with helpful suggestions. | @@ -1165,7 +1165,7 @@ messages and additional metadata helpful for debugging. | -------------- | ------------------------------- | -------- | | `occurred_at` | [`timestamp with time zone`] | Wall-clock timestamp of the source status change. | | `source_id` | [`text`] | The ID of the source. Corresponds to [`mz_catalog.mz_sources.id`](../mz_catalog#mz_sources). | -| `status` | [`text`] | The status of the source: one of `created`, `starting`, `running`, `stalled`, `failed`, or `dropped`. | +| `status` | [`text`] | The status of the source: one of `created`, `starting`, `running`, `paused`, `stalled`, `failed`, or `dropped`. | | `error` | [`text`] | If the source is in an error state, the error message. | | `details` | [`jsonb`] | Additional metadata provided by the source. In case of error, may contain a `hint` field with helpful suggestions. |