Instance Insights: Install Success Rate

Mariel Wilding
Feb 16, 2023

Install success rate is the next key metric for measuring excellence in distributing customer-hosted software we’ll focus on in the Instance Insights Series. In addition to time to install, surveying the rate at which you’re able to successfully complete the installation of an instance gives you insight into the quality of the packaging of your software and how prepared you and your customers are to begin the install. 

A customer may encounter one or more failures during the process of installing an application, and if software vendors are only looking at the time to install, they could be missing the opportunity to prevent future failures. Additionally, time to install tends to only make sense when measuring successful installations. Successful users may be able to get software running in under 2 hours, but if 75% of the install attempts end in failure and the user gives up, valuable opportunities to improve your product, people, and processes are missed.

For the purposes of this examination, we’ll discuss a hypothetical Kubernetes application that end users install in their own environment, either in a shared cluster or in a purpose-built cluster designed to host only that application. We won’t make any assumptions about how the Kubernetes cluster is created, including cases when a vendor includes a Kubernetes installer as part of their application. While some of the notes are Kubernetes specific, most of these concepts should apply to any application that’s distributed into customer environments, including as a linux package, standalone binary, OVA, or other package format.

When beginning the process of surveying your install success rate, think about how many attempts it takes before an install is successful. What percentage of installs require more than one attempt? How often are installs successful on the first attempt?

Best in Class

Based on our (Replicated’s) limited anecdotal experience, best in class vendors have a 90% install success rate, averaging 1.1 installation attempts to get an instance up and running. We’re actively researching performance and working to establish more substantial data on this metric.

Define the “Install Success Rate” Metric

When defining this metric, you’ll need to become familiar with instance install statuses, and also determine what installation success means to you. What is your ideal state for your customer to be in, and how long does it take to validate that state? 

Install Statuses 

While the statuses below can be recorded manually for air gap installs, the definitions provided  apply specifically to online installs, as they are determined by instance activity and checking in.

  • Unstarted - when a customer exists with a planned install, but there is no instance activity reported
  • In progress - an instance for which an install attempt has started, but the application is not yet up and running
  • Ready state - an instance where all key application workloads are running and healthy
  • Readiness threshold - the defined period of time after an instance enters a ready state until it is deemed successful
  • Software delivering value - an instance that entered a ready state and maintained it until reaching the readiness threshold
  • Failed - an instance that reported activity, but where the application itself never reported a ready state, and this instance is now inactive and stopped reporting activity within a defined period of time
Installation timeline showing 2 failed install attempts, and one successful one.

While you may define a successful install differently, at Replicated, we define it as an instance that ends up in a ready state and stays there for at least 2 weeks. Defining success in this way ensures that successful installs don’t include instances that become ready but end up in a failed or inactive state soon after. This scenario results in additional effort to get the instance back in a ready state before it is considered as delivered and therefore should not be deemed as a success. You should experiment with different values for this readiness threshold and see how it affects the insights your data might surface.

Install success rate is a survey of the number of instances that are successful vs. failed, the other statuses are excluded as their end state is yet to be determined.

Equations for: Install success rate = number of successful installations/total number of installation attempts x 100 and attempts per install = total number of installation attempts/number of successful installations

Example: using the install timeline above as an example, 3 installs were attempted with 1 success and 2 failures. For this individual customer, the install success rate is 33%.  

If the vendor had 9 additional installs that were successful on the first attempt, the total install success rate would be 10 successful installs / 12 total attempts = 83% install success rate, or 1.2 attempts per install. 

Evaluate Current Performance

Knowing, or being able to estimate your current install success rate is important for being able to set a realistic goal. If you aren’t currently measuring install success rate, but you have a team that assists your customers with installs, they may be able to estimate, on average, how many install attempts it takes before one is successful.  While estimation and general experiences aren’t reliable data points, they’re a good place to start if you don’t have data yet.

There are several areas where it can be valuable to segment and evaluate install success rate to help identify specific areas for improvement. If you only look at the metric at a high level across all instances, it can be difficult to determine why your rate of success isn’t where you would like it to be. We’ll go into more depth on segmenting data in a future post, but we’ll use the example of online vs. air gap installs to help show the impact it can have on determining if there is a specific area that is negatively impacting your overall install success rate.

