Adding an additional logger for troubleshooting the Atlassian Bitbucket Integration plugin

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

If you encounter an issue with our official Atlassian Bitbucket Integration plugin and can not find any errors in the Bitbucket logs, you might need to add an additional logger in Jenkins, to be able to fully troubleshoot the problem.

To add it, please:

  1. Go to Manage Jenkins -> System Log -> Log Recorders.

  2. Click ‘Add new log recorder’

  3. Configure it for com.atlassian and save:

  4. (Auto-migrated image: description temporarily unavailable)

    ⚠️ WARNING: Setting the log level to ALL might produce very verbose output causing Jenkins performance issues. Please set up the level accordingly. ⚠️

  5. Push a new commit to a repo in Bitbucket that we’d expect to trigger a build in Jenkins.

  6. Go to ‘Log records’ in your new logger, and check for any ERROR messages.

A sample output for a successfully configured plugin:

1 2 3 4 5 6 7 8 9 10 11 Jan 06, 2021 7:33:30 PM FINE com.atlassian.bitbucket.jenkins.internal.http.HttpRequestExecutorImpl Bitbucket - call successful Jan 06, 2021 7:33:30 PM INFO com.atlassian.bitbucket.jenkins.internal.trigger.register.BitbucketWebhookHandler lambda$findSame$5 Found an existing webhook - {"id":6,"name":"ab88e816a6f116eb52532ef921bfc7deedb48e8b","url":"http:\/\/macos:8080\/bitbucket-server-webhook\/trigger","events":["repo:refs_changed"],"active":true} Jan 06, 2021 7:33:30 PM INFO com.atlassian.bitbucket.jenkins.internal.trigger.BitbucketWebhookTriggerImpl$BitbucketWebhookTriggerDescriptor registerWebhook Webhook returned -{"id":6,"name":"ab88e816a6f116eb52532ef921bfc7deedb48e8b","url":"http:\/\/macos:8080\/bitbucket-server-webhook\/trigger","events":["repo:refs_changed"],"active":true} Jan 06, 2021 7:33:30 PM FINE com.atlassian.bitbucket.jenkins.internal.http.HttpRequestExecutorImpl Bitbucket - call successful

If you’re still not able to spot any issue or resolve it, please contact support.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.