Versions Compared

Key

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

Notification log

Every notification sent from the Notification Assistant for JIRA plugin are logged and can be found at <JIRA_HOME>/data/attachments/nafj/log/email.log. The log are rolled on daily basis.

Info

Logging is disabled by default. To enable logging, login to JIRA administration, go to System and "Logging and Profiling". Locate "com.riadalabs.jira.plugins.notificationassistant.log.NAFJEmailLogger" and set log level to "INFO". This has to be done after every restart of your JIRA server.

REST-API log

Every REST call sent from the Notification Assistant for JIRA plugin are logged and can be found at <JIRA_HOME>/data/attachments/nafj/log/rest.log. The log are rolled on daily basis.

 

...

Table of Contents

Temporary Logging

  1. Go to JIRA Administration>System>Logging and profiling

  2. Under Default Loggers, click "configure logging level for another package"

  3. For Package name enter com.riadalabs.jira.plugins.notificationassistant

  4. For Logging Level select DEBUG

  5. Press Add to save

  6. Email log output will now be added to JIRA's own atlassian-jira.log file

  7. To find the impacted lines, you can grep for c.r.j.p.n

Permanent Logging

Add the following to your <JIRA INSTALL DIRECTORY>/atlassian-jira/WEB-INF/classes/log4j.properties file. Changes to this file require a restart of Jira for the changes to take effect.

No Format
# ---------------------
#
#  NAFJ LOGGING STARTS
#

# Email logger
#
log4j.appender.NAFJEmailLog=com.atlassian.jira.logging.JiraHomeAppender
log4j.appender.NAFJEmailLog.File=nafj-email.log
log4j.appender.NAFJEmailLog.MaxFileSize=20480KB
log4j.appender.NAFJEmailLog.MaxBackupIndex=5
log4j.appender.NAFJEmailLog.layout=org.apache.log4j.PatternLayout
log4j.appender.NAFJEmailLog.layout.ConversionPattern=%d %t %p [%c{4}] %m%n
log4j.appender.NAFJEmailLog.Threshold=INFO

# Notification Manager logger
#
log4j.appender.NAFJManagerLog=com.atlassian.jira.logging.JiraHomeAppender
log4j.appender.NAFJManagerLog.File=nafj-manager.log
log4j.appender.NAFJManagerLog.MaxFileSize=20480KB
log4j.appender.NAFJManagerLog.MaxBackupIndex=5
log4j.appender.NAFJManagerLog.layout=org.apache.log4j.PatternLayout
log4j.appender.NAFJManagerLog.layout.ConversionPattern=%d %t %p [%c{4}] %m%n
log4j.appender.NAFJManagerLog.Threshold=INFO

#
# add entries for all NAFJ packages
#
log4j.logger.com.riadalabs.jira.plugins.notificationassistant.NotificationEmailHandlerImpl=INFO, NAFJEmailLog
log4j.additivity.com.riadalabs.jira.plugins.notificationassistant.NotificationEmailHandlerImpl=false
log4j.logger.com.riadalabs.jira.plugins.notificationassistant.NotificationManagerImpl=INFO, NAFJManagerLog
log4j.additivity.com.riadalabs.jira.plugins.notificationassistant.NotificationManagerImpl=false

#
#  NAFJ LOGGING ENDS
#
# --------------------

The logs will be at:

  • <JIRA_HOME>/log

...

  • /nafj-email.log
  • <JIRA_HOME>/log/nafj-manager.log