Skip to main content

Configuring Auto-Monitoring for Git Repositories

If your organization uses GitHub or GitLab as your code host, LinearB's Auto-Monitoring feature allows you to automatically track new repositories as they are created.

Steven Silverstone
Updated by Steven Silverstone
This feature requires admin permissions in LinearB.

Repository Auto-Monitoring automatically tracks newly created or discovered repositories connected to your Git provider, ensuring they are added to LinearB without manual setup. This helps keep metrics complete as your organization grows.

LinearB supports auto-monitoring for GitHub, GitLab, Bitbucket Cloud, and Azure DevOps (ADO), across private, public, and internal repositories.

Auto-Monitoring for Bitbucket Cloud and Azure DevOps is currently available under feature flags (FFs).

For initial Git setup, see Connecting Your GitHub Account to LinearB .


Supported Auto-Monitoring Scenarios

Repository auto-monitoring is supported for the following Git providers and deployment models:

Git Provider Deployment Type Auto-Monitoring Supported
GitHub Cloud ✅ Yes
GitLab Cloud / Self-Managed ✅ Yes
Bitbucket Cloud ✅ Yes
Bitbucket Server (non-OPA) ❌ No
Azure DevOps Cloud ✅ Yes
Note: Auto-monitoring is not supported for Bitbucket Server (non-OPA). In these environments, repositories must be added manually.

Summary
  • Automatically include new repositories as they are created or discovered.
  • Use regex-based rules to control inclusion and exclusion.
  • Supports private, public, and internal repositories.
  • Requires sufficient Git token permissions to detect repositories.

Before you begin
  • You must be a Company Admin in LinearB.
  • Your Git integration token must have access to the repositories you want to monitor.
  • Auto-Monitoring for Bitbucket Cloud and ADO requires feature flags.
  • If auto-monitoring is not supported for your provider or deployment type (for example, Bitbucket Server (non-OPA)), the Monitoring Rules option will not appear in the UI.

Configure repository auto-monitoring
  1. Access Monitoring Rules
    1. Go to Settings → Company Settings.
    2. Open the Git tab.
    3. Click the three-dot menu next to Add Repositories.
    4. Select Monitoring Rules.
    UI Availability: If you do not see Monitoring Rules, auto-monitoring may not be supported for your Git provider or deployment type (for example, Bitbucket Server (non-OPA)).
  1. Define monitoring rules
    1. Enter a regex pattern to include repositories.
      • To include all repositories, use .*.
    2. Optionally add exclusion rules (for example, documentation repositories).
  2. Verify token access
    • Ensure your Git token can access the repositories being monitored. Repositories without permission will not be detected.
  3. Select repository visibility

    Choose which repository types to monitor: private, internal, and/or public.

  4. Configure organizational scope (GitHub only)

    Define which organizations are included using regex or manual selection.

  5. Define inclusion and exclusion rules
    • Include repositories using a regex in the Include field.
    • Exclude repositories using a regex in the Exclude field.
    • Example:
      • ^test* excludes repositories starting with test.
  6. Select organizations
    1. Use regex (for example, .* for all orgs, ^linear- for orgs starting with “linear-”).
    2. Or manually select organizations from the list.
  7. Enable Auto-Monitoring

    Ensure the Auto monitored toggle is enabled.

  8. Click Save to apply your configuration.

Important notes
  • UI availability: If auto-monitoring is not supported for your Git provider or deployment type, the Monitoring Rules option will not appear in the integration menu. This behavior is expected and does not indicate a misconfiguration.
  • New repository sync: Allow up to 24 hours for newly added repositories to appear.
  • New organizations: GitHub organizations added later must be manually selected in monitoring rules.
  • Regex precision: Carefully define exclusion rules to avoid monitoring unintended repositories.

Next steps

After enabling repository auto-monitoring, connect your project management tool to complete your setup: Connect LinearB to your PM tool .

Auto-monitoring reduces manual overhead, keeps metrics accurate, and ensures new repositories are tracked as your organization evolves.

How did we do?

Git Activity: Metrics & Filters Glossary

Contact