Skip to content

Commit 3f66daa

Browse files
libanderlibander
committed
RHDEVDOCS-4448 - w/SME & Peer review feedback.
1 parent d307c78 commit 3f66daa

24 files changed

+648
-44
lines changed

‎_topic_maps/_topic_map.yml

Lines changed: 32 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -2365,6 +2365,38 @@ Distros: openshift-enterprise,openshift-origin
23652365
Topics:
23662366
- Name: Release notes
23672367
File: cluster-logging-release-notes
2368+
- Name: Logging 5.6 (EUS)
2369+
Dir: v5_6
2370+
Distros: openshift-enterprise,openshift-origin
2371+
Topics:
2372+
- Name: Logging 5.6 Release Notes
2373+
File: logging-5-6-release-notes
2374+
- Name: Getting started with logging
2375+
File: logging-5-6-getting-started
2376+
- Name: Understanding Logging
2377+
File: logging-5-6-architecture
2378+
- Name: Configuring Logging
2379+
File: logging-5-6-configuration
2380+
- Name: Administering Logging
2381+
File: logging-5-6-administration
2382+
- Name: Logging Reference
2383+
File: logging-5-6-reference
2384+
- Name: Logging 5.5
2385+
Dir: v5_5
2386+
Distros: openshift-enterprise,openshift-origin
2387+
Topics:
2388+
- Name: Logging 5.5 Release Notes
2389+
File: logging-5-5-release-notes
2390+
- Name: Getting started with logging
2391+
File: logging-5-5-getting-started
2392+
- Name: Understanding Logging
2393+
File: logging-5-5-architecture
2394+
- Name: Administering Logging
2395+
File: logging-5-5-administration
2396+
- Name: Configuring Logging
2397+
File: logging-5-5-configuration
2398+
- Name: Logging Reference
2399+
File: logging-5-5-reference
23682400
- Name: About Logging
23692401
File: cluster-logging
23702402
- Name: Installing Logging
@@ -2435,34 +2467,6 @@ Topics:
24352467
- Name: Exported fields
24362468
File: cluster-logging-exported-fields
24372469
Distros: openshift-enterprise,openshift-origin
2438-
#- Name: Logging 5.5
2439-
# Dir: v5_5
2440-
# Distros: openshift-enterprise,openshift-origin
2441-
# Topics:
2442-
# - Name: Logging 5.5 Release Notes
2443-
# File: logging-5-5-release-notes
2444-
# - Name: Understanding Logging
2445-
# File: logging-5-5-architecture
2446-
# - Name: Administering Logging
2447-
# File: logging-5-5-administration
2448-
# - Name: Configuring Logging
2449-
# File: logging-5-5-configuration
2450-
# - Name: Logging Reference
2451-
# File: logging-5-5-reference
2452-
#- Name: Logging 5.6
2453-
# Dir: v5_6
2454-
# Distros: openshift-enterprise,openshift-origin
2455-
# Topics:
2456-
# - Name: Logging 5.6 Release Notes
2457-
# File: logging-5-6-release-notes
2458-
# - Name: Understanding Logging
2459-
# File: logging-5-6-architecture
2460-
# - Name: Configuring Logging
2461-
# File: logging-5-6-configuration
2462-
# - Name: Administering Logging
2463-
# File: logging-5-6-administration
2464-
# - Name: Logging Reference
2465-
# File: logging-5-6-reference
24662470
---
24672471
Name: Monitoring
24682472
Dir: monitoring

‎logging/v5_5/logging-5-5-administration.adoc

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,18 @@ include::_attributes/common-attributes.adoc[]
55
:context: logging-5.5-administration
66

77
toc::[]
8+
9+
//Installing the Red Hat OpenShift Logging Operator via webconsole
10+
include::modules/logging-deploy-RHOL-console.adoc[leveloffset=+1]
11+
12+
//Installing the Loki Operator via webconsole
13+
include::modules/logging-deploy-loki-console.adoc[leveloffset=+1]
14+
15+
//Generic installing operators from operator hub using CLI
16+
include::modules/olm-installing-from-operatorhub-using-cli.adoc[leveloffset=+1]
17+
18+
//Generic deleting operators from cluster using web console
19+
include::modules/olm-deleting-operators-from-a-cluster-using-web-console.adoc[leveloffset=+1]
20+
21+
//Generic deleting operators from a cluster using CLI
22+
include::modules/olm-deleting-operators-from-a-cluster-using-cli.adoc[leveloffset=+1]

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,6 @@ include::_attributes/common-attributes.adoc[]
55
:context: logging-5.5-architecture
66

77
toc::[]
8+
9+
:context: logging-5-5-architecture
10+
include::modules/logging-architecture-overview.adoc[lines=9..31]

‎logging/v5_5/logging-5-5-configuration.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,7 @@ include::_attributes/common-attributes.adoc[]
55
:context: logging-5.5-configuration
66

77
toc::[]
8+
9+
include::snippets/logging-crs-by-operator-snip.adoc[]
10+
11+
include::snippets/logging-supported-config-snip.adoc[]

