TMetric Documentation

GitLab: Synchronizing Time

GitLab is a web-based service for managing Git repositories. You can integrate TMetric and GitLab to sync the recorded time and track estimate accuracy of your GitLab issues. 

Note: GitLab time synchronization is only available in the Business plan.

How to install TMetric browser extension

To get started, you need to install the TMetric extension. Just choose the browser you frequently use, click the corresponding link below and add the extension to it. 

Once the installation is complete, the TMetric icon will appear on the upper toolbar. 

How to configure time sync with GitLab

Time synchronization between TMetric and GitLab works only for your local GitLab installations.

Synchronization won't work correctly if you manage projects at gitlab.com. Since to configure the synchronization, you need admin rights, which are not available on the gitlab.com hosting platform.

To integrate GitLab with TMetric, do the following:

1. On the left-side menu, click Workspace, and then Integrations

2. Click New Integration and select GitLab

3. Enter your GitLab instance URL. 

4. Enter the API access key. To create a personal access token in GitLab, just follow the steps described in the Synchronization section.

5. Click Enable synchronization of tracked time

The recorded time will be synchronized from TMetric to GitLab immediately after you enable synchronization of tracked time. Time entries will be synchronized automatically every hour. You can also initiate synchronization manually by clicking the Synchronize Time Now button. 

How to track time in GitLab

When you install the TMetric extension, the Start timer button is integrated into each GitLab issue allowing you to start tracking time directly from GitLab. The corresponding time entry will appear on the Time page of the TMetric web app. You can quickly return to a GitLab issue page by clicking the issue ID next to its name. The time displayed on the Start timer button is the total time spent on the issue by all team members. 

The time logged in TMetric is synchronized automatically to GitLab every hour and will appear as a comment on the GitLab issue page. This will allow you to effortlessly track the estimate accuracy of tasks in GitLab. 

How to edit and delete GitLab integration

You can view and edit your GitLab integrations on the Integrations page. Here you can: 

  • Run an immediate synchronization by clicking the Sync Time Now button. In this case, the next synchronization will be exactly one hour away from the time you synchronized.
  • View log to see the results of synchronization.
  • Edit the integration settings.
  • Delete the integration. When you delete the integration, all time entries associated with this integration will be unassigned from the relevant GitLab instance.