Merge pull request #59109 from libander/RHDEVDOCS-2671

RHDEVDOCS-2671 - Logging support considerations

Author: rolfedh

logging/cluster-logging.adoc

@@ -22,6 +22,8 @@ Because the internal {product-title} Elasticsearch log store does not provide se
 ====
 endif::[]
 
+include::modules/logging-support-considerations.adoc[leveloffset=+1]
+
 // The following include statements pull in the module files that comprise
 // the assembly. Include any combination of concept, procedure, or reference
 // modules required to cover the user story. You can also include other

logging/v5_5/logging-5-5-architecture.adoc

@@ -7,4 +7,6 @@ include::_attributes/common-attributes.adoc[]
 toc::[]
 
 :context: logging-5-5-architecture
-include::modules/logging-architecture-overview.adoc[lines=9..31]
+include::modules/logging-architecture-overview.adoc[leveloffset=+1,lines=9..31]
+
+include::modules/logging-support-considerations.adoc[leveloffset=+1]

logging/v5_6/logging-5-6-architecture.adoc

@@ -1,10 +1,12 @@
 :_content-type: ASSEMBLY
 [id="logging-architecture-5-6"]
-= Administering your logging deployment
+= Understanding logging
 include::_attributes/common-attributes.adoc[]
 :context: logging-5.6-architecture
 
 toc::[]
 
-:context: logging-5-6-architecture
-include::modules/logging-architecture-overview.adoc[lines=9..31]
+
+include::modules/logging-architecture-overview.adoc[leveloffset=+1,lines=9..31]
+
+include::modules/logging-support-considerations.adoc[leveloffset=+1]

logging/v5_6/logging-5-6-getting-started.adoc

@@ -4,7 +4,7 @@
 = Getting started with logging 5.6
 
 This overview of the logging deployment process is provided for ease of reference. It is not a substitute for full documentation. For new installations, *Vector* and *LokiStack* are recommended.
-+
+
 --
 include::snippets/logging-under-construction-snip.adoc[]
 --
@@ -15,7 +15,7 @@ include::snippets/logging-compatibility-snip.adoc[]
 
 .Prerequisites
 * LogStore preference: *Elasticsearch* or *LokiStack*
-* Collector implementation preference: *Fluentd* or *Vector* 
+* Collector implementation preference: *Fluentd* or *Vector*
 * Credentials for your log forwarding outputs
 
 .Procedure

modules/logging-support-considerations.adoc

@@ -0,0 +1,27 @@
+// Module included in the following assemblies:
+// logging/v5_6/logging-5-6-architecture.adoc
+
+:_content-type: CONCEPT
+[id="logging-support-considerations_{context}"]
+= Support considerations for logging
+
+include::snippets/logging-compatibility-snip.adoc[]
+
+include::snippets/logging-supported-config-snip.adoc[]
+
+The following modifications are explicitly not supported:
+
+* *Deploying logging to namespaces not specified in the documentation.*
+* *Installing custom Elasticsearch, Kibana, Fluentd, or Loki instances on {product-title}.*
+* *Changes to the Kibana Custom Resource (CR) or Elasticsearch CR.*
+* *Changes to secrets or config maps not specified in the documentation.*
+
+The {logging-title} 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.
+
+The {logging-title} is not:
+
+* A high scale log collection system
+* Security Information and Event Monitoring (SIEM) compliant
+* Historical or long term log retention or storage
+* A guaranteed log sink
+* Secure storage - audit logs are not stored by default