Source Code Management (Git) Systems Integration

Owned by Natallia_Mendzel@epam.com
Last updated: Oct 10, 2023 by Anastasia Baranouskaya
4 min read

Metrics calculated by GIT data

Having configured GIT the following metrics will be available: 

Select data source

1. On the main menu, click Perf, and then open the required unit.

2. On the right of the toolbar, click the Configure Data Sources icon. The Data Sources Configuration Step 1. Choose Data Source opens.

3. On the Step 1. Choose Data Source select your data source.

PERF application supports several services for GIT hosting server:

  • Azure Repos GIT;

  • BitBucket;

  • BitBucket Server (Stash);

  • GitHub;

  • GitLab.

4. On the Step 2. Configure Source set data source configuration.

1. Configure credentials

Configure Git Lab

On how to obtain Access Tokens please refer to https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html.

Minimum required scopes for Personal Access Tokens: GitLab: read_api, read_repository 

If you use https://git.epam.com/ for successful repository name validation also need to provide to user auto_epm-dce_perf-vcs@epam.com permissions on your project (Reporter will be enough)

Configure Git Hub

  • Provide API URL. API url usually differs from the web url you see in your web browser. For GitHub cloud the API url is  https://api.github.com  (more information here), for GitHub Enterprise the API url is http(s)://[hostname]/api/v3/ (more information here);

  • Provide Instance URL. GitHub instance URL ishttps://github.com.

  • Specify Username;

  • Enter API Token;

  • Click Connect.

Configure Bitbucket (cloud)

Configure Bitbucket Server (Stash)

  • Provide API URL;

  • Provide Instance URL;

  • Specify Project;

  • Connect by:

    • Login (Bitbucket username) & Password, or

    • API Token;

  • Click Connect.



Configure Azure Repos

  • Provide API URL. API URL has to contain an organization name. Ex.: https://dev.azure.com/myorganization.

  • Provide Instance URL;

  • Specify Project;

  • Connect by:

    • Login & Password, or

    • API Token;

  • Click Connect.



GITLab

GITHub

GITLab

GITHub



Bitbucket

Azure Repos

Bitbucket (cloud)

Bitbucket Server (Stash)

2. Configure Repositories and Branches

 

  1. Open the Repositories/Branches step.

  2. Select the required repository (you can use the Search function).

To add another repository, click on "Add Repository +"

  1. For the added repository, select the necessary branches using the search feature.

To select all availble branches, click 3-dots button and select “All Brunches”

  1. Cleck Next.

4. Configure advanced settings

The configuration of the Advanced settings is optional. The advanced settings are as follows:

Optional Action

Metric Affected

Optional Action

Metric Affected

Select the Include merge requests into statistics checkbox

Biggest Commits

In the Files to Exclude box, enter file wildcards to exclude files with the defined extensions

Most Frequently Modified Files

5. Complete configuration process 

To complete GIT configuration:

  1. Click Save. The Run Data Load button appears.

  2. Click Run Data Load to start data loading from GIT.