# Deploy frequency ![](/files/YP4OHP54mYLgZxDUxA1S) **Deploy frequency** measures how often you deploy changes to a given target environment. Along with [Change lead time](/sleuth-dora/accelerate-metrics/change-lead-time.md), **Deploy frequency** is a measure of *speed* (whereas [Change failure rate](/sleuth-dora/accelerate-metrics/change-failure-rate.md) and [MTTR](/sleuth-dora/accelerate-metrics/mttr.md) are measures of *quality*, or *stability*) Once you've [configured your deployment to let Sleuth know when you deploy](/sleuth-dora/modeling-your-deployments/code-deployments/how-to-register-a-deploy.md), Sleuth will use those events to determine your deploy frequency for all [code deployments](/sleuth-dora/modeling-your-deployments/code-deployments.md) and [feature flags](/sleuth-dora/modeling-your-deployments/feature-flags.md) you've setup within a [project](/sleuth-dora/modeling-your-deployments/projects.md) and [environment](/sleuth-dora/modeling-your-deployments/environment-support.md). Sleuth's [**Project Metrics**](/sleuth-dora/modeling-your-deployments/projects.md) and [**Team Metrics**](/sleuth-dora/modeling-your-deployments/teams.md) dashboards show the total number of deploys and the frequency, deploys per day, in the selected period. The deploys per day statistic is calculated by taking the total number of deploys divided by the total number of days in the period, weekends included. For more on how Sleuth measures Deploy frequency, check out Sleuth CTO, Don Brown, explaining it in detail in this SleuthTV episode! {% embed url="" %} Sleuth CTO Don Brown explains how Sleuth measures Deploy frequency {% endembed %} ### Batch Size Breakdowns In order to help you better contextualize your deploy frequency, Sleuth also provides a detailed breakdown of the batch size of each deploy as a percentage of the total and broken down per day. Batch size is defined as a blend of the number of pull requests, the number of commits, and the amount of code changed, weighted in that order. Batch sizes are defined as: * Small - usually 1 pull request, 1 - 10 commits and a few hundred lines of code changed * Medium - usually 1 - 2 pull requests, 10 - 30 commits and many hundreds of lines of code changed * Large - usually 2 - 4 pull requests, 20 - 40 commits and many hundreds of lines of code changed * Gigantic - usually 4 or more pull requests or 30 or more commits or many thousands of lines of code changed {% hint style="info" %} Because batch size is a weighted blend of pull requests, commits and code changes, you may find that an especially large amount of change in any of those elements can cause a deploy to be classified as Large or Gigantic. {% endhint %} ## Feature flags and Deploy frequency Sleuth [supports feature flags](/sleuth-dora/modeling-your-deployments/feature-flags.md) as a first class form of change. That said, we find that teams want to understand the distinction between their code deploy frequency and their flag change frequency. Sleuth's Project Metrics and Team Metrics dashboards show the two frequencies as separate graph lines and allows you to toggle one or the other on and off. To see totals for flag frequency you can hover over a data point. ## Setting up Deploy frequency Sleuth uses our [code integrations](https://help.sleuth.io/integrations-1/code-deployment) (Github, Bitbucket, Gitlab, etc) coupled with our [deployment tracking](/sleuth-dora/modeling-your-deployments.md) to understand when you've deployed. Once you've connected your code to Sleuth, setup your first [code deployment](/sleuth-dora/modeling-your-deployments/code-deployments.md) and started [registering deploys](/sleuth-dora/modeling-your-deployments/code-deployments/how-to-register-a-deploy.md) Sleuth will automatically track your deploy frequency and batch size breakdown for each deploy to each of your defined [Environments](/sleuth-dora/modeling-your-deployments/environment-support.md). Sleuth uses our [LaunchDarkly integration](/sleuth-dora/integrations-1/feature-flags/launchdarkly.md) to track feature flag changes. Once setup, we'll automatically start tracking your flag frequency across each of your defined [Environments](/sleuth-dora/modeling-your-deployments/environment-support.md). {% hint style="info" %} For the most accurate metrics we recommend using one of our native [CI/CD integrations](/sleuth-dora/integrations-1/builds.md) or a [webhook to register](https://help.sleuth.io/modeling-your-deployments/code-deployments/how-to-register-a-deploy#precise-deploy-registration-via-a-webhook) your deploys. Initially, Sleuth is configured to count a pull request merge as a deploy until we've received your first integrated deployment notification. {% endhint %} ## Further Reading For additional information on how Sleuth calculates and presents Deploy frequency and other DORA metrics throughout its various dashboards and views, see [Interpreting metrics in Sleuth](/sleuth-dora/accelerate-metrics/how-we-calculate.md). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.sleuth.io/sleuth-dora/accelerate-metrics/deploy-frequency.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.