Jira Sizing Guide

Atlassian Advisory Services and support engineers can better tailor their configuration and environment recommendations when they know the overall size of your instance. This information also helps you estimate your instance's growth, allowing you to prepare for it.

To help you estimate your instance's size, we narrowed down which metrics were most useful in doing so. Next, we created a set of profiles (or size tiers) for those metrics, ranging from Small to XLarge. We based each metric's profiles on a wide range of  Server and Data Center customer case studies, covering instances of varying infrastructure sizes and configurations. In the future, we hope to also use these profiles in our own infrastructure and hardware recommendations.

Your instance could fall under different profiles for each metric. For example, your number of issues could be XLarge with everything else at Medium or below. We'll help you figure out the overall size of your instance!

How to collect the metrics

You can collect all but two of the metrics Jira's System Info page:

  1. Log in with the 'Jira Administratorsglobal permission.
  2. Choose System. Select Troubleshooting and Support > System Info to open the System Info page.

  3. Write down the metrics for the following:

    • Issues
    • Projects
    • Users
    • Custom Fields
    • Workflows
    • Groups 
    • Comments

You'll also need to note the following metrics, which are available from the Issues page:

  • Permission Schemes (see Managing project permissions for more details)
    1. Choose  Issues.
    2. Select Permission Schemes to open the Permission Schemes page.
    3. Count the number of Permissions Schemes displayed here.
  • Issue Security Schemes  see Configuring issue-level security for more details.
    1. Choose  Issues.
    2. Select Issue Security Schemes to open the Issue Security Schemes page.
    3. Count the number of Issue Security Schemes displayed here.

Match metrics with size profiles

Consider that following values apply only to the environment with a database running on a different machine. 

Use the following table to see which size profile your metrics fit into:

MetricSize profile
SmallMediumLarge
Issuesup to 150,000150,000 to 600,000600,000 to 2,000,000
Projectsup to 200200 to 800800 to 2,500
Usersup to 1,0001,000 to 10,00010,000 to 100,000
Custom Fieldsup to 250250 to 800800 to 1,800
Workflowsup to 8080 to 200200 to 600
Groupsup to 2,0002,000 to 10,00010,000 to 50,000
Commentsup to 250,000250,000 to 1,000,0001,000,000 to 4,000,000
Permission Schemesup to 2525 to 100100 to 400
Issue Security Schemesup to 5050 to 200200 to 800

Any metric that registers above the Large range is XLarge - for example, over 2,000,000 Issues or over 2,500 Projects.  


Custom Fields size profiles

The number of Custom Fields can greatly affect your instance's performance. Without proper governance, this number can grow beyond what your organization actually needs, unnecessarily straining your infrastructure.

The Custom Fields size profiles we created assume that an instance has the right number of Custom Fields. This means we also assume that admins took a disciplined approach to creating and managing them. For more information, see Managing custom fields in Jira effectively.

Determine your overall size profile

The overall size profile of your instance is generally dictated by the highest registered size profile of any metric you collected earlier. So if any single metric registers at Large, then we believe that it's safe to declare your instance's overall size profile as Large

From the many customer instances we studied, the size profiles we use were good indicators of an instance's overall size. Our data suggests that when your instance's overall size profile increases, the increase in load could warrant changes to the instance or its infrastructure.

How to use this information

Track these metrics to see how fast your instance's overall size grows. Find out the growth rate of each metric by comparing data snapshots over time. Then, compare these rates to each metric's size profiles to get a sense of when your instance is about to outgrow its overall size profile. Stepping up into the next content or traffic profile usually means it's time to evaluate your current infrastructure, and decide how you'll scale to meet the increased load.

Staying ahead of hardware requirements

Once you figure out how fast your instance grows, plan ahead! The following resources will help you understand the hardware needs of different instance sizes:

Handling bloat

In some cases, a single metric could be defining your overall size profile – for example, you can have a Large number of Issues, with all other metrics being Small. This bloated metric affects performance; once identified, you can find ways to manage it. For example, archiving can address a bloated number of projects and issues (see Moving or archiving individual projects) while better housekeeping can help prevent Custom Field bloat (see Managing custom fields in Jira effectively).

Keeping your instance size in check

We generally recommend you keep your instance size in check whenever possible. You should also focus on keeping the following metrics down to Medium whenever possible:

  • Custom Fields
  • Workflows
  • Permission Schemes
  • Issue Security Levels

Growing these metrics to Large and up could generate load that requires significant infrastructure changes. It's much cheaper to control their size profile; plus, we generally find that there's little reason to grow them beyond Small, even for large and complex organizations. 

Help us help you

If you need to open a ticket, share your instance's overall size profile with your Advisory Services (if you have one) or support engineer. This information can help us assist you better.

You can also go a step further by sending us analytics data about your instance. This data allows us to study the user experience across thousands of users, helping us deliver features and improvements that matter. It also helps us create average profiles (like the ones on this page) that we can use to provide better configuration and infrastructure recommendations. 

If your instance doesn't currently send analytics data to us, check out our Data Collection Policy to learn out what we collect, how it's sent to us, and how you can opt-in. 

Support team limitations

Support in general provide recommendations but again there is a limit to the amount (and depth) of assistance. There is a fine line between official best-practice and Professional Services-level Performance Tuning; which is beyond the scope of what Support can offer, something similar is mentioned in  Support Offerings page:

Support Does Not Include:
  • Professional Services
  • System & Performance tuning
  • Deployment & Capacity Planning
  • Installation & Upgrade Services

What we offer is a high-level set of available options and observations which customer can implement based on their business demands


Last modified on Jun 10, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.