Skip to main content
GET
/
analytics
/
capacity
Capacity Forecast
curl --request GET \
  --url http://{host}:{port}/{basePath}/analytics/capacity \
  --header 'Authorization: <api-key>'
{
  "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."
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer token issued by the operator. Format: Authorization: Bearer <token>.

Query Parameters

​
namespace
string

Filter by namespace.

​
from
string<date-time>

Start date (RFC3339).

​
to
string<date-time>

End date (RFC3339).

Response

Capacity forecast list

​
apiVersion
string
Example:

"v1"

​
kind
string
Example:

"CapacityForecastList"

​
metadata
object
​
items
object[]