GitLab Integration

GitLab is a web-based Git repository that provides free open and private repositories, issue-following capabilities, and wikis. It is a complete DevOps platform that includes CI/CD. With the GitLab integration, alerts from failed pipelines, vulnerabilities, or merge-request issues are captured and forwarded to on-call teams via ilert. This ensures engineers are alerted promptly and escalation paths activate, speeding up CI/CD issue remediation.

In ilert: Create a GitLab alert source

1. Go to Alert sources --> Alert sources and click on Create new alert source

   
2. Search for GitLab in the search field, click on the GitLab tile and click on Next.

   
3. Give your alert source a name, optionally assign teams and click Next.

4. Select an escalation policy by creating a new one or assigning an existing one.

   
5. Select you Alert grouping preference and click Continue setup. You may click Do not group alerts for now and change it later.

   
6. The next page show additional settings such as customer alert templates or notification prioritiy. Click on Finish setup for now.

7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   

GitLab advanced settings

1. Now click on GitLab Settings to show the advanced settings

1. You may now choose one of the given Hook types which this alert source should process. (Leaving the selection on 'Select' will result the alert source to process all incoming Hook types)

1. Some Hook types do additionally have a selection for an Event type.

2. Click on Save to proceed to the next step.

1. On the next page a GitLab Integration URL is generated. You will need the URL for the webhook configuration

In GitLab

1. From your Project Page, navigate to "Settings" -> "Webhooks"

1. Select the events that should be send to ilert, in this case any Issues events or Confidential issues events activity will be send to ilert.

1. Select "Add Webhooks"

2. and if it is added successfully it will be shown at the bottom of the page.

1. Your GitLab integration is set up.