OBSDOCS-3174: Document Review default set of stream labels for "openshift-logging" tenant

Author: theashiot

configuring/configuring-lokistack-otlp.adoc

@@ -107,31 +107,29 @@ Attributes that are not explicitly set as stream labels or dropped from the entr
 [id="customizing-openshift-defaults_{context}"]
 === Customizing OpenShift defaults
 
-In the `openshift-logging` mode, certain attributes are required and cannot be removed from the configuration due to their role in OpenShift functions. Other attributes, labeled *recommended*, might be dropped if performance is impacted. For information about the attributes, see xref:../configuring/opentelemetry-data-model.adoc#attributes_opentelemetry-data-model[OpenTelemetry data model attributes].
+In the `openshift-logging` mode, the configuration requires certain attributes that you must not remove due to their role in OpenShift functions.
+Other attributes, called console labels, need to be enabled. 
+The {ocp-product-title} web console uses console labels to provide a simplified UI for querying logs.
+Enabling console labels adds the following attributes to stream labels:
+
+* `k8s.container.name`
+* `k8s.cronjob.name`
+* `k8s.daemonset.name`
+* `k8s.deployment.name`
+* `k8s.job.name`
+* `k8s.node.name`
+* `k8s.pod.name`
+* `k8s.statefulset.name`
+* `kubernetes.container_name`
+* `kubernetes.host`
+* `kubernetes.pod_name`
+* `service.name`
 
 When using the `openshift-logging` mode without custom attributes, you can achieve immediate compatibility with OpenShift tools. If additional attributes are needed as stream labels or some attributes need to be dropped, use custom configuration. Custom configurations can merge with default configurations.
 
-[id="removing-recommended-attributes_{context}"]
-=== Removing recommended attributes
+For information about the attributes, see xref:../configuring/opentelemetry-data-model.adoc#attributes_opentelemetry-data-model[OpenTelemetry data model attributes].
 
-To reduce default attributes in the `openshift-logging` mode, disable recommended attributes:
-
-[source,yaml]
-----
-# ...
-spec:
-  tenants:
-    mode: openshift-logging
-    openshift:
-      otlp:
-        disableRecommendedAttributes: true # <1>
-----
-<1> Set `disableRecommendedAttributes: true` to remove recommended attributes, which limits default attributes to the required attributes or stream labels.
-+
-[NOTE]
-====
-This setting might negatively impact query performance, as it removes default stream labels. You must pair this option with a custom attribute configuration to retain attributes essential for queries.
-====
+include::modules/enabling-console-labels-for-openshift-web-console.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
 [id="additional-resources_{context}"]

modules/enabling-console-labels-for-openshift-web-console.adoc

@@ -0,0 +1,43 @@
+:_newdoc-version: 2.18.4
+:_template-generated: 2026-03-03
+:_mod-docs-content-type: PROCEDURE
+
+[id="enabling-console-labels-for-openshift-web-console_{context}"]
+= Enabling console labels for OpenShift web console
+
+You can enable stream labels for OpenShift web console, called console labels, for a simplified UI for querying logs.
+The log viewer in the {ocp-product-title} web console uses the console labels for its integrated filters.
+
+[IMPORTANT]
+=====
+Currently, the OpenShift web console only supports filtering on attributes by using stream labels.
+Therefore, if you do not enable all the console labels, the filters in the log viewer might not function correctly.
+However, including all the console labels might lead to performance issues.
+If you know that only a subset of the filters are used, it is recommended to only add those stream labels to the configuration instead of using the full set.
+This behavior might change in the future.
+=====
+
+.Prerequisites
+* You have created a `ClusterLogForwarder` custom resource (CR) with an OpenTelemetry Protocol (OTLP) output.
+
+.Procedure
+
+. Update the ClusterLogForwarder custom resource (CR):
++
+[source,yaml]
+----
+# ...
+spec:
+  tenants:
+    mode: openshift-logging
+    openshift:
+      otlp:
+        enableConsoleLabels: true
+----
+
+. Apply the CR object by using the following command:
++
+[source,terminal]
+----
+$ oc apply -f <file-name>.yaml
+----