GitLab Integration - On Prem

Enable Pull Request Metrics

Connecting your GitLab to TargetBoard enables access to all your PR metrics including Cycle Time, Time in Status, tracking of New, Open and Closed Pull Requests and many others.

To integrate GitLab with TargetBoard, you'll need to generate a Personal Access Token with the appropriate scope to allow read access to your organization's projects and APIs and have Admin permissions in your TargetBoard account. You will also need to whitelist TargetBoard's IP addresses.

1. Login to GitLab.
2. Click your avatar in the sidebar and select Edit Profile.
3. In the left sidebar, click through Access Tokens > Add New Token and fill in the fields as follows:
   1. Token Name: TargetBoard
   2. Token Description: (optional)
   3. Expiration Date: 365 days
4. Select read_api as the required scope (this scope grants access to API, all groups and projects, container registry and package registry).
5. Click Create Personal Access Token
6. Copy and store the token securely (it won't be shown again).
7. Login to your TargetBoard account and click Settings towards the bottom of the left side menu.
8. Click Manage source integrations and find GitLab in your integrations list. Click > on the right of the tab.
   1. If you do not see GitLab in your integrations list, reach out to your Customer Success Manager.
9. Enter your token and GitLab URL (e.g. gitlab.mycompany.com) and click Connect.