docs(loki): weekly docs triage 2026-09-21 – 2026-09-29 — 5 items

Created by the docs-workforce automation (AI-assisted docs triage) from recently merged PRs in grafana/loki. Verify each item against the code before acting.

What needs docs

1. Docs needed (entirely missing)

• Logline targets and query filtering — no mentions under docs/sources/. New targets/config land as experimental and user-invisible (yaml:"-", UserInvisibleTargetableModule), but CLI flags exist (-logline-builder.*, -logline-query.*, -logline-correctness.*). Confirm with engineering whether public docs should wait. Affected pages (if publishing): new conceptual/config pages under docs/sources/ plus generated config via docs/templates/ → make doc (do not hand-edit docs/sources/shared/configuration.md). Originating PRs: #24480, #24727, #24799.
• Operator: flush_on_shutdown + ingester terminationGracePeriodSeconds — #24325 changes operator-managed Loki defaults. No matching coverage found under operator/docs/. Outside docs/sources/ — docs-workforce cannot edit this path; needs a human/operator-docs owner.

2. Docs update needed (existing pages incomplete)

• docs/sources/setup/upgrade/_index.md (+ LogQL error/grouping docs) — #24712 is a breaking LogQL change: errored metric samples now keep the grouped label set (plus __error__ / __error_details__ / __preserve_error__) instead of the full stream+metadata set. PR checklist left upgrade docs unchecked. Also review docs/sources/query/query_reference.md, docs/sources/query/metric_queries.md, and docs/sources/shared/troubleshoot-query.md for grouping + pipeline-error wording.
• docs/sources/setup/upgrade/_index.md + docs/sources/reference/loki-http-api.md (push) — #22566 makes unknown JSON fields on /loki/api/v1/push and legacy /api/prom/push return HTTP 400 (DisallowUnknownFields). Labeled next major release / 4.0. Push API docs do not state that unknown fields are rejected.

3. Needs engineering input

