# GitLab Integration
[GitLab](https://about.gitlab.com/) 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](https://docs.ilert.com/alerting/configure-alerting/alert-sources#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
{% hint style="info" %}
This setting is optional but we still recommend enabling it for a better user experience.
{% endhint %}
1. Now click on **GitLab Settings** to show the advanced settings
2. 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**)
3. Some **Hook types** do additionally have a selection for an **Event type**.
4. Click on **Save** to proceed to the next step.
5. 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"**
2. 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.
3. Select "**Add Webhooks**"
4. and if it is added successfully it will be shown at the bottom of the page.
5. Your GitLab integration is set up.
