Enable mail debugging mode in Confluence Data Center and Server
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
To detail clearly how to enable debug mode for both the incoming and outgoing emails in Confluence.
Solution
This feature is only available on Confluence Data Center 7.20 or later.
You need System Administrator global permissions to do this.
Change the logging level of the com.atlassian.confluence.mail.session package
Go to Administration > General Configuration > Logging and Profiling.
If you run Confluence in a cluster, select a cluster node.
Locate the
com.atlassian.confluence.mail.sessionpackage, and select DEBUG value from the New Level menu.Save your changes.
Remember, your changes will not be written to the log4j.properties file and will be discarded when you next stop Confluence.
To enable email logging at the protocol level (more verbose), add -Dmail.debug=true to the Confluence System Properties.
For more information on the subject, refer to Configuring Logging on Confluence Server and Data Center.
ℹ️ Keep in mind that the primary goal of debug logging is troubleshooting. It is good practice to disable the debug logging after the problem is solved to avoid potential performance impacts and logs with too many entries.
Was this helpful?