• Logline publish readiness — should public docs document logline-index-builder / logline-correctness / logline.query while config remains yaml:"-" and targets are user-invisible? (#24480, #24727, #24799)
• Timing for #22566 — document under current upgrade notes now, or only when the 4.0 upgrade section is written?
• Generated config — docs/sources/shared/configuration.md is auto-generated (make doc from docs/templates/). Config-reference gaps must be fixed in the template/generator path, not by hand-editing the shared file. docs/sources/configure/_index.md only includes the shared file.

Classification table

PR	Title	Classification	Notes
#24801	docs: Update API topic with Cloud Auth	Docs present	docs/sources/reference/loki-http-api.md
#24799	feat(logline): Add correctness as a Loki target	Docs needed	New logline-correctness target + flags; experimental/invisible; no docs/sources/ coverage
#24796	feat(dataobj-compactor): Tighten Planner<>Worker result contract	No docs required	Internal planner/worker contract
#24784	chore(dataobj): Rename dataobj-consumer to dataobj-builder	Docs present	Config reference updated in docs/sources/shared/configuration.md (generated)
#24782	chore(dataobj): Remove rings from dataobj-consumer	Docs present	Config reference updated in shared configuration
#24778	chore(dataobj): Remove dataobj-index-builder	Docs present	Config reference updated in shared configuration
#24752	feat(limits-service): Persist streamShardStore state	Docs present	-ingest-limits.stream-sharding-durability-enabled in shared configuration; no separate conceptual ingest-limits page
#24743	feat(operator): Update Loki operand to 3.7.8	Docs present	operator/docs/operator/compatibility.md updated (outside docs root)
#24740	feat(logline): Attach hint ranges instead of envelope fan-out	No docs required	Internal logline query-frontend plumbing
#24738	chore: Update to Go 1.27	No docs required	CI/build images to 1.27.1; go.mod still 1.26.7; install-from-source wording remains accurate
#24737	ci: Move to depguard from faillint	No docs required	CI/lint only
#24733	docs: Add a network ports reference for Loki components	Docs present	docs/sources/reference/network-ports.md
#24732	fix(querytee): Drop the unused OpenTracing trace injector	No docs required	Internal cleanup
#24728	chore(dataobj): Build index in dataobj-builder	No docs required	Internal builder path (pre-rename package)
#24727	feat(logline): Wire logline filtering into the query frontend	Docs needed	Adds logline.query enablement/flags; no public docs; experimental
#24726	docs: Fix README links left stale by the SSD targets removal	Docs present	Fixed examples/nomad/README.md, production/README.md (outside docs root)
#24723	perf(indexgateway): Avoid retaining chunk refs during shard sizing	No docs required	Performance, no user-visible change
#24718	chore(deps): Update prometheus to 5f325dd18c88077d00a0e54554b3433696a24664	No docs required	Dependency bump
#24715	chore: Remove UpdateRates RPC from the limits service	No docs required	Internal RPC removal
#24714	feat(logline): Apply hint ranges in queriers	No docs required	Internal querier application of logline hints
#24713	perf(logline): Merge index shards concurrently	No docs required	Builder performance + merge_threads on unpublished feature
#24712	fix(logql)!: Apply grouping to an errored sample's labels	Docs update needed	Breaking LogQL grouping behavior; missing upgrade note
#24706	chore: Remove dataobj tee and related code	Docs present	Shared configuration updated
#24699	feat(querier): Read metric queries from data objects	No docs required	Store not routed yet (follow-up wiring)
#24696	chore(storage): Remove unused MaxChunksPerQueryFromStore limit	No docs required	Unused limit (always 0); not in config docs
#24687	feat(distributor): Compare shard counts against the ingest-limits service	Docs present	Shared configuration touched; shadow-mode comparison, push path unchanged for decisions
#24686	test(limits): Cover the backend wiring of CheckLimitsAndShard	No docs required	Tests only
#24684	feat(ingester): Add stream-first sample order to the ingester	No docs required	Internal sample-order transport
#24682	chore(operator): Build operator using Go 1.27.1	No docs required	Operator build tooling
#24663	fix(logql): Keep entries while stream accumulator has free room	No docs required	Internal accumulator fix
#24649	fix: Instead of deleting every WAL in given range period, delete only the ones related to this TSDB head	No docs required	Internal WAL cleanup fix
#24647	fix(querier): Give each store its own time range in StoreCombiner	No docs required	Internal querier store fix
#24646	chore(limits): Decide stream shard counts in the ingest-limits backend	No docs required	Backend decision path not wired into push yet
#24639	refactor(distributor): Process push requests using nested internal protos	No docs required	Internal refactor
#24638	feat(dataobj): Add an indexer that builds one index object per data object	No docs required	Internal indexer
#24636	fix(dataobj): Release the index object when indexobj builders fail to observe it	No docs required	Internal resource fix
#24607	feat(logline): Carry hint ranges through query transport	No docs required	Internal wire plumbing
#24606	feat(logline): Add hint-time-range wire contracts	No docs required	Proto-only contracts
#24480	feat(logline): Run the index builder as a Loki target	Docs needed	New logline-index-builder target + flags; experimental/invisible; no public docs
#24468	feat(logline): Add v4 index version with 9-digit numeric n-grams	No docs required	Index format internal to unpublished logline feature
#24453	feat(index-gateway): Cache expanded TSDB postings	Docs present	postings_cache in shared configuration
#24325	feat(operator): Enable flush_on_shutdown and increase ingester terminationGracePeriodSeconds	Docs needed	Operator default change; no operator docs found; path outside docs/sources/
#22566	fix(distributor): Return HTTP 400 error when parsing unknown field in push payload	Docs update needed	Breaking push JSON strictness; missing upgrade + API notes

Screenshot inventory

None. No UI/frontend changes in this window that affect documented screenshots.

Context / metadata

• Source repo: grafana/loki
• Window: 2026-09-21 – 2026-09-29
• Docs root: docs/sources/
• Orchestrator filter counts: 105 merged PRs; removed 50 bot PRs and 12 CI/test/deps/build-only PRs; 43 candidates classified above
• Do-not-edit / generated: docs/sources/shared/configuration.md (from docs/templates/ via make doc); docs/sources/configure/_index.md (includes shared file); docs/sources/setup/install/helm/reference.md (Helm values sync)
• run: dw-2026-09-29-9a995d08
• <!-- docs-workforce:grafana/loki:2026-W40 -->