diff --git a/content/hcp-docs/content/docs/vault/snapshot-size-thresshold.mdx b/content/hcp-docs/content/docs/vault/snapshot-size-thresshold.mdx new file mode 100644 index 0000000000..e89a0a6f40 --- /dev/null +++ b/content/hcp-docs/content/docs/vault/snapshot-size-thresshold.mdx @@ -0,0 +1,66 @@ +--- +page_title: HCP Vault snapshot thresholds +sidebar_title: Snapshot size thresholds +description: >- + Snapshot size thresholds for HCP Vault Dedicated cluster tier and size combinations. +# START AUTO GENERATED METADATA, DO NOT EDIT +created_at: 2026-07-27T00:00:00-05:00 +last_modified: 2026-07-27T00:00:00-05:00 +# END AUTO GENERATED METADATA +--- + +# HCP Vault cluster snapshot size thresholds + +To ensure cluster stability, performance, and reliability, HCP Vault Dedicated defines +snapshot size thresholds for each cluster tier and size combination. + + +As you increase usage of Vault resources, such as the key/value v2 (KV v2) secrets engine, +internal storage utilization and snapshot size increase. Each tier and size combination +supports a specific workload scale. + +When snapshot size grows beyond supported boundaries, cluster load increases and internal +operations can slow down or fail. + +## Threshold levels + +Each tier and size combination has two snapshot size thresholds. + +### Warning threshold + +The warning threshold indicates that your cluster is approaching capacity limits. + +- The cluster may continue to function. +- Performance degradation may begin. +- Internal operations may slow down. +- HCP sends an email when the warning threshold is breached. +- HCP sends another email if usage continues to increase before the critical threshold is breached. +- Reevaluate and redesign your usage patterns for Vault resources. + +### Critical threshold + +The critical threshold represents the maximum supported capacity. + +- Cluster stability is at risk. +- Critical internal operations may fail. +- HCP sends an email when the critical threshold is breached. +- Backend safeguards may be triggered. +- Some operations may be restricted, throttled, or blocked. + + +| Tier | Size | Snapshot warning limit | Snapshot critical limit | +| --- | --- | --- | --- | +| Development | Extra small | 30 MB | 45 MB | +| Essential | Small | 800 MB | 1 GB | +| Essential | Medium | 2.4 GB | 3 GB | +| Essential | Large | 6 GB | 7.5 GB | +| Standard | Small | 1 GB | 1.2 GB | +| Standard | Medium | 2.56 GB | 3.2 GB | +| Standard | Large | 6.4 GB | 8 GB | + +## Monitor snapshot size growth + +Snapshot size is the primary indicator of cluster load and health. Monitor snapshot size and +keep it within the threshold for your cluster tier and size. + +Snapshot size growth can be viewed from HCP Vault dashboard under the snapshots tab in the [HCP Portal](https://portal.cloud.hashicorp.com). \ No newline at end of file diff --git a/content/hcp-docs/data/docs-nav-data.json b/content/hcp-docs/data/docs-nav-data.json index 96b1dfc7ff..0562f42c09 100644 --- a/content/hcp-docs/data/docs-nav-data.json +++ b/content/hcp-docs/data/docs-nav-data.json @@ -542,6 +542,10 @@ { "title": "Migrate to HCP Vault Dedicated", "path": "vault/get-started/deployment-considerations/migrate-to-hcp" + }, + { + "title": "Snapshot size thresholds", + "path": "vault/snapshot-size-thresshold" } ] },