GitLab Integration
Connect GitLab to enable the AI agent to access code, merge requests, and CI/CD pipeline information during investigations.
Capabilities
Once connected, the AI agent can:
| Capability | Description |
|---|---|
| Browse Code | View repository files |
| Merge Requests | Review MRs and changes |
| Pipelines | Check CI/CD pipeline status |
| Commits | View commit history |
| Issues | Access issue tracking |
Prerequisites
- A GitLab account (Cloud or self-hosted)
- A Personal Access Token
- Read access to relevant projects
Setup
1
Create a Personal Access Token
- Go to GitLab User Settings → Access Tokens
- Enter a token name (e.g., "Autoheal Integration")
- Set an expiration date
- Select scopes:
read_api,read_repository - Create and copy the token
2
Add Integration in Autoheal
- Go to Integrations in Autoheal
- Click GitLab
- Enter a name (e.g., "Production GitLab")
3
Configure Credentials
Enter the following:
- Token: Your GitLab Personal Access Token
- URL: GitLab URL (default:
https://gitlab.com)
4
Test and Save
Click Test Connection to verify, then Save.
Required Scopes
| Scope | Why It's Needed |
|---|---|
read_api | Access GitLab API endpoints |
read_repository | View repository contents |
Self-Hosted GitLab
For self-hosted GitLab instances:
https://gitlab.your-company.com
Ensure the URL is accessible from Autoheal.
Example Queries
What pipelines failed in the last 24 hours?
Show me the latest merge requests for the backend project
What commits were deployed yesterday?
Troubleshooting
401 Unauthorized
- Verify the token is correct and not expired
- Check that required scopes are granted
Connection Failed (Self-Hosted)
- Verify the GitLab URL is correct
- Check network/firewall accessibility