Finansal yönetişim ve muhasebe amacıyla kullanılmak üzere bir kümenin iş yükü boyutundaki maliyet tahsis verilerini sorgular.
Ön koşullar
Başlamadan önce, Maliyet verilerini sorgulamak için API çağırma genel bakışı bölümünde açıklanan ön koşulların karşılandığından emin olun.
İstek ve yanıt parametreleri
İstek sözdizimi
GET /v2/allocation
İstek parametreleri
| Parametre | Tür | Gerekli | Açıklama |
|---|---|---|---|
window |
string | Evet |
Sorgulanacak zaman aralığı. Minimum aralık 24 saattir. Aşağıdaki biçimleri kabul eder: Anahtar kelimeler: Süre: RFC3339 tarih çifti (virgülle ayrılmış): UNIX zaman damgası çifti (virgülle ayrılmış, saniye cinsinden): Örnekler: - - - - |
filter |
string | Hayır |
Sonuçları iş yüküne göre filtreler. Desteklenen filtre türleri: - - - - - Aynı türdeki birden fazla değere göre filtrelemek için değerleri virgülle ayırın: Birden fazla filtre türünü birleştirmek için bunları artı işaretiyle ( |
step |
string | Hayır |
Zaman aralığını maliyet kümelerine bölmek için kullanılan aralık. Bir maliyet kümesi, aralık içindeki bir pod gibi bir Kubernetes nesnesinin maliyet verilerini içerir. Varsayılan: Örnekler: - - |
aggregate |
string | Hayır |
Sonuçları belirtilen boyuta göre toplar. Desteklenen değerler: - - - - - |
idle |
boolean | Hayır | Boşta kalan maliyetlerin sonuçlara dahil edilip edilmeyeceğini belirtir. Varsayılan: true. |
shareIdle |
boolean | Hayır | Boşta kalan maliyetlerin iş yükleri arasında dağıtılıp dağıtılmayacağını belirtir. Varsayılan: false. |
shareSplit |
string | Hayır |
Boşta kalan maliyet dağıtım ilkesi. Desteklenen değerler: - - |
idleByNode |
boolean | Hayır | Boşta kalan maliyetlerin küme düzeyi yerine düğüm düzeyinde toplanıp toplanmayacağını belirtir. Yalnızca aggregate=node ve shareIdle=false olduğunda etkilidir. Varsayılan: false. |
targetType |
string | Hayır |
Maliyet tahsisinin kapsamı. Desteklenen değerler: - - |
format |
string | Hayır |
Çıktı biçimi. Desteklenen değerler: - - |
idleByNodeyalnızca hemaggregate=nodehem deshareIdle=falseolduğunda etkilidir. EğershareIdle=trueise, boşta kalan maliyetler zaten iş yükleri arasında dağıtılmıştır ve düğüme göre toplanamaz.
Yanıt parametreleri
| Parametre | Tür | Açıklama |
|---|---|---|
properties |
object | İlişkili Kubernetes nesnesinin özellikleri. |
pod |
string | Pod'un adı. |
node |
string | Düğümün adı. |
namespace |
string | Ad alanı. |
controllerKind |
string | Denetleyici türü. |
controller |
string | Denetleyici adı. |
providerID |
string | Düğümün Elastic Compute Service (ECS) örnek kimliği. |
labels |
map[string]string | Pod'un etiketleri. Not
Prometheus yalnızca etiket adlarında alt çizgi ( |
start |
string | Maliyet kümesinin başlangıç zamanı. |
end |
string | Maliyet kümesinin bitiş zamanı. |
cpuCoreRequestAverage |
float | İstenen ortalama sanal CPU sayısı. |
cpuCoreUsageAverage |
float | Kullanımda olan ortalama sanal CPU sayısı. |
ramByteRequestAverage |
float | İstenen ortalama bellek miktarı (bayt cinsinden). |
ramByteUsageAverage |
float | Kullanımda olan ortalama bellek miktarı (bayt cinsinden). |
cost |
float | Toplam küme maliyetinden hizmete tahsis edilen maliyet. |
costRatio |
float | Tahsis edilen maliyetin toplam küme maliyetine oranı. |
customCost |
float | Özel maliyet. |
Maliyet içgörüsü verilerini sorgulama
Tüm örneklerde Kubernetes API'ye erişmek için curl kullanılır. Kurulum talimatları için bkz. Kubernetes API'yi kullanma.
Önceki günün küme maliyetinden bir DaemonSet'e tahsis edilen maliyeti sorgulama
Aşağıdaki komut, kube-system ad alanında bulunan ve terway-eniip DaemonSet'ine ait pod'lar için önceki günün maliyetini sorgular.
curl -G -k --cert ./client-cert.pem --key ./client-key.pem \
-d 'window=yesterday' \
-d 'filter=namespace:"kube-system"+controllerKind:"DaemonSet"+label[app]:"terway-eniip"' \
"$APISERVER/api/v1/namespaces/kube-system/services/ack-metrics-adapter-api-service:8080/proxy/v2/allocation" | jq .
Örnek yanıt:
{
"data": [
{
"kube-system/terway-eniip-88286": {
"name": "kube-system/terway-eniip-88286",
"properties": {
"controller": "terway-eniip",
"controllerKind": "DaemonSet",
"namespace": "kube-system",
"pod": "terway-eniip-88286"
},
"start": "2024-03-25T00:00:00+08:00",
"end": "2024-03-26T00:00:00+08:00",
"cpuCoreRequestAverage": 0.35,
"cpuCoreUsageAverage": 0.001,
"ramByteRequestAverage": 209715200,
"ramByteUsageAverage": 65815511.039,
"cost": 4.497,
"costRatio": 0.016,
"customCost": 0.972
},
"kube-system/terway-eniip-j8c87": {
"name": "kube-system/terway-eniip-j8c87",
"properties": {
"controller": "terway-eniip",
"controllerKind": "DaemonSet",
"namespace": "kube-system",
"pod": "terway-eniip-j8c87"
},
"start": "2024-03-25T00:00:00+08:00",
"end": "2024-03-26T00:00:00+08:00",
"cpuCoreRequestAverage": 0.35,
"cpuCoreUsageAverage": 0.001,
"ramByteRequestAverage": 209715200,
"ramByteUsageAverage": 186293944.32,
"cost": 6.504,
"costRatio": 0.023,
"customCost": 0.972
},
"kube-system/terway-eniip-xjsr8": {
"name": "kube-system/terway-eniip-xjsr8",
"properties": {
"controller": "terway-eniip",
"controllerKind": "DaemonSet",
"namespace": "kube-system",
"pod": "terway-eniip-xjsr8"
},
"start": "2024-03-25T00:00:00+08:00",
"end": "2024-03-26T00:00:00+08:00",
"cpuCoreRequestAverage": 0.35,
"cpuCoreUsageAverage": 0.001,
"ramByteRequestAverage": 209715200,
"ramByteUsageAverage": 53661380.923,
"cost": 2.337,
"costRatio": 0.008,
"customCost": 0.505
}
}
]
}