Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1779122

Summary: [Docs][RFE] Document configuration changes for TripleO heat templates for rsyslog
Product: Red Hat OpenStack Reporter: Joanne O'Flynn <joflynn>
Component: documentationAssignee: Joanne O'Flynn <joflynn>
Status: CLOSED CURRENTRELEASE QA Contact: mgeary <mgeary>
Severity: medium Docs Contact:
Priority: medium    
Version: 16.0 (Train)CC: ccopello, mmagr
Target Milestone: ---Keywords: FutureFeature, Triaged
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: 2020-02-21 11:24:51 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:
Bug Depends On: 1623152    
Bug Blocks:    

Description Joanne O'Flynn 2019-12-03 10:59:28 UTC 
All customers require logging, which is as of OSP 13 provided by fluentd. Due to ECL promoting use of rsyslog in RHEL 8, we have to consider a move to logging and forwarding using rsyslog to be compatible with ECL.  Since ECL is moving to rsyslog support, this means that we will have to start supporting  rsyslog in OSP 15, with parallel fluentd support (while indicating to customers that fluentd is being deprecated). This avoids OSP 16 (Long Life Release) having to support fluentd.   During upgrade any fluentd logs not sent to central logging will need to be converted to rsyslog logs. We need to also look at the issue of double sending of logs once the upgrade is done. 

We need to take a crawl-walk-run approach to replacing rsyslog.  The first step is do the same fluentd is doing and use the local file system. Containers send logs to var/log/containers/<service-name> files on host that they are running on, in fact some containers are bind mounted to the host. Like Fluentd, rsyslog should collects the files and dispatch to the servers specified during configuration.  

Requirements are 
1. Rsyslog is configured via director during deployment to collect and forward container logs to be functionally equivalent to the fluentd installation.
2. Rsyslog log forwarding can be configured by the user in the same way as provided for fluentd

Configuration changes will be required for the HEAT templates for installation of rsyslog.
Comment 8 Joanne O'Flynn 2020-02-21 11:24:51 UTC 
Updated docs:

Chapter 2 
https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.0/html/logging_monitoring_and_troubleshooting_guide/logging

Chapter 3
https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.0/html/monitoring_tools_configuration_guide/sect-client-tools