GITLAB CI Integration
- Aliaksandr_Sirenka
- Anastasia Baranouskaya
- Aleksandr Bogush
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.
Project ID
Project ID can be found for example on the Edit Project page in the top right corner. You can see the ID on the CI/CD pipelines page as well, in the example code of the Triggers section. In older versions, you can see it on the Triggers page, in the URLs of the example code.
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.
In case you have configured the data source before, you will see only selected items in the corresponding drop-down list. To see all available items, click a button 'Get list of ...'
List of jobs contains unique names from the 400 jobs which where run last dayes. If you need any specific, you can type name manually.
5. Click Save to finish.
6. Click Run Data Load to start a data load.