This page last changed on Oct 31, 2007 by rosie@atlassian.com.
A common task when identifying JIRA problems is to turn up the log level, to get more debug-level logs. For short-term logging, this can be done in Administration -> Logging and Profiling, but this won't persist across JIRA restarts. To set the log level more permanently, do as follows:
In JIRA Standalone
- Edit atlassian-jira/WEB-INF/classes/log4j.properties
- In 3.7 and above: locate the section:
and change the WARN to DEBUG.
In 3.6.5 and earlier: locate the section:
and below it, add the section:
- Restart JIRA Standalone by running the shutdown and startup scripts.
JIRA deployed as a Webapp
In the Webapp/WAR distribution (used to build a webapp for deployment):
- copy webapp/WEB-INF/classes/log4j.properties to edit-webapp/WEB-INF/classes/log4j.properties
- edit edit-webapp/WEB-INF/classes/log4j.properties, making the same changes as above, so in the end you have:
- Run build.sh or build.bat to rebuild the webapp
- Redeploy the new webapp in your app server.
Background
JIRA's logging output is classified by importance, with the levels being:
- DEBUG: low-level details most people never need to know about.
- INFO: Informational messages on what JIRA is doing. Usually not interesting.
- WARN: Warnings that something may have gone wrong, or other messages a sysadmin may wish to know.
- ERROR: Something went wrong in JIRA. The person responsible for configuring JIRA should be notified
The default level is WARN, meaning warnings and errors are displayed. Sometimes it is useful to adjust this level to see more details.
Alternatively you can turn up logging for just one section. For instance, to see user authentication logs, locate the lines:
log4j.category.com.opensymphony = WARN, console
log4j.additivity.com.opensymphony = false
and change WARN to DEBUG.
Once the app server is restarted, you should see significantly more logs being generated.
Related pages
No content found for label(s) logging. |
|