Troubleshooting Notifications (Email & IM)

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.

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

If you are having problems integrating Bamboo with your Jabber or Mail server or if you have trouble sending notifications to a specific recipient, the following steps can help in adding verbose log entries in the log that helps to debug the issue.

Debugging Mail Server

Bamboo uses JAVA Mail library to send email notification, To debug JAVA Mail:

  1. Shutdown Bamboo;
  2. Add the following parameter to the bamboo startup script:

    -Dmail.debug=true
  3. Setting log properties:

    1. For Bamboo versions prior 9: Add the following lines to <bamboo-install>/atlassian-bamboo/WEB-INF/classes/log4j.properties (or you can add it in Bamboo UI under Overview → Log settings):

log4j.logger.com.sun.mail=DEBUG
log4j.logger.com.atlassian.bamboo.mail=DEBUG
log4j.logger.com.atlassian.bamboo.notification=DEBUG
    1. For Bamboo version 9 and above Add the following lines to <bamboo-install>/atlassian-bamboo/WEB-INF/classes/log4j2.properties (or you can add it in Bamboo UI under Overview → Log settings):

logger.sun-mail.level=DEBUG
logger.sun-mail.name=com.sun.mail

logger.bamboo-mail.level=DEBUG
logger.bamboo-mail.name=com.sun.mail

logger.bamboo-notification.level=DEBUG
logger.bamboo-notification.name=com.atlassian.bamboo.notification
  1. Start Bamboo and test the mail server configuration.

Debugging IM Server

To debug your XMPP session:

  1. Add -Dsmack.debugEnabled=true to Bamboo's start-up parameters and disable headless mode by setting the parameter -Djava.awt.headless=false;
  2. Restart Bamboo;
  3. Test the IM Server, and a window will appear similar to the image below: 

Debugging Notifications

To check if Bamboo has sent a notification to particular recipient, you may enable DEBUG logging in Bamboo UI under Bamboo administration -> Log settings and choose the type as follows appropriately for the below classes:

ClassPathType
com.atlassian.bamboo.notificationALL
com.atlassian.bamboo.mailDEBUG
com.atlassian.bamboo.authorDEBUG
com.atlassian.bamboo.commitDEBUG

Once enabled, reproduce the issue and check your atlassian-bamboo.log for relevant useful entries like below:

2020-04-08 17:05:22,469 DEBUG [AtlassianEvent::0-BAM::EVENTS:pool-1-thread-13] [ChainCompletedNotificationListener] Completed Chain Notification Listener checking for notifications to send for PROJ-PLANKEY-12
2020-04-08 17:05:22,497 DEBUG [AtlassianEvent::0-BAM::EVENTS:pool-1-thread-13] [ChainCompletedNotificationListener] Completed chain notification (class class com.atlassian.bamboo.notification.chain.ChainFailedAndFirstFixedNotificationType ) rule found for recipient: , type: com.atlassian.bamboo.plugin.system.notifications:recipient.committer...

2020-08-25 16:37:20,904 DEBUG [AtlassianEvent::0-BAM::EVENTS:pool-1-thread-15] [CommitterRecipient] Author Lastname, Firstname <firstname@corp.com> does not have a linked user. Skipping
Last modified on Aug 17, 2022

Was this helpful?

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