Basit Günlük Hizmeti (SLS) Ingress ölçümlerini External Metrics API aracılığıyla Kubernetes yatay pod otomatik ölçeklendirmesine (HPA) bağlayarak yalnızca CPU kullanımına değil, gerçek trafik sinyallerine dayalı olarak pod'ları ölçeklendirin. Bu kılavuz tam bir örnek üzerinden ilerler: Bir Nginx uygulaması dağıtın, bunu bir Ingress üzerinden açığa çıkarın ve ardından HPA'yı saniye başına sorgu (QPS) ile 99,99. yüzdelik gecikme süresine göre ölçeklendirme yapacak şekilde yapılandırın.
Ön koşullar
Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:
kubectl yapılandırılmış bir ACK kümesi
SLS günlük toplama özelliği etkinleştirilmiş bir Ingress denetleyicisi (küme oluştururken varsayılan olarak etkinleştirilir)
Helm çizelgelerini yükleme ve HPA kaynakları oluşturma izinleri
Nasıl çalışır
ack-alibaba-cloud-metrics-adapter bileşeni, Alibaba Cloud izleme hizmetleri ile Kubernetes External Metrics API arasında köprü kurar. Kurulum tamamlandığında HPA, sls_ingress_qps ve sls_ingress_latency_p9999 gibi SLS Ingress ölçümlerini sorgulayabilir ve Dağıtımınızın çoğaltma sayısını buna göre ayarlayabilir.
Adım 1: ack-alibaba-cloud-metrics-adapter yükleyin
ack-alibaba-cloud-metrics-adapter bileşeni, Kubernetes'in External Metrics API aracılığıyla ECS, SLB ve RDS dahil olmak üzere Alibaba Cloud hizmetlerinden izleme verilerini almasını sağlar.
Bu bileşen yerinde yükseltmeyi desteklemez. Yükseltmek için önce mevcut sürümü kaldırın, ardından en son sürümü yükleyin. Kaldırma ve yeniden yükleme sırasında izleme verilerinin alınması durduğu için ilgili HPA'lar ölçeklendirmeyi duraklatır.
Konteyner Hizmeti Yönetim Konsolu'na giriş yapın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.
Kümenizin adına tıklayın. Sol gezinme bölmesinde Applications > Helm seçeneğini belirleyin.
Helm sayfasında Create düğmesine tıklayın. Basic Information yapılandırmasını tamamlayın, ack-alibaba-cloud-metrics-adapter seçeneğini işaretleyin ve Next düğmesine tıklayın.
Parameter Settings sayfasında bir Chart Version seçin ve OK düğmesine tıklayın.
Adım 3: Ingress oluşturun
Küme yönetim sayfasının sol gezinme bölmesinde Network > Ingress seçeneğini belirleyin. Ingress sayfasında Create Ingress düğmesine tıklayın.
Gerekli alanları doldurun ve OK düğmesine tıklayın. Konsol sizi Ingress sayfasına yönlendirir.
Name sütununda yönlendirme kurallarını görüntülemek için Ingress adına tıklayın. Ayrıntılar için Manage Ingress konusuna bakın.
Adım 4: HPA yapılandırın
HPA, farklı ölçeklendirme anlamlarına sahip iki SLS Ingress ölçümünü destekler:
| Ölçüm | Hedef türü | Ölçeklendirme davranışı |
|---|---|---|
sls_ingress_qps |
AverageValue |
QPS, karşılaştırmadan önce mevcut pod sayısına bölünür |
sls_ingress_latency_p9999 |
Value |
Ham gecikme değeri doğrudan karşılaştırılır |
-
Aşağıdaki içeriğe sahip
ingress-hpa.yamldosyasını oluşturun:Parametre Zorunlu Açıklama sls.ingress.routeEvet Biçim: <namespace>-<svc>-<port>. Örnek:default-nginx-80sls.logstoreEvet Basit Günlük Hizmetindeki Logstore. Varsayılan: nginx-ingresssls.projectEvet Basit Günlük Hizmetindeki Project. Varsayılan: k8s-log-<cluster-id>sls.internal.endpointHayır SLS'e dahili ağ üzerinden erişilip erişilmeyeceği. Varsayılan: true. Genel ağı kullanmak içinfalseolarak ayarlayın.apiVersion: autoscaling/v2 kind: HorizontalPodAutoscaler metadata: name: ingress-hpa spec: scaleTargetRef: apiVersion: apps/v1 kind: Deployment name: nginx-deployment-basic minReplicas: 2 maxReplicas: 10 metrics: - type: External external: metric: name: sls_ingress_qps selector: matchLabels: sls.project: "<your-sls-project>" # Default: k8s-log-<cluster-id> sls.logstore: "nginx-ingress" # Default SLS Logstore for Nginx Ingress logs sls.ingress.route: "default-nginx-80" # Format: <namespace>-<svc>-<port> target: type: AverageValue averageValue: 10 # Scale up when average QPS per pod exceeds 10 - type: External external: metric: name: sls_ingress_latency_p9999 selector: matchLabels: sls.project: "<your-sls-project>" sls.logstore: "nginx-ingress" sls.ingress.route: "default-nginx-80" # sls.internal.endpoint: "true" # true = internal network (default); false = public network target: type: Value value: 10 # Scale up when 99.99th-percentile latency exceeds 10 msAşağıdaki tabloda HPA yapılandırmasında kullanılan parametreler açıklanmaktadır.
-
Yapılandırmayı uygulayın:
kubectl apply -f ingress-hpa.yaml
Ölçeklendirmeyi doğrulayın
Ölçek büyütme işlemini tetiklemek için Ingress alan adınıza karşı 5 dakikalık bir yük testi çalıştırın:
# Send 10 concurrent requests for 300 seconds
ab -t 300 -c 10 <domain-name-configured-for-the-ingress>
HPA durumunu gerçek zamanlı olarak izleyin:
kubectl get hpa ingress-hpa --watch
Ölçek büyütme başarılı olduğunda beklenen çıktı (REPLICAS MAXPODS değerine ulaşır):
NAME REFERENCE TARGETS MINPODS MAXPODS REPLICAS AGE
ingress-hpa Deployment/nginx-deployment-basic 21/10 (avg) 2 10 10 7m49s
Trafik eşik değerin altına düştüğünde REPLICAS minimum değere geri döner.
Sorun giderme
Sorun gidermeye kubectl describe hpa ingress-hpa komutunu çalıştırarak ve Conditions alanını kontrol ederek başlayın. Sorunu belirlemek için Type ve Status sütunlarını kullanın, ardından aşağıdaki adımları izleyin.
target sütunu unknown gösteriyor
-
kubectl describe hpa <hpa-name>komutunu çalıştırın veConditionsalanını kontrol edin:AbleToScaledeğeriFalseise: Dağıtımın sağlıklı olduğundan emin olun.ScalingActivedeğeriFalseise: Sonraki adıma geçin.
-
External Metrics API'nin kullanılabilir olup olmadığını kontrol etmek için aşağıdaki komutu çalıştırın:
kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/"Yanıt
Error from server (NotFound)şeklindeysealibaba-cloud-metrics-adapterbaşlatma durumunu kontrol edin. Bağdaştırıcı normal çalışıyorsa ve HPA ölçümleri Ingress ile ilgiliyse önce SLS bileşenini dağıtın. Ayrıntılar için Collect and analyze Nginx Ingress access logs konusuna bakın. -
sls.ingress.routebiçimini doğrulayın. Değer<namespace>-<svc>-<port>biçiminde olmalıdır; burada:namespace: Ingress'in bulunduğu ad alanısvc: Ingress ile ilişkili hizmet adıport: İlgili hizmetin bağlantı noktası adı
ack-alibaba-cloud-metrics-adapter görüntüsü çekilemedi (sürüm 1.3.7)
1.3.7 sürümüne yükseltirken şu hatayı görebilirsiniz:
Failed to pull image "registry-<region-id>-vpc.ack.aliyuncs.com/acs/alibaba-cloud-metrics-adapter-amd64:v0.2.9-ba634de-aliyun".
Bu durum, bileşenin doğrudan güncellemeleri desteklememesinden kaynaklanır. Çözüm için:
Mevcut bileşen yapılandırmasını yedekleyin.
Eski sürümü kaldırın.
Yedeklenen yapılandırmayı kullanarak en son sürümü yükleyin.
SSS
Komut satırından sls_ingress_qps nasıl sorgulanır?
kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/namespaces/*/sls_ingress_qps?labelSelector=sls.project={{SLS_Project}},sls.logstore=nginx-ingress"
{{SLS_Project}} ifadesini kendi SLS Project adınızla değiştirin. Küme oluştururken özel bir ad belirlemediyseniz varsayılan ad k8s-log-{{ClusterId}} şeklindedir.
Başarılı bir yanıt, geçerli QPS değerini value alanında içeren bir ExternalMetricValueList döndürür. ParameterInvalid hatası alırsanız ölçümde veri yok demektir; bu genellikle ALB Ingress yapılandırılmamışken sls_alb_ingress_qps yerine sls_ingress_qps sorgulandığında görülür.
HPA hangi ölçümleri destekler?
Tam liste için Alibaba Cloud HPA Metrics adresine bakın. Yaygın SLS Ingress ölçümleri şunlardır:
| Ölçüm | Açıklama | Zorunlu parametre |
|---|---|---|
sls_ingress_qps |
Belirtilen Ingress rotası için QPS | sls.ingress.route |
sls_alb_ingress_qps |
ALB Ingress rotası için QPS | sls.ingress.route |
sls_ingress_latency_avg |
Tüm istekler için ortalama gecikme süresi | sls.ingress.route |
sls_ingress_latency_p50 |
50. yüzdelikteki gecikme süresi | sls.ingress.route |
sls_ingress_latency_p95 |
95. yüzdelikteki gecikme süresi | sls.ingress.route |
sls_ingress_latency_p99 |
99. yüzdelikteki gecikme süresi | sls.ingress.route |
sls_ingress_latency_p9999 |
99,99. yüzdelikteki gecikme süresi | sls.ingress.route |
sls_ingress_inflow |
Ingress için gelen bant genişliği | sls.ingress.route |
Nginx Ingress günlük biçimini özelleştirdikten sonra HPA'yı nasıl adapte ederim?
SLS günlük toplama, SLS ilk kez etkinleştirildiğinde dağıtılan AliyunLogConfig özel kaynak tanımına (CRD) dayanır. Bu CRD, varsayılan ACK Ingress Denetleyicisi günlük biçimine göre ayarlanmıştır. Ingress Denetleyicisinin erişim günlük biçimini değiştirdiyseniz CRD yapılandırmasındaki processor_regex bölümünü özel biçiminize uyacak şekilde güncelleyin. Ayrıntılar için Collect container logs using a DaemonSet and a CRD konusuna bakın.
Küme oluştururken SLS devre dışı bırakıldıysa ve HPA için Ingress ölçümlerine ihtiyacınız varsa önce SLS'i yeniden etkinleştirin veya yapılandırın. Ayrıntılar için Collect and analyze Nginx Ingress access logs konusuna bakın.