Connect your GitLab projects to Datagrid to gain insights from your software development lifecycle. This connector pulls data from GitLab, turning it into datasets within Datagrid for analysis and reporting.
1. How-to
1. Prerequisites
To configure the GitLab connector, follow these steps:
- An active GitLab account with the necessary permissions to access the projects and data you want to import into Datagrid.
- A GitLab API key (Personal Access Token). You can generate this from your GitLab account settings.
- Select the data you want to import into Datagrid.
2. Connect
Creating a dataset from the GitLab connector involves selecting the specific data you want to import via GitLab:
- Connect GitLab App: a. Click on the "+ Create” Button, located on the top left of the screen. b. Select the "Connect Apps" item. c. Search for the GitLab connector from the list. d. Login with your GitLab account. GitLab may prompt you to authorize Datagrid's access to your GitLab data. Grant the necessary permissions to proceed. e. Click on the “Next” button.
- Pick your Data: a. Pick the GitLab data you want to include in your dataset (e.g., Issues, Merge Requests, Pipelines). b. Click on “Start First Import” Button to start syncing your GitLab dataset.
3. Set Up a Schedule
Scheduling regular data pulls ensures your Datagrid datasets remain up-to-date with the latest information from GitLab:
- Navigate to GitLab Dataset: a. Go to the left side panel and locate and click on your GitLab dataset you created.
- Schedule Settings: a. Click on the “…” on the top right of you the dataset. b. Click on “Edit Pipeline” to edit your connectors name. c. Click on the “Schedule” button located on the right, beside the “Import Configuration” button.
- Configure Schedule: a. Set the desired frequency for data pulls (e.g., daily, weekly, monthly). b. Specify the time of day for the data pull to occur. c. Specify downtime if needed – when the sync should not happen. d. Click on the “Update” button to update the new configuration.
2. Data Access
- Issues
- Merge Requests
- Pipelines
- Users
- Projects
- Groups
3. Use Cases
- Track Project Progress: Monitor the status of issues and merge requests to understand project velocity and identify bottlenecks.
- Analyze Code Quality: Track code review metrics and identify areas for improvement in your development process.
- Monitor CI/CD Pipelines: Visualize pipeline success rates and durations to optimize your deployment process.
- Gain Insights into Team Performance: Analyze individual and team contributions to identify top performers and areas where additional support may be needed.
- Risk Mitigation: Identify potential risks by monitoring the number of open issues and vulnerabilities.
4. FAQ
Q: What permissions does Datagrid require to access my GitLab data? A: Datagrid requires read-only access to the specific projects or groups you want to import data from. You can control the level of access granted when authorizing the connection.
Q: How often can I schedule data pulls? A: You can schedule data pulls on a daily, weekly, or monthly basis. You can also specify the time of day for the data pull to occur.
Q: I'm encountering an error when connecting to GitLab. What should I do? A: Double-check your GitLab API key and ensure that it has the necessary permissions. If the issue persists, contact support@datagrid.ai for assistance.
5. Support & Additional Resources
- Datagrid Support: support@datagrid.ai
- Datagrid Website: https://www.datagrid.ai
- GitLab Website: https://about.gitlab.com/
- GitLab API Documentation: https://docs.gitlab.com/ee/api/rest/
- Request an endpoint here: Don't see endpoints you're looking for? We're always happy to make new endpoints available.