Integrating third-party services

Integrations allow you to use information from external sources like GitHub and Jenkins. The more services that are integrated, the more complete the picture you can create.

CloudBees Engineering Efficiency uses data from these third-party services to provide metrics and actionable insights. Some integrations are required to use the screens; others are optional. The table below details which integrations are required and optional using icons:

  • A required integration uses the check circle icon .

  • An optional integration uses the plus circle icon .

  • No impact from an integration uses the minus circle icon .

Table 1. Required and optional integrations for each screen
Screen Jira Cloud/Jira Server GitHub/GitHub Enterprise CloudBees CI/Jenkins

Investment area

Activity

CI/CD performance

Cycle time

Open pull requests

Requirements

You can integrate any third-party services with an available app for CloudBees Engineering Efficiency. Refer to Viewing a list of active integrations for instructions.

In general, for any app you wish to install, you need:

  • A CloudBees Engineering Efficiency account with an admin role.

  • An account with admin rights on the third-party service, for example, admin rights for a GitHub organization or admin rights on a Jira account.

Refer to Setting up integrations for instructions.

Viewing a list of active integrations

This procedure requires CloudBees Engineering Efficiency administrator rights.

From the Integrations screen, you can see all of the external systems that are connected to CloudBees Engineering Efficiency.

To view a list of active integrations:

  1. Sign in to CloudBees Engineering Efficiency as an admin.

  2. In the top right, select your organization to open the User profile menu and then select your name.

  3. In the left navigation, select Engineering Efficiency  Apps.

Active apps are listed in the Installed section.

Viewing connected GitHub repositories

All repositories that are available within CloudBees Engineering Efficiency are listed on Manage repositories. By default, they are sorted alphabetically by repository name. However, you can filter them by organization name instead.

Knowing the organization associated with the repository helps you to locate it.

When GitHub integration is configured, either all repositories from an organization are included or only selected repositories are included. If the repository you are looking for is not listed when linking a repository to a product, the CloudBees Software Delivery Management may be set to only import specific repositories.

To view connected GitHub repositories:

  1. Sign in to CloudBees Engineering Efficiency as an admin.

  2. In the top right, select your organization to open the User profile menu and then select your name.

  3. In the left navigation, select Engineering Efficiency  Apps.

  4. Select GitHub.

  5. Select Configuration.

  6. Select the organization that contains the repository you want to find.

You should be able to locate the repository in the Repository name column. You can select the repository name to go to that repository in GitHub.

Viewing a list of connected Jenkins controllers

The Jenkins integration uses the connected Jenkins controllers.

To view a list of connected Jenkins controllers:

  1. Sign in to CloudBees Engineering Efficiency as an admin.

  2. In the top right, select your organization to open the User profile menu and then select your name.

  3. In the left navigation, select Engineering Efficiency  Apps.

  4. Select Jenkins from the list of apps.

  5. Select the Configuration tab.