Skip to main content

​
Why Connect GitHub?

Without GitHub integration, Metoro can only analyze runtime data (logs, traces, metrics, k8s resources, profiling). With GitHub connected, Metoro gains the ability to:

Code Analysis

Examine actual source code to understand implementation details and identify bugs

Change Correlation

Correlate issues with recent deployments and code changes

Fix Suggestions

Provide specific code fixes and implementation recommendations

Documentation Context

Reference your code comments, READMEs, and documentation during investigations

​
Setting Up GitHub Integration

If you are onboarding AI SRE for the first time, you can connect GitHub directly from the onboarding flow or you can connect it later from the Settings → Integrations page in Metoro.
1

Open the AI SRE onboarding flow

Open the AI SRE onboarding flow in Metoro and continue to the GitHub step.
2

Connect GitHub

In the onboarding flow, click Connect GitHub Account.
  • If you are already connected, you can skip this step
3

Authorize in GitHub

You’ll be redirected to GitHub to authorize the Metoro app:
  1. Select your organization or personal account
  2. Choose repository access:
    • All repositories - Recommended for full coverage
    • Selected repositories - Choose specific repos to grant access
  3. Review requested permissions
  4. Click Install & Authorize After authorization, you’ll be redirected back to Metoro with GitHub successfully connected.
4

Link Repositories

After GitHub is connected, you need to map your services to their corresponding GitHub repositories. This can be done in the Link Repositories step in the onboarding flow or later in the Service Catalog -> Select your service -> Link Source Code button at the top right of the page Service Dashboard page.
Required Permissions: The Metoro GitHub App requiresRead access to:
  • Repository contents (code, branches, commits)
  • Repository metadata
Write access to:
  • Pull requests
  • Issues
Metoro can raise pull requests to fix detected issues, but it will never merge them automatically. You must review and merge any PRs yourself.

​
Step 2: Verify Connection

After installation, verify the connection:
  1. Return to Settings → Integrations → GitHub
  2. You should see:
    • ✅ GitHub Connected

​
Repository Mapping

Repository mapping links your Metoro services to their corresponding GitHub repositories, enabling Metoro to analyze the right code for each service.

​
Understanding Service-to-Repository Mapping

Each service in your system needs to be mapped to its source code repository:
  • One-to-One: Single service maps to single repository (most common)
  • Monorepo: Multiple services map to same repository with different paths

​
Step 1: Access Repository Mapping

  1. Navigate to AI SRE → Onboarding → Link Repositories
  2. You’ll see a list of all detected services in your system with the option to map each service to a repository.

​
Step 2: Map Services to Repositories

For each service, configure its repository mapping:
Standard Repository MappingFor services with dedicated repositories:
  1. Find your service in the list (e.g., payment-service)
  2. Click Map Repository
  3. Select the repository from dropdown (e.g., org/payment-service)
  4. Leave Repository Path empty (uses root)
  5. Click Save Mapping
Example:
  • Service: payment-service
  • Repository: metoro-org/payment-service
  • Path: / (root)

​
Advanced Configuration

​
Branch Selection

Configure which branch Metoro should analyze:
Metoro uses the repository’s default branch (usually main or master)No configuration needed - this is the default behavior

​
Validation Checklist

Run through this checklist to ensure proper setup:
  • GitHub App installed and authorized
  • Repositories accessible in Metoro
  • All production services mapped to repositories
  • Monorepo paths correctly configured
  • Mappings validated successfully
  • Test investigation completed successfully

​
FAQ

Metoro can create PRs but it won’t merge them automatically. You must review and merge any PRs yourself.
Update the repository mappings when you restructure code. Metoro will use the new paths immediately.
The GitHub App authorization grants access to selected private repositories. Metoro respects all GitHub permissions.

​
Next Steps

AI SRE Overview

Learn how AI SRE fits into Metoro’s broader platform

Configure Notifications

Set up investigation notifications

AWS Bedrock Setup

Use your own AI credentials