You can configure vRealize Business for Cloud to send the log details to your Syslog server for analyzing the operational visibility and providing a faster troubleshooting procedure.

Prerequisites

Procedure

  1. Log into vRealize Business for Cloud by using the system administrator credentials.
  2. Open the log4j2.xml file from the /usr/local/tomcat/itbm-server/webapps/itfm-cloud/WEB-INF/classes/ location.
  3. Select the relevant data delivery format.
    • Non-Secured Syslog Appender - BSD Format
    • Non-Secured Syslog Appender - RFC5424 Format
    • Secured TCP Syslog Appender
  4. Add or update the following lines in the <Appenders> tag.
    Option Description
    For BSD Format <Syslog name="BSDSyslogAppender" host="SYSLOG_SERVER_HOST" port="SYSLOG_SERVER_PORT" protocol="TCP"/>
    For RFC5424 format <Syslog name="RFC5424SyslogAppender" format="RFC5424" host="10.23.216.36" port="SYSLOG_SERVER_PORT" protocol="UDP" appName="vRB" mdcId="mdc" includeMDC="true" facility="LOCAL0" enterpriseNumber="12345" newLine="true" messageId="Audit" id="vRBApp"/>
    For TCP Syslog Appender
    1. Copy the TrustStore with the system log server certificate to the vRealize Business for Cloud virtual appliance.
    2. Add or update the following lines in the <Appenders> tag.
      <Syslog name="securedSyslogAppender" host="SYSLOG_SERVER_HOST" port="SYSLOG_SERVER_PORT" protocol="UDP" appName="vRB" 
              mdcId="mdc" includeMDC="true" facility="LOCAL0" enterpriseNumber="12345" newLine="true" messageId="Audit" id="vRBApp">
        <SSL>
          <TrustStore location="TRUSTSTORE_PATH" password="TRUSTSTORE_PASSWORD"/>
        </SSL>
      </Syslog>
  5. Add or update the following line in the <Root> tag.
    Note: In some of the log files, the AppenderRef tag is Appender-Ref. Do not change the parameter name.
    • For BSD format - <AppenderRef ref="BSDSyslogAppender"/>
    • For RFC5424 format - <AppenderRef ref="RFC5424SyslogAppender"/>
    • For TCP Syslog Appender - <AppenderRef ref="securedSyslogAppender"/>
  6. Perform the same changes to the log4j2.xml file in the following locations.
    • /usr/local/tomcat/itbm-server/webapps/itfm-cloud-dc-transformer/WEB-INF/classes/log4j2.xml
    • /usr/local/tomcat/itbm-data-collector/webapps/itfm-cloud-vca-dc/WEB-INF/classes/log4j2.xml
    • /usr/local/tomcat/itbm-data-collector/webapps/itfm-cloud-vc-dc/WEB-INF/classes/log4j2.xml
    • /usr/local/tomcat/itbm-data-collector/webapps/itfm-cloud-srm-dc/WEB-INF/classes/log4j2.xml
    • /usr/local/tomcat/itbm-data-collector/webapps/itfm-cloud-vcd-dc/WEB-INF/classes/log4j2.xml
    • /usr/local/tomcat/itbm-data-collector/webapps/itfm-cloud-aws-dc/WEB-INF/classes/log4j2.xml
    • /usr/local/tomcat/itbm-data-collector/webapps/itfm-cloud-vra-dc/WEB-INF/classes/log4j2.xml
  7. Restart your vRealize Business for Cloud server.