Monitoring GitLab Usage With OpenLM

This document describes the steps required to monitor GitLab usage and obtain license statistics.

Requirements

To query the GitLab license manager the following requirements must be met:

1. Broker v22.2 or higher installed in any machine in the same LAN with GitLab
2. OpenLM Server v21.12 or higher
3. TCP/IP communication
4. Configured GitLab
5. GitLab Account

Monitoring capabilities and features

The current monitoring capabilities available for GitLab through the OpenLM Broker are as follows:

OpenLM Broker configuration

Diagram of how OpenLM interfaces with the GitLab

Please note that OpenLM Broker must already be installed and configured to report to OpenLM Server before proceeding further.

Manual OpenLM Broker configuration

If auto-detect did not work, you can also add and configure the license manager manually. To do so:

1. Click Add Port.
2. Enter the GitLab port number – 80
3. Select GitLab from the “License Manager Type” drop-down menu. Click Apply.
4. Select Data Inquiry in the Commands node and type in the GitLab URL for users in the data inquiry field (Ex: http://FQDN:80/api/v4/users).
5. Go to C:Program FilesOpenLMOpenLM Broker and open the gitlab@80.properties file. Provide the login information and save the changes.
   
6. Go back to the Broker Click Execute then Apply. Make sure you get license output.
7. Select “Vendor Name to Be Filled” under Vendors. Enter GitLab in the “Vendor Name”. field then click Apply.
8. Click Apply.
9. Click Restart Broker.

How to verify your GitLab configuration

To check if the GitLab License Server is being monitored correctly:

1. Open the EasyAdmin web application in your browser.
2. Click EasyAdmin Start → Widgets → License Servers.
3. Double click on it to approve the GitLab license manager in License Server Panel from the Pending Approval link.

Please note that sometimes it may take up to 3 minutes for the status indicator to change if this is a new connection.