Skip to content

Update capacity planning doc for blocks storage and add capacity test…#7304

Open
CharlieTLe wants to merge 1 commit intocortexproject:masterfrom
CharlieTLe:capacity-planning-blocks-storage
Open

Update capacity planning doc for blocks storage and add capacity test…#7304
CharlieTLe wants to merge 1 commit intocortexproject:masterfrom
CharlieTLe:capacity-planning-blocks-storage

Conversation

@CharlieTLe
Copy link
Member

… setup

The capacity planning doc was explicitly marked as out of date for blocks storage. This updates the rules of thumb with measured numbers from a new local capacity test that runs Cortex in microservices mode (separate distributor, ingester, querier, store-gateway containers).

Key changes to capacity-planning.md:

  • Remove "likely out of date" warning
  • Update ingester memory estimate from 15GB to 4-8GB per million series
  • Replace chunks storage numbers with blocks storage equivalents
  • Add ingester disk and object storage sizing guidance
  • Add cross-references to blocks-storage/production-tips.md

New development/capacity-test/ setup:

  • Microservices mode with memberlist ring discovery (no Consul needed)
  • 25 tenants for ~120K series to reduce fixed-overhead skew
  • Script queries Prometheus for ingester-only RSS/heap/CPU metrics
  • Prints per-million-series capacity estimates with caveats

… setup

The capacity planning doc was explicitly marked as out of date for blocks
storage. This updates the rules of thumb with measured numbers from a new
local capacity test that runs Cortex in microservices mode (separate
distributor, ingester, querier, store-gateway containers).

Key changes to capacity-planning.md:
- Remove "likely out of date" warning
- Update ingester memory estimate from 15GB to 4-8GB per million series
- Replace chunks storage numbers with blocks storage equivalents
- Add ingester disk and object storage sizing guidance
- Add cross-references to blocks-storage/production-tips.md

New development/capacity-test/ setup:
- Microservices mode with memberlist ring discovery (no Consul needed)
- 25 tenants for ~120K series to reduce fixed-overhead skew
- Script queries Prometheus for ingester-only RSS/heap/CPU metrics
- Prints per-million-series capacity estimates with caveats

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Charlie Le <charlie_le@apple.com>
@dosubot dosubot bot added the storage/blocks Blocks storage engine label Mar 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/XL storage/blocks Blocks storage engine

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant