# Gerrit Integration

This guide provides a step-by-step walkthrough to integrate your **Gerrit** code review system with **Oobeya** to track engineering metrics and DORA analytics.

***

### 1. Create Gerrit HTTP Credentials 🔑

To allow Oobeya to access your Gerrit repositories, you need to generate an HTTP access token.

1. **Access Settings:** Click the user icon in the top-right corner of your Gerrit UI, navigate to **Settings**.
2. **Generate Token:** Open the **"HTTP Credentials"** tab on the left sidebar and click the **"Generate New Password"** button.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2Fz2IpvfG94IG6miv3zkOW%2Fimage.png?alt=media&#x26;token=17296043-053b-44f7-8707-d5f955ce912b" alt=""><figcaption></figcaption></figure>

3. **Secure Your Password:** Copy and save the generated password immediately. You will need this for the Oobeya data source configuration.

***

### 2. Install Gerrit Add-on on Oobeya 🧩

Before connecting your data, ensure the Gerrit integration is active in your Oobeya instance.

1. Log in to **Oobeya** with an **Administrator** account.
2. Navigate to **Integrations** from the side menu.
3. Locate the **Gerrit** add-on and click the **"Install"** button.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FSO4kJYo36b6HpAIBO2WX%2Fimage.png?alt=media&#x26;token=18ad960a-0944-4e30-ba35-089ff8e39600" alt=""><figcaption></figcaption></figure>

***

### 3. Add A New Data Source 🔌

Now, connect your Gerrit server to start fetching data.

1. Navigate to **Data Sources** and select **Gerrit** from the SCM & CI/CD category.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F2nVHekSmJ0srUQkPQjEG%2Fimage.png?alt=media&#x26;token=562e0b18-d4ee-4e63-9a83-e86743491003" alt=""><figcaption></figcaption></figure>

2. Click the **"New Data Source"** button and fill in the required fields:

* **Server URL:** Your Gerrit instance URL (e.g., `https://gerrit.yourdomain.com`).
* **Username:** Your Gerrit username.
* **Token:** The **HTTP Password** you generated in Step 1.

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F0oURgmujjsOy2gsEtvTD%2Fimage.png?alt=media&#x26;token=04c46646-40bf-4fcb-91be-ba5d832e01e1" alt=""><figcaption></figcaption></figure>

3. Click **"Test Connection"** to verify the credentials.
4. Once verified, click **"Add"** to finalize the setup.

***

### Ready to Connect 🚀

**Congratulations!** Oobeya is now connected to your Gerrit server. It will begin pulling real-time statistics from your repositories to track development velocity, code review cycles, and team performance.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oobeya.io/integrations/all-integrations/scm-addons/gerrit-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.