Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Scale pods based on Nginx Ingress metrics

Son Güncelleme:Oct 06, 2026

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.

Önemli

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.

  1. Konteyner Hizmeti Yönetim Konsolu'na giriş yapın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Kümenizin adına tıklayın. Sol gezinme bölmesinde Applications > Helm seçeneğini belirleyin.

  3. 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.

  4. Parameter Settings sayfasında bir Chart Version seçin ve OK düğmesine tıklayın.

Adım 2: Test uygulaması dağıtın

  1. Aşağıdaki içeriğe sahip nginx-test.yaml dosyasını oluşturun:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: nginx-deployment-basic
      labels:
        app: nginx
    spec:
      replicas: 2
      selector:
        matchLabels:
          app: nginx
      template:
        metadata:
          labels:
            app: nginx
        spec:
          containers:
          - name: nginx
            image: nginx:1.7.9
            ports:
            - containerPort: 80
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: nginx
      namespace: default
    spec:
      ports:
        - port: 80
          protocol: TCP
          targetPort: 80
      selector:
        app: nginx
      type: ClusterIP
  2. Yapılandırmayı uygulayın:

    kubectl apply -f nginx-test.yaml

Adım 3: Ingress oluşturun

  1. 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.

  2. Gerekli alanları doldurun ve OK düğmesine tıklayın. Konsol sizi Ingress sayfasına yönlendirir.

  3. 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
  1. Aşağıdaki içeriğe sahip ingress-hpa.yaml dosyasını oluşturun:

    Parametre Zorunlu Açıklama
    sls.ingress.route Evet Biçim: <namespace>-<svc>-<port>. Örnek: default-nginx-80
    sls.logstore Evet Basit Günlük Hizmetindeki Logstore. Varsayılan: nginx-ingress
    sls.project Evet Basit Günlük Hizmetindeki Project. Varsayılan: k8s-log-<cluster-id>
    sls.internal.endpoint Hayır SLS'e dahili ağ üzerinden erişilip erişilmeyeceği. Varsayılan: true. Genel ağı kullanmak için false olarak 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 ms

    Aşağıdaki tabloda HPA yapılandırmasında kullanılan parametreler açıklanmaktadır.

  2. 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

  1. kubectl describe hpa <hpa-name> komutunu çalıştırın ve Conditions alanını kontrol edin:

    • AbleToScale değeri False ise: Dağıtımın sağlıklı olduğundan emin olun.

    • ScalingActive değeri False ise: Sonraki adıma geçin.

  2. 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) şeklindeyse alibaba-cloud-metrics-adapter baş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.

  3. sls.ingress.route biç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:

  1. Mevcut bileşen yapılandırmasını yedekleyin.

  2. Eski sürümü kaldırın.

  3. 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.

Sonraki adımlar