- Send notification-free events from GitLab to PagerDuty services regarding merge request events, to provide context for anyone using PagerDuty.
- Responders may review change events within a PagerDuty service’s Recent Activity timelines during incident triage or hypercare. They can also see recent changes on incidents of that service, and navigate across all changes in a comprehensive list of Recent Changes across all services.
- When a
merge_requestevent occurs within a GitLab repository, a webhook will be sent to the endpoint of the integrated PagerDuty service.
- These events will be viewable as change events in the service’s Recent Activity timeline, on incidents associated with that service, and in a global list of all changes. They will not generate alerts, incidents or notifications.
In PagerDuty: This integration requires a Manager base role or higher to configure.
In GitLab: This integration requires a Maintainer, Admin or Owner role to configure.
We recommend mapping your GitLab events to the PagerDuty service that represents what you are changing. This will make it easy for responders to quickly identify recent changes on their service when they get notified for an incident.
- In your PagerDuty account, navigate to Services Service Directory and click the name of your preferred service. Select the Integrations tab and click Add a new integration.
- Enter an Integration Name in the format
Service-Name-GitLaband select GitLab from the Integration Type dropdown. Click Add Integration.
- On the next screen in the Integrations list, click the Name of your GitLab integration to view the details screen.
Note: On this screen you will see that the default branch to track will be set to
main,master, if you would like to change the branch, you may optionally click Edit Integration on the right and enter the name of your preferred branch in the branch field. If you would like to add multiple branches, add each with a space separation. Click Save Changes
- Next, copy the Integration URL which will be in the following format:
Keep this URL in a safe place for later use.
- Navigate to the GitLab project where you would like to track changes, select the Settings menu on the left, and then select Webhooks.
- Paste the Integration URL generated in PagerDuty (above) in the URL field. Under the Trigger header, deselect Push events and select Merge request events. Click Add Webhook.
- Once added, you will see the webhook appear below these settings. To test the integration, create a
merge_requestin the integrated project. In your PagerDuty account, navigate to the integrated service, click its title and you should see a change event labeled as RECENT CHANGE in grey in the Recent Activity timeline:
Please read our Change Events article for more information on how to send change events and view them within individual services, incidents and across all services in the Service Directory.
Not at this time, but we are interested to learn about what you would like to accomplish, please contact our Support team with your use cases and feedback.
Yes, you can add any number of integrations to a single service, including multiple GitLab integrations. Once you have added an integration for a new branch to your PagerDuty service, click Edit Integration to add the correct branch name and click Save Changes.
Not at this time, but we would like to hear your feedback, please contact our Support team.
Updated 4 months ago