Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Obtain cost data by using the Cost API

Son Güncelleme:Oct 06, 2026

ACK kümesindeki pod'lar veya ad alanları için tahmini gerçek zamanlı maliyet ve kaynak kullanım verilerini sorgulamak üzere Cost API kullanın.

Ön koşullar

Başlamadan önce şunları yaptığınızdan emin olun:

Desteklenen sorgu boyutları

Cost API aşağıdaki sorgu boyutlarını destekler:

  • Pod — Tek bir pod, birden çok pod veya etikete göre filtrelenmiş pod'lar ile sorgulama yapabilirsiniz.

  • Ad alanı — Tek bir ad alanı veya tüm ad alanları ile sorgulama yapabilirsiniz.

Belirli bir kapsamı hedeflemek için DimensionType ve Dimension parametrelerini birlikte kullanın. Her iki boyutta da etikete göre filtreleme yapmak için LabelSelector ekleyin. LabelSelector ve DimensionType parametreleri AND mantığıyla birleştirilir.

Parametreler

Tüm örneklerde aşağıdaki uç noktaya karşı kubectl get --raw komutu kullanılır:

/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/cost

Sonuçları filtrelemek için bu uç noktaya sorgu parametreleri ekleyin.

Parametre Açıklama Varsayılan Geçerli değerler
DimensionType Maliyet verilerini sorgulamak için kullanılan boyut Pod (tüm pod'lar) Namespace, Pod
Dimension Sonuçları belirli bir ad alanına veya poda göre filtreler. Tümünü döndürmek için boş bırakın. Birden çok pod'u sorgulamak için virgülle ayrılmış değerler kullanın: pod=<name1>,pod=<name2> Tümü Bir ad alanı adı veya pod adı
LabelSelector Pod'ları app etiketine göre filtreler — app=<label-value>
TimeUnit Döndürülecek maliyet verilerinin zaman aralığı hour hour, day, week, month
Summary true olarak ayarlandığında, pod başına veriler yerine eşleşen tüm pod'lar için toplam maliyet verilerini döndürür false true, false

Maliyet verisi ölçümleri

Her yanıt girişi aşağıdaki maliyet ölçümlerini içerir:

Alan Birim Açıklama
cpu vCores CPU kullanımı
gpu Adet GPU sayısı
memory KB Bellek kullanımı
perCorePricing $ (Uluslararası site) Pod'un veya uygulamanın barındırıldığı düğümdeki vCore birim fiyatı
costRatio — Bu pod'un veya uygulamanın maliyetinin toplam küme maliyetine oranı. Örneğin, 0.2 değeri toplam küme maliyetinin %20'si anlamına gelir.
cost $ (Uluslararası site) Sorgulanan zaman aralığında pod'un veya uygulamanın toplam maliyeti
customCost — Sorgulanan zaman aralığında pod'un veya uygulamanın özel maliyeti

Her giriş ayrıca cpu, memory, gpu ve gpuMem için request, usage ve limit alt alanlarını içerir:

Alt alan Açıklama
request Pod tarafından talep edilen kaynak miktarı
usage Pod'un gerçek kaynak tüketimi
limit Pod için yapılandırılan kaynak sınırı

Örnekler

Örnek 1: Kümedeki tüm pod'ları önceki saat için sorgulama

kubectl get --raw "/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/cost"

Beklenen çıktıyı görüntülemek için genişletin

[
  {
    "metadata": {
      "timestamp": "2023-02-14T03:27:18Z",
      "timeUnit": "hour",
      "DimensionType": "",
      "Dimension": "",
      "PodName": "arms-springboot-demo-subcomponent-7f94c7f597-5l8tc"
    },
    "request": {
      "cpu": 0.5,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0.022,
      "memory": 1538784,
      "gpu": 0,
      "gpuMem": 0
    },
    "limit": {
      "cpu": 0,
      "memory": 0.5,
      "gpu": 0,
      "gpuMem": 0
    },
    "perCorePricing": 0.2,
    "costRatio": 0.010671219720414044,
    "cost": 0.1
  },
  {
    "metadata": {
      "timestamp": "2023-02-14T03:27:18Z",
      "timeUnit": "hour",
      "DimensionType": "",
      "Dimension": "",
      "PodName": "thanos-query-74cfcd459f-pf54n"
    },
    "request": {
      "cpu": 0.1,
      "memory": 131072,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0.001,
      "memory": 90780,
      "gpu": 0,
      "gpuMem": 0
    },
    ...
  }
]

Örnek 2: Bir ad alanındaki tüm pod'ları önceki saat için sorgulama

default değerini hedef ad alanının adıyla değiştirin.

kubectl get --raw "/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/cost?DimensionType=Namespace&Dimension=default" | jq .

Beklenen çıktıyı görüntülemek için genişletin

[
  {
    "metadata": {
      "timestamp": "2023-02-14T04:08:15Z",
      "timeUnit": "hour",
      "DimensionType": "Namespace",
      "Dimension": "default",
      "PodName": "test60-test-chart-v2-5cd85b946c-ntcct"
    },
    "request": {
      "cpu": 0,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0,
      "memory": 18336,
      "gpu": 0,
      "gpuMem": 0
    },
    "limit": {
      "cpu": 0,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "perCorePricing": 0,
    "costRatio": 0,
    "cost": 0
  },
  {
    "metadata": {
      "timestamp": "2023-02-14T04:08:15Z",
      "timeUnit": "hour",
      "DimensionType": "Namespace",
      "Dimension": "default",
      "PodName": "nginx"
    },
    "request": {
      "cpu": 0,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    ...
  }
]

Örnek 3: Belirli bir pod'u önceki saat için sorgulama

Pod adını gerçek değerle değiştirin.

kubectl get --raw "/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/cost?DimensionType=Pod&Dimension=pod=nginx-deployment-basic-75d6678cbb-lg8v5" | jq .

Beklenen çıktıyı görüntülemek için genişletin

[
  {
    "metadata": {
      "timestamp": "2023-02-14T04:09:50Z",
      "timeUnit": "hour",
      "DimensionType": "Pod",
      "Dimension": "pod=nginx-deployment-basic-75d6678cbb-lg8v5",
      "PodName": "nginx-deployment-basic-75d6678cbb-lg8v5"
    },
    "request": {
      "cpu": 0.5,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0.002,
      "memory": 50148,
      "gpu": 0,
      "gpuMem": 0
    },
    "limit": {
      "cpu": 0,
      "memory": 0.5,
      "gpu": 0,
      "gpuMem": 0
    },
    "perCorePricing": 0.2,
    "costRatio": 0.010671219720414044,
    "cost": 0.1
  }
]

Örnek 4: Pod'ları etikete göre sorgulama

Aşağıdaki komut, önceki saat için app=nginx etiketine sahip tüm pod'ları sorgular. Etiket değerini gerçek değerle değiştirin.

LabelSelector ve DimensionType parametreleri AND mantığıyla birleştirilir. DimensionType parametresini belirtmezseniz sorgu, etiketle eşleşen tüm pod'larda gerçekleştirilir.
kubectl get --raw "/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/cost?LabelSelector=app=nginx" | jq .

Beklenen çıktıyı görüntülemek için genişletin

[
  {
    "metadata": {
      "timestamp": "2023-02-14T04:10:24Z",
      "timeUnit": "hour",
      "DimensionType": "",
      "Dimension": "",
      "PodName": "nginx-deployment-basic-75d6678cbb-lg8v5"
    },
    "request": {
      "cpu": 0.5,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0.002,
      "memory": 50148,
      "gpu": 0,
      "gpuMem": 0
    },
    "limit": {
      "cpu": 0,
      "memory": 0.5,
      "gpu": 0,
      "gpuMem": 0
    },
    "perCorePricing": 0.2,
    "costRatio": 0.010671219720414044,
    "cost": 0.1
  },
  {
    "metadata": {
      "timestamp": "2023-02-14T04:10:24Z",
      "timeUnit": "hour",
      "DimensionType": "",
      "Dimension": "",
      "PodName": "nginx-675b8d6f54-vqxvd"
    },
    "request": {
      "cpu": 0.25,
      "memory": 524288,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0,
      "memory": 13548,
      "gpu": 0,
      "gpuMem": 0
    },
    "limit": {
      "cpu": 0,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "perCorePricing": 0.2,
    "costRatio": 0.005335609860207022,
    "cost": 0.05
  },
  {
    "metadata": {
      "timestamp": "2023-02-14T04:10:25Z",
      "timeUnit": "hour",
      "DimensionType": "",
      "Dimension": "",
      "PodName": "nginx-deployment-basic-7456bcd48d-r87rz"
    },
    "request": {
      "cpu": 0,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0,
      "memory": 223492,
      "gpu": 0,
      "gpuMem": 0
    },
    "limit": {
      "cpu": 0,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "perCorePricing": 0,
    "costRatio": 0,
    "cost": 0
  }
]

Örnek 5: Bir pod'un maliyetini önceki gün için sorgulama

Pod adını gerçek değerle değiştirin.

kubectl get --raw "/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/cost?DimensionType=Pod&Dimension=pod=nginx-deployment-basic-75d6678cbb-lg8v5&TimeUnit=day" | jq .

Beklenen çıktıyı görüntülemek için genişletin

[
  {
    "metadata": {
      "timestamp": "2023-02-14T04:11:04Z",
      "timeUnit": "day",
      "DimensionType": "Pod",
      "Dimension": "pod=nginx-deployment-basic-75d6678cbb-lg8v5",
      "PodName": "nginx-deployment-basic-75d6678cbb-lg8v5"
    },
    "request": {
      "cpu": 0.5,
      "memory": 0,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0.001,
      "memory": 50196,
      "gpu": 0,
      "gpuMem": 0
    },
    "limit": {
      "cpu": 0,
      "memory": 0.5,
      "gpu": 0,
      "gpuMem": 0
    },
    "perCorePricing": 0.2,
    "costRatio": 0.010571112959515542,
    "cost": 2.402
  }
]

Örnek 6: Bir ad alanı için toplanmış maliyeti sorgulama

Pod başına sonuçlar yerine ad alanındaki tüm pod'lar için tek bir toplanmış giriş almak üzere Summary=true ayarlayın. default değerini hedef ad alanının adıyla değiştirin.

kubectl get --raw "/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/cost?DimensionType=Namespace&Dimension=default&Summary=true" | jq .

Beklenen çıktıyı görüntülemek için tıklayın

[
  {
    "metadata": {
      "timestamp": "2023-02-14T04:12:48Z",
      "timeUnit": "hour",
      "DimensionType": "Namespace",
      "Dimension": "default",
      "PodName": ""
    },
    "request": {
      "cpu": 12,
      "memory": 7045120,
      "gpu": 0,
      "gpuMem": 0
    },
    "usage": {
      "cpu": 0.053,
      "memory": 4901208,
      "gpu": 0,
      "gpuMem": 0
    },
    "limit": {
      "cpu": 0,
      "memory": 6553600,
      "gpu": 0,
      "gpuMem": 0
    },
    "perCorePricing": 4.061,
    "costRatio": 0.01609432143753053,
    "cost": 3.657
  }
]

Sırada ne var

İlgili kaynaklar