Improve docs

Author: imbstack

src/sources/kubernetes_logs/mod.rs

@@ -111,7 +111,10 @@ pub struct Config {
     ///
     /// This can be useful to make Vector not pull in namespaces to reduce load on
     /// kube-apiserver and daemonset memory usage in clusters with  lots of namespaces.
+    /// In the case that this is set to `false`, fields based on namespace labels will not
+    /// be available.
     ///
+    #[serde(default = "default_add_namespace_fields")]
     add_namespace_fields: bool,
 
     /// The name of the Kubernetes [Node][node] that is running.
@@ -1059,6 +1062,11 @@ const fn default_oldest_first() -> bool {
     true
 }
 
+// We'd like to add these in all but clusters with very many namespaces
+const fn default_add_namespace_fields() -> bool {
+    true
+}
+
 const fn default_max_line_bytes() -> usize {
     // NOTE: The below comment documents an incorrect assumption, see
     // https://github.com/vectordotdev/vector/issues/6967

website/cue/reference/components/sources/generated/kubernetes_logs.cue

@@ -7,6 +7,8 @@ generated: components: sources: kubernetes_logs: configuration: {
 
 			This can be useful to make Vector not pull in namespaces to reduce load on
 			kube-apiserver and daemonset memory usage in clusters with  lots of namespaces.
+			In the case that this is set to `false`, fields based on namespace labels will not
+			be available.
 			"""
 		required: false
 		type: bool: default: true