GITLAB CI Integration

Metrics calculated by GITLab CI data

Having configured GITLab CI the following metrics will be available:

To connect to GitLab CI it is necessary to:

1. Provide API URL.

API URL vs. Web URL

API url usually differs from the web url you see in your web browser. Pay attention on that to avoid entering invalid URLs. Details are at https://docs.gitlab.com/ee/api/

FYI: API requests should be prefixed with api and the API version. The API version is defined in lib/api.rb. For example, the root of the v4 API is at /api/v4. Example of a valid API request using URL: "https://gitlab.example.com/api/v4/projects"

2. Enter Login and Password.

For GitLab CI you may use a Personal Access Token leaving Login field blank. On how to obtain Access Tokens please refer to the following source: https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html

3. Enter Project ID.

4. Fill in at least one field in "Select parameters" box. This information will be used in metrics calculation:

Select jobs for overall monitoring - information will be used for the metrics:
Select jobs used for deployment to production environment/to other environment - information will be used for Deployment Frequency metric.
Select branches by name - information will be used for the metrics:
Select branches by mask (wildcard) - in case there is a range of a similar-named branches to be used type a 'mask' in to the field 'Select branches by mask (wildcard)'. For example some of project branches have a name starting with a "feature". In this case type a word "feature*" and all the branches with a name containing "feature" will be included into the calculation of metrics.

5. Click Save to finish.

6. Click Run Data Load to start a data load.