‎logging/v5_5/logging-5-5-getting-started.adoc

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
:_content-type: ASSEMBLY
2+
3+
[id="logging-5-5-getting-started"]
4+
= Getting started with logging 5.5
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.
7+
8+
--
9+
include::snippets/logging-under-construction-snip.adoc[]
10+
--
11+
12+
--
13+
include::snippets/logging-compatibility-snip.adoc[]
14+
--
15+
16+
.Prerequisites
17+
* LogStore preference: *Elasticsearch* or *LokiStack*
18+
* Collector implementation preference: *Fluentd* or *Vector* See the xref:../logging-5-5-reference.adoc[Logging reference] to review the differences between Fluentd and Vector implementations.
19+
* Credentials for your log forwarding outputs
20+
21+
.Procedure
22+
--
23+
include::snippets/logging-elastic-dep-snip.adoc[]
24+
--
25+
. Install the Operator for the logstore you'd like to use.
26+
** For *Elasticsearch*, install the *OpenShift Elasticsearch Operator*.
27+
** For *LokiStack*, install the *Loki Operator*.
28+
*** Create a `LokiStack` custom resource (CR) instance.
29+
30+
. Install the *Red Hat OpenShift Logging Operator*.
31+
32+
. Create a `ClusterLogging` custom resource (CR) instance.
33+
.. Select your Collector Implementation.
34+
+
35+
--
36+
include::snippets/logging-fluentd-dep-snip.adoc[]
37+
--
38+
. Create a `ClusterLogForwarder` custom resource (CR) instance. See the xref:../logging-5-5-reference.adoc[Logging reference] to review the available output options for the collector implementation you've selected.
39+
40+
. Create a secret for the selected output pipeline.

‎logging/v5_6/logging-5-6-administration.adoc

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,18 @@ include::_attributes/common-attributes.adoc[]
55
:context: logging-5.6-administration
66

77
toc::[]
8+
9+
//Installing the Red Hat OpenShift Logging Operator via webconsole
10+
include::modules/logging-deploy-RHOL-console.adoc[leveloffset=+1]
11+
12+
//Installing the Loki Operator via webconsole
13+
include::modules/logging-deploy-loki-console.adoc[leveloffset=+1]
14+
15+
//Generic installing operators from operator hub using CLI
16+
include::modules/olm-installing-from-operatorhub-using-cli.adoc[leveloffset=+1]
17+
18+
//Generic deleting operators from cluster using web console
19+
include::modules/olm-deleting-operators-from-a-cluster-using-web-console.adoc[leveloffset=+1]
20+
21+
//Generic deleting operators from a cluster using CLI
22+
include::modules/olm-deleting-operators-from-a-cluster-using-cli.adoc[leveloffset=+1]

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,6 @@ include::_attributes/common-attributes.adoc[]
55
:context: logging-5.6-architecture
66

77
toc::[]
8+
9+
:context: logging-5-6-architecture
10+
include::modules/logging-architecture-overview.adoc[lines=9..31]

‎logging/v5_6/logging-5-6-configuration.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,7 @@ include::_attributes/common-attributes.adoc[]
55
:context: logging-5.6-configuration
66

77
toc::[]
8+
9+
include::snippets/logging-crs-by-operator-snip.adoc[]
10+
11+
include::snippets/logging-supported-config-snip.adoc[]

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

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
:_content-type: ASSEMBLY
2+
3+
[id="logging-getting-started-5-6"]
4+
= Getting started with logging 5.6
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.
7+
+
8+
--
9+
include::snippets/logging-under-construction-snip.adoc[]
10+
--
11+
12+
--
13+
include::snippets/logging-compatibility-snip.adoc[]
14+
--
15+
16+
.Prerequisites
17+
* LogStore preference: *Elasticsearch* or *LokiStack*
18+
* Collector implementation preference: *Fluentd* or *Vector* See the xref:../logging-5-6-reference.adoc[Logging reference] to review the differences between Fluentd and Vector implementations.
19+
* Credentials for your log forwarding outputs
20+
21+
.Procedure
22+
--
23+
include::snippets/logging-elastic-dep-snip.adoc[]
24+
--
25+
. Install the Operator for the logstore you'd like to use.
26+
** For *Elasticsearch*, install the *OpenShift Elasticsearch Operator*.
27+
** For *LokiStack*, install the *Loki Operator*.
28+
*** Create a `LokiStack` custom resource (CR) instance.
29+
30+
. Install the *Red Hat OpenShift Logging Operator*.
31+
32+
. Create a `ClusterLogging` custom resource (CR) instance.
33+
.. Select your Collector Implementation.
34+
+
35+
--
36+
include::snippets/logging-fluentd-dep-snip.adoc[]
37+
--
38+
. Create a `ClusterLogForwarder` custom resource (CR) instance. See the xref:../logging-5-5-reference.adoc[Logging reference] to review the available output options for the collector implementation you've selected.
39+
40+
. Create a secret for the selected output pipeline.

‎logging/v5_6/logging-5-6-release-notes.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,3 +7,13 @@ include::_attributes/common-attributes.adoc[]
77
toc::[]
88

99
include::snippets/logging-compatibility-snip.adoc[]
10+
11+
include::snippets/logging-stable-updates-snip.adoc[]
12+
13+
include::modules/logging-rn-5.6.3.adoc[leveloffset=+1]
14+
15+
include::modules/logging-rn-5.6.2.adoc[leveloffset=+1]
16+
17+
include::modules/logging-rn-5.6.1.adoc[leveloffset=+1]
18+
19+
include::modules/logging-rn-5.6.0.adoc[leveloffset=+1]

0 commit comments

Comments
 (0)