GitLab is often used by engineering and product teams to build software and contains a lot of collaborative aspects of the workflows within these teams across GitLab projects. This guide shows you how to configure the events most relevant to your company's collaborative workflow analytics.
In this article, we will show how to enable the integration between Gitlab projects and the relevant events you want to track across Flowtrace.
The documentation will cover the following:
Enabling Flowtrace application on your GitLab account
Subscribing Flowtrace webhook for your GitLab projects
To complete this integration, you need the following:
The owner or a maintainer role access to your GitLab project(s)
Administrator access to Flowtrace
1. Installing the Gitlab app
Creating a Gitlab integration using the Flowtrace app is easy. First, log in to your Flowtrace account and navigate to Settings -> Integrations. Here you will see the Gitlab integration option if this is part of your Flowtrace plan. Click on Configure, then Install.
To install the Flowtrace app, you must go to Gitlab for authorization.
You should accept the request to install Flowtrace into your Gitlab account for the integration. (You should log in to your GitLab account first).
Authorize the following prompt.
You will then be prompted the list of all the projects you own and that you're a maintainer.
For each project, you want to integrate with Flowtrace (i.e. track the activity), tick the checkbox next to it and click on confirm.
Your configuration will be marked as saved.
Once you are done, you can test the integration by opening an issue, creating a commit, or doing another action which triggers an event. Finally, you can go to the Flowtrace Integration page to confirm we have received the event via the "Last Active" field.
To uninstall GitLab integration, click the "Settings / Remove" button. It will bring you to your GitLab project's setting page, where you can remove the webhook.
NB: Flowtrace integration only supports following Gitlab events;
issues
merge requests
notes/comments
commits