Capacity Planning

The CapacityPlanningController provides resource utilization analysis and capacity forecasting. It helps platform operators understand current resource consumption, predict when capacity limits will be reached, and plan infrastructure scaling.

Resource Utilization

Endpoint: GET /api/v1/observability/capacity/utilization

Returns current resource utilization across the tenant's services.

ResourceUtilization Structure

Capacity Forecast

Endpoint: GET /api/v1/observability/capacity/forecast

Projects resource needs based on current trends.

CapacityForecast Structure

Capacity Plans

Create Capacity Plan

Endpoint: POST /api/v1/observability/capacity/plans

curl -X POST http://localhost:8088/api/v1/observability/capacity/plans \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "X-Tenant-ID: 550e8400" \
  -d '{
    "name": "Q2 2026 Scaling Plan",
    "targetDate": "2026-06-30",
    "growthRate": 0.15,
    "services": ["ai-service", "query-engine"],
    "constraints": {
      "maxBudget": 50000,
      "maxCpuCores": 100,
      "maxMemoryGb": 512
    }
  }'

CapacityPlan Structure

Scaling Recommendations

The capacity planning engine generates recommendations based on utilization trends: