| icon | description |
|---|---|
gitlab |
GitLab is a complete DevSecOps platform that streamlines collaboration and simplifies CI/CD, enabling teams to plan, develop, and deploy software in a single application |
GitLab is a complete DevSecOps platform that enables teams to collaborate on planning, development, CI/CD, and deployment in a single application. Display your GitLab deployment pipelines in the ilert and enrich alerts context. This integration helps you better understand the context of incidents and improves your MTTR.
In any way, a pipeline is required, which will also generate a new integrationKey required to route deployment events when they occur. Head to your ilert account and navigate to Alert sources -> Deployment events.
Head over to the deployment pipelines tab and click on Create new pipeline.
Provide a name for your pipeline.
Optional: If you are going to manage branch-specific deployments, choose the branches in the branch filter section for which you would like to create deployment events in ilert.
Optional: If you would like to use a global webhook flow, where you coordinate specific deployment events for different repositories across multiple pipelines, you can use the event filters to fine-tune which specific event types should create deployment events in ilert and drop other ones. (This is mainly useful when using multiple GitLab account-wide webhooks).
{% hint style="info" %} We generally recommend Release-based deployment events, as these are the easiest to set up and provide the most foundated correlations. Note that Push-based deployment events can become very spammy, especially when used with Github account-wide webhooks. {% endhint %}
In any way, by clicking on Create, you should end up on the detail view of your GitLab deployment pipeline.
Providing you with a freshly generated integrationKey and copy & pastable URL ready for your webhook setup.
Head to your (or your organization's) GitLab groups settings page Home -> Groups -> Settings (left sidebar) -> Webhooks -> Add webhook.
Create a new webhook by pasting the URL from your freshly created ilert deployment pipeline into the URL field.
Scroll down the list and choose whichever suits your setup of Push events, Merge request events and Releases events (you can also mark all and use the ilert event filter in your pipeline to switch faster in the future).
When you are done, click "Add webhook" for your webhook to be created. You are now all set and should see deployment events coming into your ilert account.