Kubernetes Clusters Results
Kubernetes Clusters Results
#340830
Description
Resources
- /kubernetes/clusters/<clusterName>/containers
- /analysis/containers/kubernetes/clusters/<clusterName>/containers?details=true
Supported Operations
Table: Kubernetes Clusters Results Supported Operations
|
HTTP Method |
Input |
Output |
Description |
|
Path Parameter: |
Collection of:
|
Use this resource to retrieve details of container recommendation for a specific Kubernetes cluster. |
|
|
GET / |
Path Parameter: |
In addition to the above-listed properties the following additional details are included: |
Use this resource to retrieve additional details for a specific Kubernetes cluster. |
Table: Kubernetes Clusters Path Parameters
|
Parameter Name |
Type |
Description |
|
string |
The unique cluster name obtained from the output of /kubernetes/clusters or from the Kubex UI Connections tab. |
If a property or value is not set or not available, it is not included in the response.
Table: Kubernetes Cluster Response Schema
|
Element |
Type |
Filter/Sort |
Description |
|
string |
|
The cluster name as specified in the config.yaml files. |
|
|
string |
|
The name of the namespace associated with the selected container. |
|
|
string |
|
This is the name of the controller or pod. You can have one or more containers per pod. |
|
|
string |
|
The controller type that monitors and maintains the state of your cluster. This can be one of DaemonSet, Deployment, ReplicaSet, ReplicationController, StatefulSet, etc. |
|
|
string |
|
This is the name of the container manifest. |
|
|
string |
|
A unique identifier, for the selected cluster assigned by Densify. |
|
|
string |
|
A unique identifier for the listed container. |
|
|
integer |
|
This is the number of containers specified by the selected manifest. The number is determined using an average number of containers, based on the metric, "In Service Instances". |
|
|
integer |
|
The current CPU request value for the listed container. |
|
|
integer |
|
The current CPU limit value for the listed container. |
|
|
integer |
|
The current memory request value for the listed container. |
|
|
integer |
|
The current memory limit value for the listed container. |
|
|
integer |
|
The recommended CPU request value for the listed container. |
|
|
integer |
|
The recommended CPU limit value for the listed container. |
|
|
integer |
|
The recommended memory request value for the listed container. |
|
|
integer |
|
The recommended memory limit value for the selected container. |
|
|
integer |
|
The estimated savings that can be achieved by using the recommended CPU and memory settings for this container. |
|
|
date |
|
The date and time of the most recent analysis refresh, in the format: YYYY-MM-DDTHH:mm:ssZ |
Table: Kubernetes Cluster Response Schema - Additional Details
|
Element |
Type |
Filter/Sort |
Description |
|
string |
|
The predicted uptime (%) for the container, is based on the percentage of hours CPU utilization data is present in the historical interval, as specified in the policy settings for the entity. |
|
|
date |
|
A value in this column indicates the instance request/limit values have been changed recently. The date and time are in the format: YYYY-MM-DDTHH:mm:ssZ. The workload for this instance, on which the recommendation is based, includes all historical data for this instance and is not included in the analysis. |
|
|
string |
|
This contains the names of the associated node groups. |
|
|
string |
|
The number of out of memory (oom) events that occurred in the last 7 days. |
|
|
date |
|
The date and time on which this container was last audited, in the format: YYYY-MM-DDTHH:mm:ssZ. The value is from the workload history instead of the audit history, which may be truncated. |
|
|
date |
|
The date and time on which this container was first audited, in the format: YYYY-MM-DDTHH:mm:ssZ. The value is from the workload history instead of the audit history, which may be truncated. |
Examples
Example: Listing Recommendations for Pods in a Specified Cluster
The following example shows you how to retrieve recommendation details for the container manifests in the specified cluster. This command shows all analyzed containers in the specified cluster.
Example: Listing Recommendations for Containers in a Specified Cluster
Request:
GET {{scheme}}://{{host}}{{port}}/api/v2/kubernetes/clusters/eks_oss_dev/containersResponse:
Example: Listing Recommendations for Containers in a Specified Cluster
[
{
"cluster": "eks_oss_dev",
"namespace": "dss",
"podOwnerName": "main-entity-operator",
"podOwnerKind": "Deployment",
"container": "user-operator",
"entityId": "aa5c013d-dfb8-45e2-a05a-cf6a35005079",
"containerId": "583719fc-9fb4-32fa-8d38-19aa539840c6",
"avgContainerCount": 2,
"currentCpuRequestmCores": 10,
"currentCpuLimit": 2500,
"currentMemRequestBytes": 40000000,
"currentMemLimitBytes": 256000000,
"recommendedCpuRequestmCores": 10,
"recommendedCpuLimitmCores": 10,
"recommendedMemRequestBytes": 20000000,
"recommendedMemLimitBytes": 30000000,
"estimatedSavingsPerContainer": 33.34,
"analyzedOn": "2025-03-19T04:33:40Z,
},
{
"cluster": "eks_oss_dev",
"namespace": "prometheus",
"podOwnerName": "prometheus-server",
"podOwnerKind": "Deployment",
"container": "prometheus-server-configmap-reload",
"entityId": "05e67e8c-8e45-4a3f-b4f4-07e1ac718275",
"containerId": "e5dd3d73-40c7-31b2-9877-903a6e6e3929",
"avgContainerCount": 1,
"recommendedCpuRequestmCores": 10,
"recommendedCpuLimitmCores": 10,
"recommendedMemRequestBytes": 20000000,
"recommendedMemLimitBytes": 80000000,
"estimatedSavingsPerContainer": -0.29,
"analyzedOn": "2025-03-19T04:33:40Z"
},
{
…
}
]
Example: Listing Recommendations for Pods in a Specified Cluster with Additional Details
The following example shows you how to return details for a specific cluster.
Example: Listing Recommendations for Pods in a Specified Cluster with Additional Details
Request:
GET {{scheme}}://{{host}}{{port}}/api/v2/kubernetes/clusters/eks_oss_devResponse:
Example: Listing Recommendations for Pods in a Specified Cluster with Additional Details
[
{
"cluster": "eks_oss_dev",
"namespace": "densify",
"podOwnerName": "kubex-prometheus-node-exporter",
"podOwnerKind": "DaemonSet",
"container": "node-exporter",
"entityId": "11aeafc0-4d1f-4f2c-a69f-cd68cd9c4abb",
"containerId": "7552dd71-d546-3dae-b709-fad40d729a6f",
"avgContainerCount": 3,
"recommendedCpuRequestmCores": 10,
"recommendedCpuLimitmCores": 10,
"recommendedMemRequestBytes": 20000000,
"recommendedMemLimitBytes": 30000000,
"estimatedSavingsPerContainer": -0.06,
"analyzedOn": "2025-03-19T04:33:40Z",
"predictedUptime": 21.54,
"nodeGroup": [
"test_node_group",
"test_node_group_2"
],
"oomKills_last7days": 0,
"dataCollection": {
"dateFirstAudited": "2024-12-27T12:00:00Z",
"dateLastAudited": "2025-01-30T17:00:00Z"
}
},
{
...
}
]