You can configure the vRealize Business for Cloud log files to send the details to the system log servers such as vRealize Log Insight for analyzing the operational visibility and provide 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/tcserver/vfabric-tc-server-standard/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>
    Note:

    The port number for vRealize Log Insight is 6514. You can change the port number based on the log server that you want to use.

  5. 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/tcserver/vfabric-tc-server-standard/itbm-server/webapps/itfm-cloud-dc-transformer/WEB-INF/classes/log4j2.xml

    • /usr/local/tcserver/vfabric-tc-server-standard/itbm-data-collector/webapps/itfm-cloud-vca-dc/WEB-INF/classes/log4j2.xml

    • /usr/local/tcserver/vfabric-tc-server-standard/itbm-data-collector/webapps/itfm-cloud-vc-dc/WEB-INF/classes/log4j2.xml

    • /usr/local/tcserver/vfabric-tc-server-standard/itbm-data-collector/webapps/itfm-cloud-srm-dc/WEB-INF/classes/log4j2.xml

    • /usr/local/tcserver/vfabric-tc-server-standard/itbm-data-collector/webapps/itfm-cloud-vcd-dc/WEB-INF/classes/log4j2.xml

    • /usr/local/tcserver/vfabric-tc-server-standard/itbm-data-collector/webapps/itfm-cloud-aws-dc/WEB-INF/classes/log4j2.xml

    • /usr/local/tcserver/vfabric-tc-server-standard/itbm-data-collector/webapps/itfm-cloud-vra-dc/WEB-INF/classes/log4j2.xml

  7. Restart your vRealize Business for Cloud server.