Skip to content

Commit befb0d4

Browse files
libanderlibander
committed
OBSDOCS-172 - http forward & Feature ref updates w/ SME - QE
1 parent 2a4d65d commit befb0d4

File tree

5 files changed

+80
-4
lines changed

5 files changed

+80
-4
lines changed

‎logging/cluster-logging-external.adoc‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,8 @@ endif::openshift-rosa[]
192192

193193
include::modules/logging-forward-splunk.adoc[leveloffset=+1]
194194

195+
include::modules/logging-http-forward.adoc[leveloffset=+1]
196+
195197
include::modules/cluster-logging-collector-log-forward-project.adoc[leveloffset=+1]
196198

197199
include::modules/cluster-logging-collector-log-forward-logs-from-application-pods.adoc[leveloffset=+1]

‎logging/v5_7/logging-5-7-architecture.adoc‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,3 +10,5 @@ toc::[]
1010
include::modules/logging-architecture-overview.adoc[lines=9..31]
1111

1212
include::modules/logging-support-considerations.adoc[leveloffset=+1]
13+
14+
include::snippets/logging-5.7-outputs-snip.adoc[]

‎modules/cluster-logging-feature-reference.adoc‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -84,11 +84,12 @@ $ oc -n openshift-logging edit ClusterLogging instance
8484
| Feature | Fluentd | Vector
8585
| Elasticsearch v5-v7 | ✓ | ✓
8686
| Fluent forward | ✓ |
87-
| Syslog RFC3164 | ✓ |
88-
| Syslog RFC5424 | ✓ |
87+
| Syslog RFC3164 | ✓ | ✓ (Logging 5.7+)
88+
| Syslog RFC5424 | ✓ | ✓ (Logging 5.7+)
8989
| Kafka | ✓ | ✓
9090
| Cloudwatch | ✓ | ✓
9191
| Loki | ✓ | ✓
92+
| HTTP | ✓ | ✓ (Logging 5.7+)
9293
|==========================================================
9394

9495
.Authorization and Authentication
@@ -98,7 +99,7 @@ $ oc -n openshift-logging edit ClusterLogging instance
9899
| Elasticsearch certificates | ✓ | ✓
99100
| Elasticsearch username / password | ✓ | ✓
100101
| Cloudwatch keys | ✓ | ✓
101-
| Cloudwatch STS | ✓ |
102+
| Cloudwatch STS | ✓ | ✓
102103
| Kafka certificates | ✓ | ✓
103104
| Kafka username / password | ✓ | ✓
104105
| Kafka SASL | ✓ | ✓
@@ -119,7 +120,7 @@ $ oc -n openshift-logging edit ClusterLogging instance
119120
| Loglevel Normalization | ✓ | ✓
120121
| JSON parsing | ✓ | ✓
121122
| Structured Index | ✓ | ✓
122-
| Multiline error detection | ✓ |
123+
| Multiline error detection | ✓ | ✓
123124
| Multicontainer / split indices | ✓ | ✓
124125
| Flatten labels | ✓ | ✓
125126
| CLF static labels | ✓ | ✓

‎modules/logging-http-forward.adoc‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
// Module included in the following assemblies:
2+
// logging/cluster-logging-external
3+
// *
4+
5+
:_content-type: PROCEDURE
6+
[id="logging-deploy-loki-console_{context}"]
7+
= Forwarding logs over HTTP
8+
9+
Forwarding logs over HTTP is supported for both fluentd and vector collectors. To enable, specify `http` as the output type in the `ClusterLogForwarder` custom resource (CR).
10+
11+
.Procedure
12+
13+
* Create or edit the ClusterLogForwarder Custom Resource (CR) using the template below:
14+
15+
.Example ClusterLogForwarder CR
16+
[source,yaml]
17+
----
18+
apiVersion: "logging.openshift.io/v1"
19+
kind: "ClusterLogForwarder"
20+
metadata:
21+
name: "instance"
22+
namespace: "openshift-logging"
23+
spec:
24+
outputs:
25+
- name: httpout-app
26+
type: http
27+
url: <1>
28+
http:
29+
headers: <2>
30+
h1: v1
31+
h2: v2
32+
method: POST
33+
secret:
34+
name: <3>
35+
tls:
36+
insecureSkipVerify: <4>
37+
pipelines:
38+
- name:
39+
inputRefs:
40+
- application
41+
outputRefs:
42+
- <5>
43+
----
44+
<1> Destination address for logs.
45+
<2> Additional headers to send with the log record.
46+
<3> Secret name for destination credentials.
47+
<4> Values are either `true` or `false`.
48+
<5> This value should be the same as the output name.

‎snippets/logging-5.7-outputs-snip.adoc‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
// Text snippet included in the following assemblies:
2+
//
3+
//
4+
// Text snippet included in the following modules:
5+
//
6+
//
7+
:_content-type: SNIPPET
8+
.Logging 5.7 outputs
9+
[options="header"]
10+
|====================================================================================================
11+
| Output | Protocol | Tested with | Fluentd | Vector
12+
| Cloudwatch | REST over HTTP(S) | | &#10003; | &#10003;
13+
| Elasticsearch v6 | | v6.8.1 | &#10003; | &#10003;
14+
| Elasticsearch v7 | | v7.12.2, 7.17.7 | &#10003; | &#10003;
15+
| Elasticsearch v8 | | v8.4.3 | &#10003; | &#10003;
16+
| Fluent Forward | Fluentd forward v1 | Fluentd 1.14.6, Logstash 7.10.1 | &#10003; |
17+
| Google Cloud Logging | | | | &#10003;
18+
| HTTP | HTTP 1.1 | Fluentd 1.14.6, Vector 0.21 | &#10003; | &#10003;
19+
| Kafka | Kafka 0.11 | Kafka 2.4.1, 2.7.0, 3.3.1 | &#10003; | &#10003;
20+
| Loki | REST over HTTP(S) | Loki 2.3.0, 2.7 | &#10003; | &#10003;
21+
| Splunk | HEC | v8.2.9, 9.0.0 | | &#10003;
22+
| Syslog | RFC3164, RFC5424 | Rsyslog 8.37.0-9.el7 | &#10003; | &#10003;
23+
|====================================================================================================

0 commit comments

Comments
 (0)