Gitlab
Use Gitlab as a datasource for your Tabilty key results
You can connect Tability to Gitlab to automatically pull metrics from Gitlab for your check-ins without having to switch context.
Once you add Gitlab as a data source for an outcome/Key Result, Tability can:
Automatically pull the most recent value of the metric when you open the check-in form.
Perform automatic sync while the plan is active (Premium subscription only).
How to enable the integration
Step 1. Upgrade to the Plus or Premium subscription
You'll need to have a Plus subscription to use Gitlab as a data source.
You'll need to have a Premium subscription to enable the auto-sync.
Step 2. Connect Tability to your Gitlab account
Go to the Integrations admin screen, and look for the Gitlab integration in the "Data connectors" section.
![](https://guides.tability.app/~gitbook/image?url=https%3A%2F%2Fd33v4339jhl8k0.cloudfront.net%2Fdocs%2Fassets%2F60b049fe9c887a0dfc554454%2Fimages%2F64e6e87b6ca77422d09645d5%2Ffile-wkZm6xlhCR.png&width=768&dpr=4&quality=100&sign=f19b98ff&sv=1)
Click on "Connect to Gitlab" and complete the steps to connect Tability to your Gitlab account.
![](https://guides.tability.app/~gitbook/image?url=https%3A%2F%2Fd33v4339jhl8k0.cloudfront.net%2Fdocs%2Fassets%2F60b049fe9c887a0dfc554454%2Fimages%2F64e6e98db0995a53905396cc%2Ffile-9z3EsN8idS.png&width=768&dpr=4&quality=100&sign=f9401902&sv=1)
How to add a data source to an outcome of Key Result
Once Gitlab is connected, you will be able to use it as a data source for your outcomes/KRs.
Step 1. Open up your edit panel of your outcome/KR
![](https://guides.tability.app/~gitbook/image?url=https%3A%2F%2Fd33v4339jhl8k0.cloudfront.net%2Fdocs%2Fassets%2F60b049fe9c887a0dfc554454%2Fimages%2F6466508cc6234261f380e3e6%2Ffile-bZLSr0JQOb.png&width=768&dpr=4&quality=100&sign=f75003dd&sv=1)
Click on "Edit" to open up the Edit panel of any outcome/KR in your workspace.
Step 2. Select Gitlab as a data source
Go to the "Data source" tab and select Gitlab.
Step 3. Pick the metric that you would like to connect
![](https://guides.tability.app/~gitbook/image?url=https%3A%2F%2Fd33v4339jhl8k0.cloudfront.net%2Fdocs%2Fassets%2F60b049fe9c887a0dfc554454%2Fimages%2F64e6ea1e42e1f64bf8026466%2Ffile-ecCXOSjX9g.png&width=768&dpr=4&quality=100&sign=50019723&sv=1)
Use the dropdown to select the metric that you want to connect to your outcome/KR.
Step 4. Select your Gitlab project
Use the dropdown to select the organisation and repo that you want to connect to.
Step 5. Save your connection
Click on "Save & preview" to complete the connection.
Tability will retrieve the current value for that metric and your screen should look like this 👇
You can now toggle the option to Enable auto-sync of your metric if you're on a Premium subscription.
Tability will retrieve the value of your metric from Gitlab every 48h and will create a check-in on behalf of the owner of the outcome/KR.
The first data sync should happen within 1h of enabling this option.
How to use the data source in your check-ins
It's all automatic! Once an outcome/KR is connected to a data source, Tability will automatically pull the current value whenever you open up the check-in modal.
Last updated