The Support tab on the Dataplane Reports » Administration page shows a number of key properties of your Jira and Dataplane instance. This information is particularly helpful to reference whenever working with Arsenale Support to debug and resolve a possible Dataplane issue.
Enabling Debug Logging
When working with Arsenale Support, you may be asked to enable Dataplane debug logging on this page to see and share more-verbose Dataplane status information. To enable this feature, click the Enabled checkbox next to the Debug Logging option.
Logging to a Separate Dataplane Log File
By default, Dataplane log output is intermixed with all other Jira application log output in file
/log/atlassian-jira.log. When debugging Dataplane, it's often most useful to see the app's log output in this context, in order to understand what else was going on in Jira during Dataplane activity and error conditions.
But sometimes it can be useful to direct all Dataplane log output to its own, separate log file; for example, if the default Jira log is too noisy with information, or Dataplane itself is overwhelming the default Jira log with too much detail.
To direct Dataplane log output to its own log file:
Append the following statements to the bottom of file
atlassian-jira/WEB-INF/classes/log4j.properties, located in your Jira installation directory. These changes create a dedicated
/log/dataplane.logfile, with up to ten, 20MB log file rotations.
After modifying the
log4j.propertiesfile, restart Jira to pick up the new logging configuration.
If running multiple Jira Data Center nodes, repeat the above steps for EACH Jira node in the cluster.
When updating Jira versions, file
atlassian-jira/WEB-INF/classes/log4j.properties will be replaced. Remember to re-apply the above logging configuration changes after each Jira version update.