Skip to main content

Recover a Failing Repository

Recover repositories that have entered a Failing state. Recovery reprocesses the repository, backfills repository data, and attempts to return the repository to a Monitored state.

Steven Silverstone
Updated by Steven Silverstone

Overview

A repository may enter a Failing state when LinearB is unable to successfully process or monitor the repository.

Administrators can use the Recover action to reprocess the repository and attempt to restore the repository to a Monitored state.

Recovering a repository starts a new repository processing job and backfills repository data, similar to the workflow used when the repository is first added to LinearB.

When to Recover a Repository

  • The repository is in a Failing state.
  • The Git integration is healthy but the repository is not being monitored successfully.
  • You want LinearB to retry repository processing and backfill operations.

Recover a Failing Repository

  1. Navigate to Settings → Integrations → Repository Monitoring.
  2. Locate the repository with a Failing status.
  3. Click the Recover icon.

LinearB immediately starts a new repository processing job.

What Happens During Recovery?

When you recover a repository, LinearB reprocesses the repository and backfills repository data using the same workflow used when the repository is initially added to LinearB.

Repository Status During Recovery

When recovery begins, the repository status changes from Failing to Processing.

If processing completes successfully, the repository status changes to Monitored.

  • Failing – The repository requires attention and is not being processed successfully.
  • Processing – LinearB is reprocessing the repository and attempting to backfill repository data.
  • Monitored – The repository is being monitored successfully.

Recovery Requirements

  • The repository must still exist in the connected Git provider.
  • LinearB must have access to the repository through the configured integration.
  • The Git integration must be healthy and authorized.

Recovery Duration

Repository recovery time depends on repository size, activity, and the amount of data that must be processed.

Large repositories may take longer to complete processing and backfill operations.

Troubleshooting

Repository remains in a Failing state

If the repository returns to a Failing state after recovery, verify that the Git integration is healthy and that LinearB still has access to the repository.

If the issue persists, contact LinearB Support.

How did we do?

Integration Guide – GitHub Enterprise Server (On-Prem)

Sync GitHub Teams with LinearB

Contact