Skip to main content
Code and commit data enables the Investigation Agent to identify potential causes of breaking changes, either in response to a user question (e.g. “Have there been any recent commits that could have impacted [service]?”) or automatically in response to an alert. Phoebe supports three levels of capabilities:
  1. Read PRs and commit changes - identify recent changes that may have caused the current issue
  2. Read full code repository - provides deeper context for root cause analysis
  3. Create PRs to fix issues - generates code fixes for problems found during investigations

​
GitHub

To provide read access to GitHub data, install Phoebe’s GitHub App:
1
Make sure you’re logged in to Phoebe’s web app at app.phoebe.ai. This is necessary for us to know which org to attach the repository to.
2
Navigate to the GitHub App installation page
3
Choose repositories to grant access to
4
Review requested permissions
5
Click “Install & Authorise”
6
Verify installation in GitHub Settings
Phoebe only needs read-only access.For a given alert or search investigation, Phoebe can analyse a 60-day rolling window of PRs up to your onboarding date.

​
GitLab

Required Setup There are two elements to set up for GitLab access:
  • Webhook - so that GitLab notifies Phoebe about merged MRs
  • Access Token - to allow Phoebe to retrieve code
Step 1: Configure the Group Webhook
1
Navigate to your group’s webhook settings page at https://gitlab.com/groups/**your-group**/-/hooks`, replacing your-group with your own group name.
2
Click Add new webhook.
3
In the URL field, enter: https://api.phoebe.ai/events/webhook/gitlab/
4
In the Secret Token field, enter the value provided to you via 1Password.
5
Under Triggers, select the following events:
  • Push events (all branches)
  • Project events
  • Merge request events
  • Project or group access token events
6
Click Add webhook to save.
Step 2: Create a Group Access Token Set up a group access token to ensure Phoebe can read code across the group.
1
In GitLab, navigate to your group’s Settings > Access Tokens.
2
Create a new token with the following scopes:
  • read_api
  • read_repository
3
Set the Role to Reporter.
4
Copy the generated token.
5
Go to the Phoebe Integrations page and enter the token in the access_token field.
6
Click Save. You should see confirmation that both Code_changes and Code_repository_analysis capabilities are validated successfully.
Testing the Connection After completing both steps above, return to the GitLab webhooks page and select Test > Merge request event. You should see a success popup showing HTTP 200.
Phoebe only needs read-only access to your GitLab group.
BitBucket integration is coming soon.