KB-1055 How to enable JBoss access logs

Purpose

This article outlines how to enable the access logs in JBoss EAP. Appian Technical Support may request these logs to troubleshoot issues.

Instructions

  1. On the application server machine, navigate to <JBOSS_HOME>/standalone/configuration.
  2. Make a copy of standalone.xml. Save it as standalone.xml.bak, for example.
  3. Edit the original standalone.xml.
  4. Find the <virtual-server> element under the urn:jboss:domain:web:X.Xsubsystem.
  5. Change the value of enable-welcome-root from true to false.
  6. Remove the <alias name="example.com"/> line.
  7. Add the following element after the <system-properties> element, replacing <APPIAN_HOME> with the path to your Appian directory:

    <paths>
    <path name="appian-base-dir" path="<APPIAN_HOME>" />
    </paths>
    

    Note: <APPIAN_HOME> is specified here, however any directory can be used in most scenarios. Keep in mind that if you are running a Health Check, you must use <APPIAN_HOME>. The logs will be placed in the directory specified in the above element.

  8. Add the following element inside of the <virtual-server> element:

    <access-log extended="true" resolve-hosts="false" prefix="jboss1-access.log." pattern="date time cs-uri x-P($bgUrl) sc-status time-taken">
    <directory path="logs" relative-to="appian-base-dir" />
    </access-log>
    
  9. Restart JBoss.

To disable the access logs, replace the above changes in standalone.xml with what's present in standalone.xml.bak and restart JBoss.

For more information, refer to Redhat's documentation on How to enable access logging for JBoss EAP 6.

For cloud customers, the access logs are enabled by default. You can access these logs by navigating to https://<APPIAN_URL>/suite/logs and searching for the logs named jboss1-access.log.YYYY-MM-DD.

Affected Versions

This article applies to all versions of Appian using JBoss EAP as an application server.

Last Reviewed: February 2017

Related
Recommended