Table of Contents

LinearB Configuration Best Practices

Configure your LinearB account and ensure optimal performance

Follow these steps to fully configure your LinearB account and ensure optimal performance:

Add and Manage Repositories

  • Review and Add Repositories: Visit your LinearB account to verify that all relevant repositories for your team are being scanned.
  • Add Additional Repositories: Add more repositories through the Git settings page. For detailed instructions, refer to Add Additional Repositories to LinearB.
  • Add Git Accounts: If your team operates across multiple Git accounts, link additional accounts from the Git Settings page.
LinearB does not automatically scan new repositories as they are created. When a new repository is detected, you will receive a prompt in Alerts, located at the top of your page, allowing you to add it to your reporting.

Merge Duplicate Contributor Accounts

After adding all relevant repositories, LinearB will display a list of repository contributors in the Teams & Contributors tab. By default, contributors are identified by unique email addresses, which may result in duplicate accounts if users work from different email addresses, machines, or Git accounts.

To Merge Duplicate Accounts:

  1. Navigate to the Teams & Contributors tab in your LinearB account.
  2. Locate duplicate entries for the same user.
  3. Click the three-dot icon next to the user’s name and select the option to merge accounts.

For additional guidance, refer to How do I merge contributor accounts.

Build Your Development Teams

Create Teams in LinearB

Navigate to the Teams & Contributors tab in your account and click Add a Team.

  • Organize contributors into relevant specializations, such as frontend, backend, data, or support teams.
  • There are no limits on the number of teams, and contributors can belong to multiple teams.
  • For detailed instructions, see How do I create, edit, and delete teams.
Filter Team Member Activity

Once created, various views can be filtered to focus on specific team-member activity.

  • Metrics
  • Goals
  • Coaching
  • Team Activities
Connect PM boards to your teams

Once created, you can link a team's Jira/Shortcut board to each individual team. This allows your team to receive a custom Pulse reports on their activity linked to PM issues.

To connect a team to a PM board, go to Team Settings -> Projects. Select the appropriate board(s) for your team, and click Save.

Click here to learn about connecting PM boards.

Connect to Slack/MS Teams

Your team can receive real-time updates, either in team channels or via personal alerts about potential bottlenecks such as hanging PRs or long code reviews, or quality issues such as PRs merged without review, or PRs with a high factor of reworked code. Individual users can receive personal updates when they are assigned to review a PR, when their PR passes CI tests, or when their PR has been approved.

Connecting Slack

How do I connect and manage WorkerB Team Alerts?

How do I set up WorkerB Personal Alerts and Commands?

Connecting MS Teams

Contact support@linearb.io or your CSM to connect MS Teams. Instructions on how to connect can be found here: How to Connect WorkerB to Microsoft Teams

Set up team alerts

Once connected, teams can be notified of potential bottlenecks or code issues by enabling WorkerB alerts via their Teams or Slack settings page.

Connect Jira/Shortcut

You will need to be a Jira/Shortcut admin in order to connect with LinearB

LinearB unifies analytics from engineering and project management sources. To realize the full value of LinearB, connect your project management instance. Instructions on connecting both on-prem and cloud-based Jira and Shortcut apps can be found here: Connect your project management tools.

In the top right of the LinearB dashboard, click the settings gear, select Company Settings, click on the Projects tab, and select your project management tool.

Connect PM boards to your teams

Once created, you can link a team's Jira/Shortcut board to each individual team. This allows your team to receive a custom Pulse reports on their activity linked to PM issues.

To connect a team to a PM board, go to Team Settings -> Projects. Select the appropriate board(s) for your team, and click Save.

Click here to learn about connecting PM boards.

Configure MTTR

LinearB uses project management issues in order to determine our MTTR calculation. Once project management is connected, click on the MTTR tab next to your boards list, and customize how your team identifies bugs that need to be repaired.

Configure Your Release Detection

In order to surface accurate numbers for metrics like Deploy Time, we need to know how your team releases code to production. Go to Account Settings -> Advanced in order to set your release detection method to listen for tags (default) or PRs or merges to a dedicated branch. Learn more about configuring release detection here.

You can also configure LinearB to include and exclude specific branches and/or pull requests, even specific file extensions.

Invite users to LinearB

Invite the team of users who you would like to have access to your LinearB Metrics using instructions found here: How to invite new users

What is the difference between Users and Contributors?

Users

Contributors

Individuals who will have access to LinearB's metrics and reports.

Developers who are contributing code to your repos and whose activity you would like to include in your metrics reporting (you'll learn more about contributors below)

Your team is now observable and orchestrate-able

Congrats! Your LinearB setup is now complete. Be sure to check back frequently to track your progress.

Questions? Comments? Let’s Connect. Reach out to support@linearb.io and we’ll set up a time to talk.

How did we do?

LinearB Admins - Configuration Refinement Checklist

LinearB Deployment API

Contact