table of contents Table of contents

GitLab Alerts

On this page

Checkly integrates with GitLab Alerts 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

    setup checkly gitlab_integration step 1

  2. Choose a name for your integration like “Checkly”.

    setup checkly gitlab integration step 2

  3. Save the integration copy the displayed Webhook URL and Authorization Key. It should start with something like

    setup checkly gitlab integration step 3

  4. Log in to Checkly and navigate to Alert Settings. Click the “Add more channels” button, find GitLab Alerts on the list, and click “Add channel”.

    setup checkly gitlab_integration step 5

  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.

    setup checkly gitlab integration step 5

    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!

Last updated on May 3, 2024. You can contribute to this documentation by editing this page on Github