This is an automated email from the ASF dual-hosted git repository. hubcio pushed a commit to branch docs/align-with-topic-durability in repository https://gitbox.apache.org/repos/asf/iggy-website.git
commit 19149d5a044a122dfdcc00967a74ad1a3ccd3e2e Author: hubcio <[email protected]> AuthorDate: Sat Sep 12 03:35:51 2026 +0200 fix(docs): explain Quickwit startup readiness --- content/docs/connectors/sinks/quickwit.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/docs/connectors/sinks/quickwit.mdx b/content/docs/connectors/sinks/quickwit.mdx index d572c3f9..9b571e00 100644 --- a/content/docs/connectors/sinks/quickwit.mdx +++ b/content/docs/connectors/sinks/quickwit.mdx @@ -118,7 +118,7 @@ curl --fail --get http://localhost:7280/api/v1/events/search --data-urlencode 'q | `max_retries` | `3` | Total HTTP attempts including the first; `0` and `1` both allow one attempt | | `retry_delay` | `"1s"` | Base exponential delay for HTTP retries and readiness probes | | `retry_max_delay` | `"5s"` | Cap for calculated HTTP retry delays; a valid `Retry-After` on HTTP 429 overrides it | -| `max_open_retries` | `10` | Total readiness attempts including the first; `0` and `1` both allow one attempt | +| `max_open_retries` | `10` | Total attempts per readiness check including the first; `0` and `1` both allow one attempt | | `open_retry_max_delay` | `"30s"` | Cap for calculated readiness retry delays | | `timeout` | `"30s"` | Timeout per HTTP attempt; retries and their waits can make an operation take longer | @@ -126,6 +126,8 @@ Durations require units and must be positive; invalid or zero durations prevent Readiness uses `GET /health/readyz`, retrying any failed probe. The index check uses `GET /api/v1/indexes/<index_id>`; only a 404 triggers creation with `POST /api/v1/indexes`. If creation receives an error status, a successful index recheck allows startup to continue. A successful existence check does not validate the supplied mapping against the existing one. Requests retain any path prefix from `url`. +After verifying or creating the index, the sink probes the ingest endpoint with an empty body before accepting messages. This waits for the queue on Quickwit versions that return 404 while it starts. These probes submit no documents and retry HTTP 404, 429, 5xx and network failures. Each readiness check uses `max_open_retries` and `open_retry_max_delay`. + ## Payload Shapes The sink does not add Iggy IDs, offsets, timestamps or headers. It serializes the payload after runtime decoding and transforms:
