Skip to content

docs: pipeline: outputs: loki: document rejection of invalid tenant IDs #2792

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
eschabell merged 1 commit into from
Oct 24, 2026
+2 −0
Merged

docs: pipeline: outputs: loki: document rejection of invalid tenant IDs #2792

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions pipeline/outputs/loki.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -320,6 +320,8 @@ The `tenant_id_key_error_handling` option controls how Fluent Bit treats mixed r
- `partial_success`: treat the chunk as successful when at least one tenant request succeeds. This is the default.
- `partial_error`: retry the chunk when any tenant request fails, even if another tenant request succeeds.

In v5.1.5 or later, Fluent Bit rejects a tenant ID that contains a control character, such as a carriage return or line feed. A tab is allowed. Fluent Bit doesn't send the request for that tenant, logs the error `invalid tenant header; dropping tenant group`, and treats the request as a failure that isn't retried. With `partial_success`, the records for that tenant are dropped. With `partial_error`, the chunk is retried when another tenant request succeeds, but the invalid tenant ID fails on every retry, so the chunk is retried until it reaches the retry limit. If a static `tenant_id` contains a control character, only requests that use the static value fail. Without `tenant_id_key`, this is every request. With `tenant_id_key`, requests for records that fall back to the static value fail, and requests that use a valid tenant ID from `tenant_id_key` are unaffected.

{% tabs %}
{% tab title="fluent-bit.yaml" %}

Expand Down
Loading