Merge pull request #83592 from libander/OBSDOCS-1374

OBSCDOCS-1374 - Loki Statement of Purpose addition to Logging 6.0 docs.

Author: kcarmichael08

modules/log6x-loki-retention.adoc

@@ -112,7 +112,3 @@ spec:
 $ oc apply -f <filename>.yaml
 ----
 +
-[NOTE]
-====
-This is not for managing the retention for stored logs. Global retention periods for stored logs to a supported maximum of 30 days is configured with your object storage.
-====

modules/logging-loki-retention.adoc

@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// 
+//
 // * observability/logging/log_storage/cluster-logging-loki.adoc
 
 :_mod-docs-content-type: PROCEDURE
@@ -26,7 +26,7 @@ metadata:
   name: logging-loki
   namespace: openshift-logging
 spec:
-  limits: 
+  limits:
    global: <1>
       retention: <2>
         days: 20
@@ -105,8 +105,3 @@ spec:
 ----
 $ oc apply -f <filename>.yaml
 ----
-
-[NOTE]
-====
-This is not for managing the retention for stored logs. Global retention periods for stored logs to a supported maximum of 30 days is configured with your object storage.
-====

observability/logging/cluster-logging-support.adoc

@@ -8,6 +8,7 @@ toc::[]
 
 include::snippets/logging-supported-config-snip.adoc[]
 include::snippets/logging-compatibility-snip.adoc[]
+include::snippets/log6x-loki-statement-snip.adoc[]
 
 {logging-uc} {for} is an opinionated collector and normalizer of application, infrastructure, and audit logs. It is intended to be used for forwarding logs to various supported systems.
 

observability/logging/logging-6.0/log6x-loki.adoc

@@ -1,21 +1,24 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="log6x-loki"]
 = Storing logs with LokiStack
-include::_attributes/common-attributes.adoc[]
+include::_attributes/common-attributes.adoc[leveloffset=+1]
 :context: logging-6x
 
 toc::[]
 
 You can configure a `LokiStack` CR to store application, audit, and infrastructure-related logs.
 
+include::snippets/log6x-loki-statement-snip.adoc[leveloffset=+1]
+
 [id="prerequisites_{context}"]
 == Prerequisites
 
 * You have installed the {loki-op} by using the CLI or web console.
 * You have a `serviceAccount` in the same namespace in which you create the `ClusterLogForwarder`.
 * The `serviceAccount` is assigned `collect-audit-logs`, `collect-application-logs`, and `collect-infrastructure-logs` cluster roles.
 
-=== Core Setup and Configuration
+[id="setup_{context}"]
+== Core Setup and Configuration
 *Role-based access controls, basic monitoring, and pod placement to deploy Loki.*
 
 include::modules/log6x-loki-rbac-rules-perms.adoc[leveloffset=+1]
@@ -24,14 +27,16 @@ include::modules/log6x-loki-memberlist-ip.adoc[leveloffset=+1]
 include::modules/log6x-loki-retention.adoc[leveloffset=+1]
 include::modules/log6x-loki-pod-placement.adoc[leveloffset=+1]
 
-=== Enhanced Reliability and Performance
+[id="performance_{context}"]
+== Enhanced Reliability and Performance
 *Configurations to ensure Loki’s reliability and efficiency in production.*
 
 include::modules/log6x-identity-federation.adoc[leveloffset=+1]
 include::modules/log6x-loki-reliability-hardening.adoc[leveloffset=+1]
 include::modules/log6x-loki-restart-hardening.adoc[leveloffset=+1]
 
-=== Advanced Deployment and Scalability
+[id="advanced_{context}"]
+== Advanced Deployment and Scalability
 *Specialized configurations for high availability, scalability, and error handling.*
 
 include::modules/log6x-loki-zone-aware-rep.adoc[leveloffset=+1]

snippets/log6x-loki-statement-snip.adoc

@@ -1,9 +1,13 @@
 // Text snippet included in the following assemblies:
-// * observability/logging/log_storage/about-log-storage.adoc
-//
+// * observability/logging/logging-6.0/log6x-loki.adoc
 // Text snippet included in the following modules:
 //
 //
 :_mod-docs-content-type: SNIPPET
 
-Loki is a horizontally scalable, highly available, multi-tenant log aggregation system offered as a GA log store for {logging} {for} that can be visualized with the OpenShift {ObservabilityShortName} UI. The Loki configuration provided by OpenShift {logging-uc} is a short-term log store designed to enable users to perform fast troubleshooting with the collected logs. For that purpose, the {logging} {for} configuration of Loki has short-term storage, and is optimized for very recent queries. For long-term storage or queries over a long time period, users should look to log stores external to their cluster.
+Loki is a horizontally scalable, highly available, multi-tenant log aggregation system offered as a GA log store for {logging} {for} that can be visualized with the OpenShift {ObservabilityShortName} UI. The Loki configuration provided by OpenShift {logging-uc} is a short-term log store designed to enable users to perform fast troubleshooting with the collected logs. For that purpose, the {logging} {for} configuration of Loki has short-term storage, and is optimized for very recent queries.
+
+[IMPORTANT]
+====
+For long-term storage or queries over a long time period, users should look to log stores external to their cluster. Loki sizing is only tested and supported for short term storage, for a maximum of 30 days. 
+====