Kubernetes Rest API 节点 CPU 和 RAM 使用率百分比

问题描述

我想开发一个简单的网络服务,它返回 kubernetes 指标,如节点/pod cpu 和 RAM 使用率的百分比。 在 CLI 中有 kubectl top nodekubectl describe node 之类的命令,其中包含我需要的所有指标。但是,我无法在 kubernetes REST api 端点中找到此类指标。我得到的最接近的是 /apis/metrics.k8s.io/v1beta1/nodes 端点,它显示 cpu 和 RAM 使用率,但没有百分比。

是否有这样的端点显示topdescribe 命令中相同的信息,或者,也许有比 metrics.k8s.io 插件更好的方法

解决方法

当您发出 kubectl top node 时,kubectl 会向多个端点发出多个 HTTP 请求。您可以通过将 --v=9 标志添加到 kubectl 来查看确切的端点。

以我为例

kubectl top node gke-cluster-1-default-pool-99238d56-bv6z --v=9
[...]
I0726 10:41:18.347144    1986 round_trippers.go:435] curl -k -v -XGET  -H "Accept: application/json,*/*" -H "User-Agent: kubectl/v1.21.0 (linux/amd64) kubernetes/cb303e6" 'https://<ip-address>/apis/metrics.k8s.io/v1beta1/nodes/gke-cluster-1-default-pool-99238d56-bv6z'
I0726 10:41:18.489068    1986 round_trippers.go:435] curl -k -v -XGET  -H "Accept: application/json,*/*" -H "User-Agent: kubectl/v1.21.0 (linux/amd64) kubernetes/cb303e6" 'https://<ip-address>/api/v1/nodes/gke-cluster-1-default-pool-99238d56-bv6z'
[...]

(还有很多,这两个对于回答您的问题很重要)

第一次请求返回

{
    "kind":"NodeMetrics","apiVersion":"metrics.k8s.io/v1beta1","metadata":{
        "name":"gke-cluster-1-default-pool-99238d56-bv6z","selfLink":"/apis/metrics.k8s.io/v1beta1/nodes/gke-cluster-1-default-pool-99238d56-bv6z","creationTimestamp":"2021-07-26T08:41:19Z"
    },"timestamp":"2021-07-26T08:41:07Z","window":"30s","usage":{
        "cpu":"86855567n","memory":"950228Ki"
    }
}

.usage.cpu.usage.memory 分别显示使用的 CPU 和内存。

第二次请求返回(截断,响应巨大)

{
    "status":{
        "capacity":{
            "attachable-volumes-gce-pd":"15","cpu":"2","ephemeral-storage":"98868448Ki","hugepages-1Gi":"0","hugepages-2Mi":"0","memory":"4031624Ki","pods":"110"
        },"allocatable":{
            "attachable-volumes-gce-pd":"15","cpu":"940m","ephemeral-storage":"47093746742","memory":"2885768Ki","pods":"110"
        }
    }
}

.status.allocatable.cpu.status.allocatable.memory 显示可以分配多少 CPU 和内存给正在运行的 Pod。


如您所见,没有以百分比形式返回使用情况的端点,kubectl 会即时进行计算,以人类友好的格式输出结果

$ kubectl top node gke-cluster-1-default-pool-99238d56-bv6z
NAME                                       CPU(cores)   CPU%   MEMORY(bytes)   MEMORY%   
gke-cluster-1-default-pool-99238d56-bv6z   108m         11%    928Mi           32%
,

我建议您使用官方 Kubernetes 客户端库。在那里您可以实现 kubectl 上可用的所有功能。 您可以使用以下代码片段实现 kubectl top 命令

[https://github.com/kubernetes-client/javascript/blob/master/examples/top.js][1]