# Jenkins & Cloudbees Integration

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

1\. On Jenkins, open the user dropdown on the top bar and click the **"Configure"** option. 

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

2\. Generate a new API Token.

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

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

## **2. Install Jenkins Addon on Oobeya** :jigsaw: 

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. 

<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&#x26;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;

* [Add a new Widget](https://docs.oobeya.io/dashboards/adding-a-new-widget)