Bug 1904410

Summary: [DOCS] Add example for sending to several Kafka brokers using only one output entry
Product: OpenShift Container Platform Reporter: Oscar Casal Sanchez <ocasalsa>
Component: DocumentationAssignee: Latha S <lmurthy>
Status: CLOSED CURRENTRELEASE QA Contact: Anping Li <anli>
Severity: unspecified Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 4.6CC: anli, aos-bugs, jokerman, oarribas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-03-17 22:36:25 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Oscar Casal Sanchez 2020-12-04 11:36:06 UTC 
[Document URL]
https://docs.openshift.com/container-platform/4.6/logging/cluster-logging-external.html#cluster-logging-collector-log-forward-kafka_cluster-logging-external

[Section Number and Name] 
Forwarding logs to a Kafka broker

[Describe the issue] 
In the documentation, we have an example about how to define an output to send to one broker like this:
~~~
  outputs:
   - name: app-logs 
     type: kafka 
     url: tls://kafka.example.devlab.com:9093/app-topic 
     secret:
       name: kafka-secret
~~~

But in the CRD [1] it's indicated that it's possible to define one output to send to several brokers and using the same secret.

[Suggestions for improvement]
Include one example where it's defined one output to send to several brokers using the same topic, like this:

~~~
  - name: app-logs 
    type: kafka
    secret:
      name: kafka-secret-dev
    kafka:
      brokers:
        - tls://kafka-broker1.example.com:9093/
        - tls://kafka-broker2.example.com:9093/
        - ...
      topic: app-topic
~~~


[1] https://github.com/openshift/cluster-logging-operator/blob/332dec5d433570f7e315b1629159c81abfe936d4/manifests/4.6/logging.openshift.io_clusterlogforwarders_crd.yaml#L75
Comment 1 Rolfe Dlugy-Hegwer 2021-02-10 21:04:23 UTC 
Moved to ON_QA with https://issues.redhat.com/browse/RHDEVDOCS-2605
Comment 2 Rolfe Dlugy-Hegwer 2021-03-17 22:36:25 UTC 
Resolved with https://github.com/openshift/openshift-docs/pull/29399