> ## Documentation Index
> Fetch the complete documentation index at: https://checkly-422f444a-mda-troubleshooting-section.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrating GitLab Alerts

> Configure GitLab Alerts integration to receive failure, degradation, and recovery messages from Checkly

Checkly integrates with [GitLab Alerts](https://docs.gitlab.com/ee/operations/incident_management/alerts.html) and can
deliver failure, degradation, and recovery messages to any project in your GitLab installation. More specifically, Checkly will:

* Open new alerts when a check fails.
* Close alerts automatically when a failing check recovers.
* Alert when SSL certificates are about to expire.

1. First, create an **Incoming Webhook**. Log in to GitLab and go to "Settings" > "Operations" and expand the "Alerts" tab
   and select the **HTTP Endpoint** integration type

   <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/Do8jzM0ERL-vkD0f/images/docs/images/integrations/gitlab/gitlab_step1.png?fit=max&auto=format&n=Do8jzM0ERL-vkD0f&q=85&s=d2947dce1352c56e6e3b1b52372d4e82" alt="setup checkly gitlab_integration step 1" width="1109" height="829" data-path="images/docs/images/integrations/gitlab/gitlab_step1.png" />

2. **Choose a name** for your integration like "Checkly".

   <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/Do8jzM0ERL-vkD0f/images/docs/images/integrations/gitlab/gitlab_step2.png?fit=max&auto=format&n=Do8jzM0ERL-vkD0f&q=85&s=1afebf7ec763dcac720e0723c2e07ab0" alt="setup checkly gitlab integration step 2" width="1109" height="829" data-path="images/docs/images/integrations/gitlab/gitlab_step2.png" />

3. Save the integration **copy the displayed Webhook URL and Authorization Key**. It should start with something like `https://gitlab.com/...`

   <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/Do8jzM0ERL-vkD0f/images/docs/images/integrations/gitlab/gitlab_step3.png?fit=max&auto=format&n=Do8jzM0ERL-vkD0f&q=85&s=8a114be5cb077f79d15089addfc14bc2" alt="setup checkly gitlab integration step 3" width="1109" height="829" data-path="images/docs/images/integrations/gitlab/gitlab_step3.png" />

4. Log in to Checkly and navigate to [Alert Settings](https://app.checklyhq.com/alert-settings/).
   Click the "Add more channels" button, find GitLab Alerts on the list, and click "Add channel".

   <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/Do8jzM0ERL-vkD0f/images/docs/images/integrations/gitlab/gitlab_step4.png?fit=max&auto=format&n=Do8jzM0ERL-vkD0f&q=85&s=f6245554b1dacd4af323a9252e7899a2" alt="setup checkly gitlab_integration step 5" width="1085" height="728" data-path="images/docs/images/integrations/gitlab/gitlab_step4.png" />

5. Give the alert channel a name and **paste the Webhook URL and Authorization Key** in their respective input fields. You can now also tweak
   which alerts you want to be notified of and which checks or check groups should be subscribed to this channel.

   <img src="https://mintcdn.com/checkly-422f444a-mda-troubleshooting-section/Do8jzM0ERL-vkD0f/images/docs/images/integrations/gitlab/gitlab_step5.png?fit=max&auto=format&n=Do8jzM0ERL-vkD0f&q=85&s=e67bd282fab8310ce288d3154f39421d" alt="setup checkly gitlab integration step 5" width="1035" height="700" data-path="images/docs/images/integrations/gitlab/gitlab_step5.png" />

   > Note that we provide a preconfigured message payload but you are free to edit the payload and add more or different
   > variables. Just click the "Edit payload" button and reference the "Help & variables tab".

Congratulations! You have successfully integrated Checkly with GitLab Alerts!
