> For the complete documentation index, see [llms.txt](https://support.incidents.cloud.solarwinds.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.incidents.cloud.solarwinds.com/integrations/alert-source-integrations-native/gitlab.md).

# GitLab

Send events to Squadcast from GitLab

[<mark style="color:blue;">GitLab</mark>](https://gitlab.com/) is a web-based DevOps lifecycle tool that provides a Git repository manager providing wiki, issue-tracking, and continuous integration and deployment pipeline features, using an open-source license, developed by GitLab Inc.

Route detailed events from GitLab to the right users in Squadcast.

### How to integrate GitLab with Squadcast

### In Squadcast: Using GitLab as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media\&token=aaca6610-9d18-4dd4-9cf5-320042f326f1)

2\. Select **GitLab**. Copy the displayed **Webhook URL** to [configure](#in-gitlab-create-a-squadcast-webhook) it within **GitLab.** Finish by clicking **Add Alert Source** -> **Done**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-20f27427ed515e4204ef3f5a2f30fa477e2c60db%2FGitLab.png?alt=media\&token=abf5e430-a700-43d6-bd38-bc4966f8e352)

{% hint style="warning" %}
**Important:**

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### In GitLab: Create a Squadcast Webhook

You can configure a Webhook for a group or a project.

**(1)** In your project or group, on the left sidebar, select **Settings > Webhooks**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-236ce35323250d4913d331bb454b69ea3f22b599%2Fgitlab_2.png?alt=media\&token=1807ba66-cfc9-4126-92df-215336e72d35)

**(2)** In the placeholder for **URL**, paste the previously copied Webhook from Squadcast

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-548ffe3e4b2a759fe4d429fd6d1bf69762bc75ee%2Fgitlab_3.png?alt=media\&token=ccdd1dc7-1acb-4e36-8f49-9239606a8721)

**(3)** In the **Trigger** section, select the **below events** to trigger the Webhook. Then, select **Add webhook**

* `Issues`
* `Pushes`
* `Merge Requests`
* `Releases`

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-034f909405d8812d7d9221f9ec2edfd0b20b0dfa%2Fgitlab_4.png?alt=media\&token=69ef4221-417f-433a-80c9-f9bdff6498a2)

{% hint style="info" %}
**Note:**

This integration supports the below GitLab events:

* `Issues` (Supports auto-resolution)
* `Pushes`
* `Merge Requests` (Supports auto-resolution)
* `Releases`
  {% endhint %}

That is it, you are good to go!

Everytime an Issue, Push, Merge Request or a Release event occurs in GitLab, an incident would be created for it in Squadcast. When an Issue or a Merge Request is closed/merged in GitLab, the corresponding incident in Squadcast will be **automatically resolved**. For Pushes and Releases, the associated incidents must be manually resolved in Squadcast.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*