> For the complete documentation index, see [llms.txt](https://docs.oobeya.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oobeya.io/integrations/all-integrations/scm-addons/jenkins-integration.md).

# Jenkins & Cloudbees Integration

Learn about Jenkins & Oobeya integration.

## 1. **Generate Jenkins API Token**

1\. On Jenkins, open the user dropdown at the top right and click the **"Security"** option.&#x20;

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FOODRGLpChJIq34IeVwWv%2Fimage.png?alt=media&amp;token=2b84d16c-6252-4369-8482-d7845c8bca4b" alt=""><figcaption></figcaption></figure>

2\. Generate a new API Token by clicking "Add new token".

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F5Xti0ppB67xUgS82dYIl%2Fimage.png?alt=media&amp;token=de45d22c-b89d-43ce-bcd4-0e484bf02d5c" alt=""><figcaption></figcaption></figure>

3\. Copy and save the *API Token* to use on the Oobeya data source connection.

## **2. Install Jenkins Addon on Oobeya** :jigsaw:&#x20;

1. Log in to [Oobeya](https://oobeya.io/) with an *Administrator* account.
2. Navigate to **Integrations**, select the Jenkins addon, and click the **"Install"** button.&#x20;

<figure><img src="https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FBWfPj77KJzKvFITHLc9k%2FScreenshot%202024-12-17%20at%2011.29.17.png?alt=media&amp;token=7aeee9f6-adbc-4f2e-b969-7ab01cc0df60" alt=""><figcaption></figcaption></figure>

## **3. Add A New Data Source** :electric\_plug:&#x20;

1\. Navigate to **Data Sources**, and select Jenkins to add a new data source.&#x20;

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FlPEJ9ZdExRIcbNRLGeMm%2Ffile.png?alt=media)

2\. Click the **"New Data Source"** button and fill in the form by using the *API Token* which was created on Jenkins settings in the first step.&#x20;

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2Fv3pOYb7pNqJpxTsUF88b%2Ffile.png?alt=media)

3\. Click the **"Test Connection"** button to verify the connection.

## **Ready to Connect** :rocket:&#x20;

Now Oobeya is connected with your own Jenkins server to monitor the health status of your pipelines and track key metrics such as *time-to-fix, average deployment duration...*

## **Next Steps** :dart:&#x20;

* [Network Access Requirements ](/integrations/network-access-requirements.md)
* [Create a new Gitwiser Analysis](/gitwiser-repo-analytics/settings-for-git-analytics/initialize-development-analytics.md)
