Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
##==========================================
##
## SU logging
##
log4j.appender.SUFileLog=com.atlassian.jira.logging.JiraHomeAppender
log4j.appender.SUFileLog.File=su.log
log4j.appender.SUFileLog.MaxFileSize=20480KB
log4j.appender.SUFileLog.MaxBackupIndex=5
log4j.appender.SUFileLog.layout=org.apache.log4j.PatternLayout
log4j.appender.SUFileLog.layout.ConversionPattern=%d %t %p [%c{4}] %m%n
log4j.appender.SUFileLog.Threshold=INFO
  
#
# add entries for all SU packages
#
log4j.logger.com.javahollic.jira.jsu=INFO, console, filelog, SUFileLog
log4j.logger.com.javahollic.jira.web.action=DEBUG, console, filelog, SUFileLog
log4j.additivity.com.javahollic.jira.jsu=false

Jira 9.5.0 and above Log4j2 XML configuration

Status
colourBlue
titleRESTART REQUIRED

Jira 9.5.0 has upgraded the Log4j runtime logging library to version 2. Log4j2 uses XML configuration file format. With the following configuration, Jira will create a su.log file in JIRA_HOME/log.  A Jira restart will be required to make the changes apply.

  1. Go to yourJIRA_INSTALL_DIR/atlassian-jira/WEB-INF/classes/log4j2.xml file

  2. Add the following lines above the closing Appenders tag </Appenders> (around line number 257) :

Code Block
<!--        #####################################################-->
<!--        # SU APPENDER STARTS                                 -->
<!--        #####################################################-->

<JiraHomeAppender name="SUFileLog"
                  fileName="su.log"
                  filePattern="su.log.%i">
    <PatternLayout alwaysWriteExceptions="false">
        <Pattern>
            %d %t %p [%c{4}] %m%n
        </Pattern>
    </PatternLayout>
    <Policies>
        <SizeBasedTriggeringPolicy size="20480KB"/>
    </Policies>
    <DefaultRolloverStrategy fileIndex="min" max="5"/>
</JiraHomeAppender>

<!--        #####################################################-->
<!--        # SU APPENDER ENDS                                   -->
<!--        #####################################################-->

3. Add the following lines above the closing Loggers tag </Loggers> (at the bottom, around line number 839) :

Code Block
<!--        #####################################################-->
<!--        # SU LOGGER REF STARTS                               -->
<!--        #####################################################-->

<Logger name="com.javahollic.jira.jsu" level="DEBUG" additivity="false">
    <AppenderRef ref="SUFileLog"/>
</Logger>

<!--        #####################################################-->
<!--        # SU LOGGER REF ENDS                                 -->
<!--        #####################################################-->

Centrally logging?

After enabling logging, in 1.8.5+ the following will be seen for SU and SU-Exit actions:

...