Skip to content

GitLab Version Tags

This tutorial demonstrates how to integrate Coralogix with your GitLab deployment pipelines.

Configuration

Use GitLab webhooks to inform Coralogix when a new build is issued.

STEP 1. Log in to GitLab using your credentials and navigate to your project page.

STEP 2. Click Settings > Webhooks.

STEP 3. Add the following URL:

https://ng-api-http.DOMAIN/api/v1/external/gitlab?application=APPLICATION_NAME&subsystem=SUBSYSTEM_NAME&name=TAG_NAME

Insert the following parameters:

DOMAIN: Coralogix domain associated with your account

APPLICATION_NAME: Application name as it appears in your Coralogix UI

SUBSYSTEM_NAME: Subsystem name as it appears in your Coralogix UI. Add one or more subsystem names separated by a comma.

TAG_NAME - Tag name. If this parameter is not inserted, values are taken from GitLab payload fields project.name and object_attributes.ref, as explained here.

STEP 4. To use this API you need to create a personal or team API key. It’s recommended to use permission presets, as they are automatically updated with all relevant permissions. Alternatively, you can manually add individual permissions.

PresetActionDescription
CICDIntegrationVERSION-BENCHMARK-TAGS:READ
VERSION-BENCHMARKS-REPORTS:READ
VERSION-BENCHMARK-TAGS:UPDATE
View Version Benchmark Tags
View Version Benchmark Reports
Modify Version Benchmark Tags

Notes:

  • The Secret Token is obligatory.

  • Input the Secret Token in the Secret Token field below the URL in GitLab.

STEP 5. Select Pipeline events as a trigger and click save changes.

coralogix integration to Gitlab

Additional Resources

DocumentationGitLab Data Ingestion

Support

Need help?

Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.

Feel free to reach out to us via our in-app chat or by sending us an email at [email protected].