From 9903c8ed54837f627a83056d11eae7a5f8c1c6cd Mon Sep 17 00:00:00 2001
From: "promptless[bot]" <promptless[bot]@users.noreply.github.com>
Date: Wed, 22 Jul 2026 00:15:39 +0000
Subject: [PATCH] docs: document optional HostTailer namespace chart value

Add a What's new (Unreleased) entry for the new optional per-instance
logging.hostTailers.instances[].namespace Helm chart value from
logging-operator PR #2275, which sets the namespace of each generated
HostTailer resource (release namespace when omitted).
---
 content/docs/whats-new/_index.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/content/docs/whats-new/_index.md b/content/docs/whats-new/_index.md
index cf3b6e336..5ae8185c1 100644
--- a/content/docs/whats-new/_index.md
+++ b/content/docs/whats-new/_index.md
@@ -3,6 +3,25 @@ title: What's new
 weight: 50
 ---
 
+## Unreleased
+
+_This documents a change that is not yet in a released version; this heading will be replaced with the version number once it ships._
+
+- You can now use the optional per-instance `logging.hostTailers.instances[].namespace` field to set the namespace of each generated HostTailer custom resource when configuring host tailers through the Helm chart. When set, the value is applied to the resource's `metadata.namespace`; when omitted, the HostTailer is created in the Helm release namespace, as before. For details, see the [pull request](https://github.com/kube-logging/logging-operator/pull/2275).
+
+```yaml
+logging:
+  hostTailers:
+    enabled: true
+    instances:
+      - name: hosttailer
+        enabled: true
+        namespace: my-namespace
+        fileTailers:
+          - name: sample-file
+            path: /var/log/sample-file
+```
+
 ## Version 6.5
 
 - The Fluentd image now includes [Typhoeus](https://github.com/typhoeus/typhoeus) as an alternative HTTP backend. Typhoeus supports connection keepalive, which can improve throughput when sending logs to HTTP-based outputs like [Elasticsearch]({{< relref "/docs/configuration/plugins/outputs/elasticsearch.md#elasticsearch-http_backend" >}}) and [OpenSearch]({{< relref "/docs/configuration/plugins/outputs/opensearch.md#opensearch-http_backend" >}}). To use it, set `http_backend: typhoeus` in your output configuration.