GitLab (Cloud)

By connecting Socratic with GitLab Cloud, you can see code metrics for people, teams, and for your organization as a whole. These metrics are surfaced on Trends.

Set up

1. Connect Socratic

Connecting to GitLab

To activate for your org:

1. Click the Socratic icon at top left, and choose Integrations.

2. Click on GitLab.

You’ll need to create an OAuth app in GitLab. This OAuth app yields the client ID and client secret that are required as inputs for integration. Steps are as follows:

1. In GitLab, navigate to the landing page for the group containing the repositories you wish to integrate with Socratic.
2. In the contextual menu for your group, navigate to Settings -> Applications. If you don't see these items, you may not have sufficient permissions.

3. To create the app:

   1. Enter a Name of your choice.

   2. Enter our redirect URL: https://api.socraticworks.com/integration/gitlab/install

   3. Select Confidential.

   4. Select a Scope level of api

4. Once successfully created, you should see some of the information you previously provided, as well as an Application ID and Secret.

2. Map GitLab IDs to their corresponding contributor

Mapping GitLab IDs to contributors

To see code metrics for people and teams, you need to first map GitLab IDs to their corresponding contributor name in Socratic. (Contributors are those people whose Jira work activity Socratic instruments. Contributors are automatically discovered by Socratic.)

1. Click Add users in the lower-left of the app.

2. Click the Contributors tab at the top of the page.

3. Click the Map GitLab users button at the top-right of the page.

Socratic will show all the GitLab IDs discovered in connecting to your GitLab account. We will also "suggest" a mapping between GitLab IDs and contributor names. Accept or change the suggested mapping for each contributor. Then again click the Map GitLab users button to confirm all pairings.

How to see and use code metrics

See code metrics for people, teams, and your organization as a whole in Trends

Socratic surfaces code metrics on Trends. You can see these metrics for:

• A person: click Capacity in the left-hand navigation, then click any name. For each person with a mapped GitLab ID we surface: merge time, review time, merged pull requests, and pull requests reviewed.
• A team: click Teams in the left-hand navigation, and choose any team. For teams we surface: merge time, review time, and merged pull requests.
• Your organization: click Trends in the left-hand navigation. For your organization as a whole we surface: merge time, review time, and merged pull requests.

As with all Trends data, we show the relevant code metric for the selected time period, and as trended against the average for the prior five equivalent periods. For each code metric, you can click to see the pull requests and repositories involved for the period in question:

See repo details for every code metric