docs(schemas): improve log_namespace docs and warn on log_schema (#25560)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: pront

lib/vector-core/src/config/global_options.rs

@@ -84,7 +84,11 @@ pub struct GlobalOptions {
     /// This is used if a component does not have its own specific log schema. All events use a log
     /// schema, whether or not the default is used, to assign event fields on incoming events.
     #[serde(default, skip_serializing_if = "crate::serde::is_default")]
-    #[configurable(metadata(docs::common = false, docs::required = false))]
+    #[configurable(metadata(
+        docs::common = false,
+        docs::required = false,
+        docs::warnings = "These settings are ignored when `schema.log_namespace` is set to `true`."
+    ))]
     pub log_schema: LogSchema,
 
     /// Telemetry options.

src/config/schema.rs

@@ -30,6 +30,8 @@ pub struct Options {
 
     /// Controls how metadata is stored in log events.
     ///
+    /// This feature is in beta and behavior may change.
+    ///
     /// When set to `false` (legacy mode), metadata fields like `host`, `timestamp`, and `source_type`
     /// are stored as top-level fields alongside your log data.
     ///
@@ -39,6 +41,7 @@ pub struct Options {
     /// See the [Log Namespacing guide](/guides/level-up/log_namespace/) for detailed information
     /// about when to use Vector namespace mode and how to migrate from legacy mode.
     #[configurable(metadata(
+        status = "beta",
         docs::warnings = "Enabling log namespacing currently does not work when disk buffers are used. Avoid combining `schema.log_namespace = true` with disk buffers until [#18574](https://github.com/vectordotdev/vector/issues/18574) is resolved."
     ))]
     pub log_namespace: Option<bool>,

website/content/en/guides/level-up/log_namespace.md

@@ -23,6 +23,12 @@ If you encounter any issues please [report them here](https://github.com/vectord
 
 {{< /requirement >}}
 
+{{< warning >}}
+Enabling log namespacing does not work when disk buffers are used. Avoid combining
+`schema.log_namespace: true` with disk buffers until
+[#18574](https://github.com/vectordotdev/vector/issues/18574) is resolved.
+{{< /warning >}}
+
 ## Background
 
 Vector traditionally stored metadata (like `host`, `timestamp`, and `source_type`) as top-level

website/cue/reference/generated/configuration.cue

@@ -433,6 +433,8 @@ generated: configuration: {
 					description: """
 						Controls how metadata is stored in log events.
 
+						This feature is in beta and behavior may change.
+
 						When set to `false` (legacy mode), metadata fields like `host`, `timestamp`, and `source_type`
 						are stored as top-level fields alongside your log data.
 
@@ -1498,7 +1500,8 @@ generated: configuration: {
 				"""
 			common:   false
 			required: false
-			group:    "schema"
+			warnings: ["These settings are ignored when `schema.log_namespace` is set to `true`."]
+			group: "schema"
 		}
 		metrics_storage_refresh_period: {
 			type: float: {}