From fecf734e9f4803f86208c1739082c4299849f0c3 Mon Sep 17 00:00:00 2001 From: ryanohnemus Date: Wed, 10 Apr 2024 17:33:34 -0500 Subject: [PATCH] documentation for https://github.com/fluent/fluent-bit/pull/8695 Signed-off-by: ryanohnemus --- pipeline/filters/kubernetes.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/pipeline/filters/kubernetes.md b/pipeline/filters/kubernetes.md index 326e28e67..0ff1d1195 100644 --- a/pipeline/filters/kubernetes.md +++ b/pipeline/filters/kubernetes.md @@ -57,6 +57,7 @@ The plugin supports the following configuration parameters: | Kube\_Meta\_Namespace\_Cache\_TTL | configurable TTL for K8s cached namespace metadata. By default, it is set to 900 which means a 15min TTL for namespace cache entries. Setting this to 0 will mean entries are evicted at random once the cache is full. | 900 | | Namespace\_Labels | Include Kubernetes namespace resource labels in the extra metadata. See [Kubernetes Namespace Meta](#kubernetes-namespace-meta)| Off | | Namespace\_Annotations | Include Kubernetes namespace resource annotations in the extra metadata. See [Kubernetes Namespace Meta](#kubernetes-namespace-meta)| Off | +| Namespace\_Metadata\_Only | Include Kubernetes namespace metadata only and no pod metadata. If this is set, the values of `Labels` and `Annotations` are ignored. See [Kubernetes Namespace Meta](#kubernetes-namespace-meta)| Off | ## Processing the 'log' value @@ -92,6 +93,10 @@ Namespace Meta if collected will be stored within a `kubernetes_namespace` recor > Namespace meta is not be guaranteed to be in sync as namespace labels & annotations can be adjusted after pod creation. Adjust `Kube_Meta_Namespace_Cache_TTL` to lower caching times to fit your use case. +* Namespace\_Metadata\_Only + - Using this feature will instruct fluent-bit to only fetch namespace metadata and to not fetch POD metadata at all. + POD basic metadata like container id, host, etc will be NOT be added and the Labels and Annotations configuration options which are used specifically for POD Metadata will be ignored. + ## Kubernetes Pod Annotations A flexible feature of Fluent Bit Kubernetes filter is that allow Kubernetes Pods to suggest certain behaviors for the log processor pipeline when processing the records. At the moment it support: