Where can I find documentation for the gitlab integration

[Brian Mbogo]

I'm trying to understand what all the options for alert filtering mean. The reason is, I'm setting up alerts based on pipelines, for which there are no pre-made alert filters so I have to use some other clever filtering and policies.

[John M]

Hi @Brian Mbogo ,

Here is the integration for GitLab:

https://support.atlassian.com/opsgenie/docs/integrate-opsgenie-with-gitlab/

One option for filtering alerts when there are no predefined filters is to use policies.

While policies cannot prevent alerts from being created they can update alert values, or automatically suppress or close alerts. 

For this method, you would first use the advanced integration options to map the custom fields to Opsgenie fields, then use a policy to filter on those Opsgenie fields.  

[Brian Mbogo]

Thanks for your reply @John M. I understand the use of policies, but I was looking for explanations of the pre-defined filters, i.e what does each one mean/which gitlab webhook trigger/object does it come from? Is there somewhere I can get this information?

[John M]

Hi @Brian Mbogo ,

The filters can come from any of the events. To see which event which fields are sent for each event, you would want to refer to the Gitlab documentation for webhooks:

https://docs.gitlab.com/ee/user/project/integrations/webhook_events.html

There are some preconfigured filters for certain events. As an example, the default "create alert for push event" action has a pre-configured filter of "issue confidential equals [blank]" which means the "issue confidential" field is sent with the "push" event.

To see all of the fields sent in the "push" event, you would refer to the gitlab section of the webhooks doc for the push event and refer to the sample payload:

https://docs.gitlab.com/ee/user/project/integrations/webhook_events.html#push-events