Skip to main content
GET
/
api
/
v1
/
analytics
/
capacity
Analytics Capacity
curl --request GET \
  --url https://api.example.com/api/v1/analytics/capacity
{
  "apiVersion": "v1",
  "kind": "CapacityForecastList",
  "metadata": {
    "totalCount": 2,
    "page": 1,
    "pageSize": 2
  },
  "items": [
    {
      "Resource": {"Kind": "Deployment", "Name": "payment-service", "Namespace": "production"},
      "Urgency": "urgent",
      "Recommendation": "Memory exhaustion projected in 5 days. Scale up or optimize memory usage.",
      "IsBottleneck": true
    },
    {
      "Resource": {"Kind": "StatefulSet", "Name": "redis-cluster", "Namespace": "data"},
      "Urgency": "plan",
      "Recommendation": "CPU trend increasing. Plan capacity review within 30 days."
    }
  ]
}
​
namespace
string
Filter by Kubernetes namespace
​
from
string
Start date in RFC3339 format
​
to
string
End date in RFC3339 format (default: now). Analysis window defaults to 7 days.

​
Forecast Fields

FieldDescription
ResourceThe Kubernetes resource (kind, name, namespace)
Urgencyurgent (exhaustion in less than 7 days), plan (7-30 days), stable (more than 30 days)
RecommendationAuto-generated recommendation based on urgency
IsBottleneckWhether this resource correlates with active incidents
{
  "apiVersion": "v1",
  "kind": "CapacityForecastList",
  "metadata": {
    "totalCount": 2,
    "page": 1,
    "pageSize": 2
  },
  "items": [
    {
      "Resource": {"Kind": "Deployment", "Name": "payment-service", "Namespace": "production"},
      "Urgency": "urgent",
      "Recommendation": "Memory exhaustion projected in 5 days. Scale up or optimize memory usage.",
      "IsBottleneck": true
    },
    {
      "Resource": {"Kind": "StatefulSet", "Name": "redis-cluster", "Namespace": "data"},
      "Urgency": "plan",
      "Recommendation": "CPU trend increasing. Plan capacity review within 30 days."
    }
  ]
}