You can use the information gathered during the evaluation of your current install success rate to establish your goals and target specific areas for improvement.

Set a Goal

We recommended setting both a short and long term goal as well as a specific and overall goal for install success rate. They should also be based on current performance and are impacted by your current estimated install success rate. If detailed information was gathered in the evaluate stage, you should be able to pinpoint an area for setting a specific goal while keeping it attainable. The specific goal should end up having an impact on helping you reach your overall goal.


  • Short term: Increase the air gap install success rate to 60% and overall to 80% by the end of the quarter.
  • Long term: Increase the air gap install success rate to 75% and overall to 90% by the end of the next year.

Measure Performance

While your primary goal is the overall install success rate, you will also want to measure this metric in subsections to ensure you measure progress towards your specific goal as well as the other areas you analyzed during the evaluate stage. Segmenting data in addition to looking at it as a whole will help you determine if you missed, met or exceeded your goal(s) and what areas may have impacted the results.

In the example chart below, you’ll see that this vendor chose to focus on the success of online versus air gap installs in addition to their overall install success rate. The install success rate is calculated by identifying the percentage of total install attempts (not including ones still in progress) that were successful. The in progress install attempts should be noted, but are not included in the calculation as it is unknown if they will end up as a failure or success at the time of measurement.

Table depicting in progress, failed, and successful install attempts, and the install success rate of online, air gap, and overall

This example shows a much lower success rate for air gap installs, and this vendor should focus on adjustments to improve the success of those specific install types.

When measuring install success rate over time, you can see the impact that segments with a lower success rate have on your overall performance and how making adjustments to them can help you reach your goals.

Line graph depicting install success rate over time for online, air gap, and overall percentages, where all increase over time.

Make Adjustments to Improve Your Performance

Install success rate is highly impacted by the pre-install steps that come before you hit enter on the command line. How prepared you and your customers are to begin the installation is key to its success. The adjustments below are focused on being prepared and can help you increase the success of your installs:

  • Environment testing - If you are installing your application into a new type of customer environment, it’s important to do test installs internally in a similar environment. Testing in advance of the customer install will help you identify any additional requirements or limitations that may need to be added to the preflight checks or documentation and become aware of any potential pitfalls that may be encountered. Being prepared for a potential failure and being able to quickly identify and resolve the issue helps maintain customer confidence and increases the rate of success of future install attempts. 
  • Documentation - sharing documentation on prerequisites, installation process, and troubleshooting steps with your customer will help them be more prepared and increase the success of the install. Having members of your team continuously test and iterate on your documentation while thinking from the perspective of a customer helps ensure it’s clear and focused for first-time install attempts.

Adjustments made to improve your install success rate can also have a significant impact on other metrics, most notably your time to install, and improvements made with the intention of impacting one may also affect the other. As you make adjustments, you’ll want to look at what impact any changes had on your install success rate and take them into account as you go back through the process and continue working towards reaching your goals.

How Replicated Can Help

At Replicated, we are making progress on improving metrics and telemetry within our product to help ISVs understand the health and performance across customer instances and help with measuring metrics, including install success rate. In addition to working on providing information on individual instance install statuses and rolling data up into customer and channel overviews, Replicated also has resources that can be used to make adjustments to improve your install success rate:

  • Preflight checks - customizing preflight checks to ensure the customer’s infrastructure meets the needs of your application is an impactful way to increase the success rate of first-time installations, allowing customers to see value faster. Continuing to iterate on preflight checks as you find new limitations or requirements is key to reaching and maintaining your install success rate goals as you scale.
  • Host support bundles - If something doesn’t go as planned and an install attempt fails, you can increase the success of future installations by generating a host support bundle. You can also create custom host collectors and analyzers to help you gather specific information to identify root causes of failures so you can correct them.  Understanding why an install failed and taking steps to resolve the issue will increase the chance of success of future installation attempts. 
  • Documentation - Replicated has a documentation starter repo that can be used as a starting point for creating effective documentation.

Learn More