Change logging levels in Jira Server

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform Notice: Server and Data Center Only - This article only applies to Atlassian products on the server and data center platforms.

Purpose

The purpose of this article is to show how you can set the logging level for a package in JIRA.

Solution

Setting the logging level temporarily

There are options within JIRA to temporarily configure the logging level for a package using the Logging and Profiling page:

  • To increase/decrease the logging level for a package already listed, choose the level on the right hand side in the 'Set Logging Level' column.
  • To set the logging level for another package, that isn't listed, choose the option to Configure logging level for another package. That will prompt you to specify the package and logging level.

Setting the logging level permanently

The information in this page relates to customizations in JIRA. Consequently, Atlassian Support cannot guarantee to provide any support for the steps described on this page as customizations are not covered under Atlassian Support Offerings. Please be aware that this material is provided for your information only and that you use it at your own risk.

Also, please be aware that customizations done by directly modifying files are not included in the upgrade process. These modifications will need to be reapplied manually on the upgraded instance.

If you are looking to set the logging level for a package permanently, you can do so by configuring the log4j.properties file, located in the $JIRA_INSTALL/atlassian-jira/WEB-INF/classes/ directory.

Example of setting the logging level for a package in log4j.properties.
  • Look at the logging level for the package com.atlassian.jira.issue.index we can see it is set to INFO level logging:
log4j.logger.com.atlassian.jira.issue.index = INFO, console, filelog
  • To persistently set this to DEBUG level logging, you'll want to update the logger config for that package. In this example we have commented out the INFO level logger, and added a DEBUG level logger for the com.atlassian.jira.issue.index package:
#log4j.logger.com.atlassian.jira.issue.index = INFO, console, filelog
log4j.logger.com.atlassian.jira.issue.index = DEBUG, console, filelog

(info) Restarting JIRA is necessary to pick up any changes to log4j.properties

Last modified on Sep 25, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.