---
title: Bitbucket
description: Bitbucket is a free code DVCS hosting site for Git and Mercurial.
breadcrumbs: Docs > Integrations > Bitbucket
---

# Bitbucket
Integration version1.0.0Bitbucket Overview Dashboard
{% video
   url="https://docs.dd-static.net/images/integrations/bitbucket/integrations-bitbucket.mp4" /%}

## Overview{% #overview %}

Capture commits and pull requests events directly from Bitbucket Cloud or Server to:

- Keep track of code changes in real time
- Add code change markers on all of your dashboards
- Discuss code changes with your team

Once the integration is set up, items you select (commits and/or pull requests) populate in your Datadog Event Stream.

**Examples**:

- When commits are made.
- When a PR is created.
- When a comment is made/deleted on a PR.

## Setup{% #setup %}

### Installation{% #installation %}

See Bitbucket's documentation to [Manage webhooks](https://confluence.atlassian.com/bitbucket/manage-webhooks-735643732.html) for any Bitbucket behaviors you want to track in Datadog. Set the webhook URL to:

```text
https://app.datadoghq.com/intake/webhook/bitbucket?api_key=<YOUR_DATADOG_API_KEY>
```

See Bitbucket's documentation to [Manage IP addresses](https://support.atlassian.com/organization-administration/docs/ip-addresses-and-domains-for-atlassian-cloud-products/) ensure you have the correct IP ranges allow-listed for outgoing connections so events are received as expected.

### Configuration{% #configuration %}

The [Bitbucket integration](https://app.datadoghq.com/integrations/bitbucket) is configured through the integration tile.

1. Enter the full name of each repository you want to monitor. If the URL for your repository is `https://bitbucket.org/groupname/reponame`, then enter `groupname/reponame` in the **Repository** textbox.

1. Select the type of events to send to Datadog:

   - Bitbucket Cloud: choose from the full list of triggers (Commits, Pull Requests, or Issues).
   - Bitbucket Server: select Commits or Pull Requests.

1. Click **Update Configuration**.

### Validation{% #validation %}

Each entry in the integration tile is validated when you enter it.

## Use case{% #use-case %}

Overlay Bitbucket events on your dashboard graphs by typing `sources:bitbucket` in the top left search bar. See the example GIF at the top of this page.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

The Bitbucket integration does not include any metric.

### Events{% #events %}

Bitbucket events, including commits and pull requests from both Bitbucket Cloud and Server, are forwarded to Datadog.

### Service Checks{% #service-checks %}

The Bitbucket integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).

## Further Reading{% #further-reading %}

- [Bitbucket + Datadog: See how code changes impact your infrastructure](https://www.datadoghq.com/blog/understand-code-changes-impact-system-performance-bitbucket-datadog/)
- [Bitbucket](https://docs.datadoghq.com/integrations/bitbucket.md)