Health Center: Monitor and Resolve Data and Integration Issues
Identify and fix issues that affect data accuracy, integrations, and analytics. Use the Health Center to detect problems across Git, project management tools, AI integrations, and user mapping, and follow guided actions to restore full data coverage.
Overview
The Health Center helps LinearB admins identify and resolve issues that may affect data accuracy, integration health, and analytics coverage.
Health Center notifications appear when LinearB detects issues with connected integrations, webhook coverage, rate limits, AI tool configuration, or user-account mapping. Use these notifications to resolve problems before they affect dashboards, metrics, workflow automations, and team-level reporting.
Accessing the Health Center
- In LinearB, open the main dashboard.
- Click the Issues banner at the top of the page.
- Review the Health Center panel.
- Select the action shown on the notification, such as Fix it now, Go to Settings, or View provider docs.
The Health Center panel lists active issues and recommended actions. Notifications are removed automatically after the underlying issue is resolved.
Notification Domains
Health Center notifications are grouped by the area they affect:
- Git — Git integrations, webhooks, pending GitHub App approvals, and Git provider rate limits.
- Project Management — Project management integrations, such as self-hosted Jira rate limits.
- Metrics — AI Analytics setup opportunities and missing AI tool integrations.
- Users — AI tool accounts that are not merged with LinearB team members.
Severity Levels
High — Critical issue. Data collection is broken or significantly affected. Resolve immediately.
Medium — Degraded state. Data may be delayed, incomplete, or partially unavailable. Review and resolve soon.
Info — Optional improvement or configuration recommendation. Complete the action to improve analytics coverage.
Git Notifications
Git Integration Failing
This notification appears when a Git integration, such as GitHub, GitLab, Bitbucket, or Azure DevOps, enters a failing state.
- Severity: High
- Impact: LinearB cannot sync new pull requests, commits, branches, or related Git activity from the affected integration.
- Common causes: Expired tokens, revoked permissions, disconnected integrations, or provider connectivity issues.
- How to fix: Follow the provider-specific remediation steps shown in the notification. This may include re-authorizing the integration, updating tokens, or checking permissions.
Git Rate Limit
This notification appears when LinearB detects repeated Git provider rate limit errors from an otherwise functioning Git integration.
- Severity: Medium
- Impact: Git data may sync more slowly, and some metrics may temporarily lag behind recent activity.
- How to fix: Review your Git provider API limits. Where available, configure multi-token authentication to distribute API requests across multiple tokens.
Pending GitHub App Installation
This notification appears when a GitHub App integration was requested but is still waiting for approval from a GitHub organization admin.
- Severity: Medium
- Impact: LinearB cannot collect data from the integration until the GitHub App installation is approved.
- How to fix: Ask a GitHub organization admin to approve the pending installation in GitHub organization settings. If the integration is no longer needed, remove it from LinearB settings.
Realtime Webhooks Status
This notification appears when webhook coverage drops below the required level for repositories in a Git integration.
- Not Active: High severity. Less than 40% of repositories have working webhooks.
- Partially Active: Medium severity. Between 40% and 90% of repositories have working webhooks.
- Healthy: No notification. More than 90% of repositories have working webhooks.
Missing webhooks can delay real-time notifications, workflow automations, and live metrics. Data may still sync periodically, but not in real time.
To resolve the issue, click Fix it now in the notification, or configure an organization-level webhook in your Git provider.
Project Management Notifications
Jira Rate Limit
This notification applies only to self-hosted Jira instances. It does not apply to Jira Cloud.
- Severity: Medium
- Impact: Issue data may sync more slowly, and project metrics may temporarily be out of date.
- How to fix: Review your self-hosted Jira rate limit configuration. Consider increasing limits or adjusting the Jira server configuration.
Metrics Notifications
AI Analytics Integration
This informational notification appears when LinearB detects usage of an AI development tool that is not yet connected through its API.
- Type: Info
- Supported tools: Cursor, GitHub Copilot, and Claude Code
- Impact: AI Analytics may show limited data until the relevant AI tool API is connected.
- How to fix: Click Connect API in the notification and complete the relevant AI tool integration setup.
User Notifications
AI Tool Contributors Not in Teams
This informational notification appears when LinearB detects AI tool contributors that are not merged with existing LinearB team members.
- Type: Info
- Supported tools: Cursor, GitHub Copilot, and Claude Code
- Impact: AI tool activity from these contributors may be missing from team-level dashboards and reports.
- How to fix: Click Go to Settings and merge the AI tool accounts with the correct LinearB team members.
How Notifications Are Resolved
Health Center notifications are resolved automatically after the underlying issue is fixed.
For example, re-authorizing a failing Git integration removes the related alert, and merging AI tool accounts with team members removes the related informational notification.
FAQ
How often are Health Center checks run?
Health Center notifications are computed when the Health Center panel is loaded. They reflect the current state of your integrations and configuration.
Can I dismiss a notification?
Notifications are not dismissed manually. They are removed automatically when the underlying issue is resolved.
Why do I see a Realtime: Not Active alert?
This means less than 40% of repositories in the affected integration have functioning webhooks. Click Fix it now to trigger automatic webhook setup, or configure an organization-level webhook in your Git provider.
Does the Jira rate limit notification apply to Jira Cloud?
No. The Jira rate limit notification applies only to self-hosted Jira instances.
Which AI tools does LinearB monitor for Health Center notifications?
Health Center may detect usage or account-mapping gaps for Cursor, GitHub Copilot, and Claude Code.
Related Articles
How did we do?
How Does LinearB Classify Branches As Outliers
