> ## Documentation Index
> Fetch the complete documentation index at: https://docs.periscope.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Deployment frequency

> How often your team deploys code to production. The first of the four DORA metrics.

Deployment frequency measures how often your team successfully ships code to production. It is a proxy for batch size — teams that deploy frequently are shipping smaller changes, which are easier to review, test, and roll back.

## What Periscope tracks

Periscope calculates deployment frequency from the deployment events you send via the [deployment webhook](/integrations/deployment-webhook). The dashboard shows:

* **Total deployments** in the selected time period
* **Average deployments per week**
* **Daily deployment counts** broken down by success and failure
* **Environment breakdown** showing deploys across production, staging, and other environments
* **DORA level classification** (Elite, High, Medium, Low)

## DORA benchmarks

| Level      | Benchmark                                      |
| ---------- | ---------------------------------------------- |
| **Elite**  | On demand — multiple deploys per day           |
| **High**   | Between once per week and once per month       |
| **Medium** | Between once per month and once every 6 months |
| **Low**    | Less than once every 6 months                  |

## How it works

Periscope counts all completed deployment events within the selected time range. You can filter by environment to focus on production deployments only, or view all environments to understand your full deployment pipeline.

## Interpreting the data

* **Increasing frequency** usually indicates improving delivery practices — smaller batches, better automation, and more confidence in the pipeline.
* **Low frequency with high failure rate** suggests the team is batching large changes that are riskier to deploy.
* **Gaps in daily deployment counts** may indicate deployment freezes, holidays, or blockers in the pipeline.
* **Environment breakdown** helps you see if staging deployments are happening but production deploys lag behind, which could indicate a manual approval bottleneck.

## MCP tool

Query deployment frequency from your AI coding assistant:

```
get_deployment_frequency(time_range: "30d", environment: "production")
```

Returns total deploys, average per week, breakdown by environment, and the last 14 days of daily data.

<Card title="Set up deployments" icon="webhook" href="/integrations/deployment-webhook">
  Start sending deployment events to see this metric.
</Card>
