Azure API Management örneği kapasitesi

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Temel | Temel v2 | Standart | Standart v2 | Premium | Premium v2

API Management, sistem kapasitesinin kullanımını algılamak için Azure İzleyici ölçümleri sunarak ağ geçidi sorunlarını gidermenize ve api Management örneğini daha fazla yüke uygun olacak şekilde ölçeklendirme veya yükseltme konusunda bilinçli kararlar vermenize yardımcı olur.

Bu makalede kapasite ölçümleri ve bunların nasıl davrandıkları açıklanır, Azure portalında kapasite ölçümlerine nasıl erişilmesi gerektiği gösterilir ve API Management örneğinizi ölçeklendirmeyi veya yükseltmeyi ne zaman göz önünde bulundurmanız gerektiğini önerir.

Önemli

Bu makalede, Azure API Management örneğinizi kapasite ölçümlerine göre izleme ve ölçeklendirme adımları anlatılır. Ancak, bir örnek kapasitesine ulaştığında, aşırı yüklenmeyi önlemek için kısıtlama yapmaz. Bunun yerine aşırı yüklenmiş bir web sunucusu gibi davranır: artan gecikme süresi, bırakılan bağlantılar ve zaman aşımı hataları. API istemcileri, bu sorunları, örneğin yeniden deneme ilkelerini kullanarak diğer dış hizmetlerde olduğu gibi işlemeye hazır olmalıdır.

İpucu

API ekipleri bu özelliği çalışma alanlarında kullanabilir. Çalışma alanları, API'lere ve kendi API çalışma zamanı ortamlarına yalıtılmış yönetim erişimi sağlar.

Önkoşullar

Bu makaledeki adımları izlemek için kapasite ölçümlerini destekleyen katmanlardan birinde bir API Management örneğiniz olmalıdır. Daha fazla bilgi için Azure API Management örneği oluşturma kısmına bakın.

Kullanılabilir kapasite ölçümleri

v2 hizmet katmanlarında, klasik katmanlarda ve çalışma alanı ağ geçitlerinde farklı kapasite ölçümleri kullanılabilir.

v2 katmanları

v2 katmanlarında aşağıdaki ölçümler kullanılabilir:

• Ağ Geçidinin CPU Yüzdesi - Ağ geçidi birimleri tarafından kullanılan CPU kapasitesinin yüzdesi.

• Ağ Geçidinin Bellek Yüzdesi - Ağ geçidi birimleri tarafından kullanılan bellek kapasitesinin yüzdesi.

Bu ölçümler için kullanılabilir toplamalar aşağıdaki gibidir.

• Ortalama : API Management örneğinin her biriminde ağ geçidi işlemleri arasında kullanılan kapasitenin ortalama yüzdesi.
• Maksimum - Ağ geçidi işleminde en yüksek tüketime sahip kapasite yüzdesi.

CPU ve bellek kullanımı şunlara göre kaynakların tüketimini gösterir:

• API Management veri katmanı hizmetleri, istek iletme veya ilke çalıştırmayı içerebilen istek işleme gibi işlemleri kapsar.
• Azure portalı veya Azure Resource Manager aracılığıyla uygulanan yönetim eylemleri veya geliştirici portalından gelen yük gibi API Management yönetim düzlemi hizmetleri.
• Yeni bağlantılarda TLS el sıkışmalarının maliyetini içeren işlemler dahil olmak üzere seçili işletim sistemi işlemleri.
• Örneğin, temel işlem kaynaklarındaki işletim sistemi güncelleştirmeleri gibi platform güncelleştirmeleri.
• Etkinliğinden bağımsız olarak dağıtılan ve ek kapasite tüketebilen API sayısı.

Klasik katmanlar

Geliştirici, Temel, Standart ve Premium katmanlarında Kapasite ölçümü, bir API Management örneğini ölçeklendirme veya yükseltme hakkında kararlar almak için kullanılabilir. Yapısı karmaşıktır ve belirli davranışları dayatmaktadır.

Önemli

Mayıs 2025 hizmet güncelleştirmelerinin bir parçası olarak, doğruluğu ve tutarlılığı geliştirmek amacıyla kapasite ölçümü için hesaplama mantığını geliştirdik. Hizmetiniz bu güncelleştirmeyi aldıktan sonra bildirilen kapasite değerlerinin daha yüksek olduğunu fark edebilirsiniz. Bunun nedeni yalnızca geliştirilmiş ölçüm mantığıdır. Hizmetinizin gerçek performansı ve aktarım hızı etkilenmez. En iyi kaynak yönetimini sağlamak için ölçeklendirme eşiklerinizi yeniden ziyaret etmeniz ve ayarlamanız gerekebilir. Ölçeklendirme için kapasite ölçümünü kullanma yönergeleri için bu belgenin devamında bahsedilen ölçeklendirme kararları için kapasiteyi kullanma konusuna bakın.

Bu ölçüm için kullanılabilir toplamalar aşağıdaki gibidir.

• Ortalama : API Management örneğinin her biriminde ağ geçidi işlemleri arasında kullanılan kapasitenin ortalama yüzdesi.
• Maksimum - Ağ geçidi işleminde en yüksek tüketime sahip kapasite yüzdesi.

Önemli

Kapasite ölçümünün Maksimum toplaması yalnızca API Management'ın Premium katmanında desteklenir. Bu toplama yalnızca bilgilendirme amaçlıdır ve kararları ölçeklendirmek veya uyarı vermek için kullanılmamalıdır. Maksimum kapasitede kısa süreli ani artışlar beklenir ve genellikle endişeye neden olmaz. Ancak bu ani artışlar ardışık 15 dakika veya daha uzun süre devam ederse, daha fazla araştırma yapılması gerekebilir. Daha fazla bilgi için bu belgenin devamında bahsedilen ölçeklendirme kararları için kapasiteyi kullanma konusuna bakın.

Kapasite metriğinin ifade ettikleri

Kapasite, API Management örneğindeki yükün göstergesidir. Kaynakların (CPU, bellek) ve ağ kuyruğu uzunluklarının kullanımını yansıtır.

CPU ve bellek kullanımı şunlara göre kaynakların tüketimini gösterir:

• API Management veri katmanı hizmetleri, istek iletme veya ilke çalıştırmayı içerebilen istek işleme gibi işlemleri kapsar.
• Azure portalı veya Azure Resource Manager aracılığıyla uygulanan yönetim eylemleri veya geliştirici portalından gelen yük gibi API Management yönetim düzlemi hizmetleri.
• Yeni bağlantılarda TLS el sıkışmalarının maliyetini içeren işlemler dahil olmak üzere seçili işletim sistemi işlemleri.
• Örneğin, temel işlem kaynaklarındaki işletim sistemi güncelleştirmeleri gibi platform güncelleştirmeleri.
• Etkinliğinden bağımsız olarak dağıtılan ve ek kapasite tüketebilen API sayısı.

Çalışma alanı ağ geçitleri

Çalışma alanı ağ geçidinde aşağıdaki ölçümler kullanılabilir:

• CPU Kullanımı (%) - Ağ geçidi birimleri tarafından kullanılan CPU kapasitesinin yüzdesi.

• Bellek Kullanımı (%) - Ağ geçidi birimleri tarafından kullanılan bellek kapasitesinin yüzdesi.

Bu ölçümler için kullanılabilir toplamalar aşağıdaki gibidir.

• Ortalama : Çalışma alanı ağ geçidinin her biriminde ağ geçidi işlemleri arasında kullanılan kapasitenin ortalama yüzdesi.
• Maksimum - Ağ geçidi işleminde en yüksek tüketime sahip kapasite yüzdesi.

CPU ve bellek kullanımı şunlara göre kaynakların tüketimini gösterir:

• API Management veri katmanı hizmetleri, istek iletme veya ilke çalıştırmayı içerebilen istek işleme gibi işlemleri kapsar.
• Azure portalı veya Azure Resource Manager aracılığıyla uygulanan yönetim eylemleri veya geliştirici portalından gelen yük gibi API Management yönetim düzlemi hizmetleri.
• Yeni bağlantılarda TLS el sıkışmalarının maliyetini içeren işlemler dahil olmak üzere seçili işletim sistemi işlemleri.
• Örneğin, temel işlem kaynaklarındaki işletim sistemi güncelleştirmeleri gibi platform güncelleştirmeleri.
• Etkinliğinden bağımsız olarak dağıtılan ve ek kapasite tüketebilen API sayısı.

Kapasite ölçümü davranışı

Gerçek hayatta kapasite ölçümleri birçok değişkenden etkilenebilir, örneğin:

• bağlantı desenleri (istekte yeni bağlantı ve var olan bağlantıyı yeniden kullanma)
• istek ve yanıtın boyutu
• her API'de veya istek gönderen istemci sayısında yapılandırılan ilkeler.

İstekler üzerinde ne kadar karmaşık işlemler olursa kapasite tüketimi de o kadar yüksek olur. Örneğin, karmaşık dönüştürme ilkeleri basit bir istek iletme işleminden çok daha fazla CPU kullanır. Yavaş arka uç hizmeti yanıtları da bunu artırır.

Önemli

Kapasite ölçümleri, işlenen istek sayısının doğrudan ölçüleri değildir.

Kapasite ölçümleri de aralıklı olarak ani artışa neden olabilir veya hiçbir istek işlenmese bile sıfırdan büyük olabilir. Bunun nedeni sisteme veya platforma özgü eylemlerdir ve örneğin ölçeklendirilip ölçeklendirilmeyeceğine karar verilirken dikkate alınmamalıdır.

Kapasite ölçümleri API Management örneğinizle (veya çalışma alanı ağ geçidinizle) ilgili sorunları ortaya çıkaracak şekilde tasarlanmış olsa da, sorunların bu ölçümlerdeki değişikliklere yansıtılmayacağı durumlar vardır. Ayrıca, düşük kapasite ölçümleri API Management örneğinizde herhangi bir sorun olmadığı anlamına gelmez.

Kapasite ölçümlerini incelemek için Azure portalını kullanma

Zaman içinde ne kadar kapasite kullanıldığını anlamak için portaldaki ölçümlere erişin.

v2 katmanları

1. Azure portalında API Management örneğine gidin.
2. Soldaki menüde İzleme'nin altında Ölçümler'i seçin.
3. Kullanılabilir ölçümlerden Ağ Geçidinin CPU Yüzdesi veya Ağ Geçidinin Bellek Yüzdesi ölçümünü seçin. En yüksek kullanımı görmek için varsayılan Ortalama toplamayı seçin veya Maksimum toplama'yı seçin.
4. Bölümün üst çubuğundan istediğiniz zaman çerçevesini seçin.

Önemli

Şu anda Kapasite ölçümü, v2 katmanlarındaki örnekler için portalda da görünür. Ancak, v2 katmanlarında kullanılması desteklenmez ve 0 değerini gösterir.

Not

Beklenmeyen bir şey olduğunda size haber vermek için bir ölçüm uyarısı ayarlayabilirsiniz. Örneğin, API Management örneğiniz beklenen en yüksek CPU veya Bellek kullanımını 20 dakikadan fazla aştığında bildirim alın.

Klasik katmanlar

1. Azure portalında API Management örneğine gidin.

2. Soldaki menüde İzleme'nin altında Ölçümler'i seçin.

3. Kullanılabilir ölçümlerden Kapasite ölçümünü seçin ve varsayılan Ortalama toplamayı bırakın.

   İpucu

   Örneğinizi birden çok konuma dağıttıysanız, yanlış yorumlardan kaçınmak için her zaman konum başına kapasite ölçümü dökümüne bakmanız gerekir.

4. Ölçümü konuma göre bölmek için, üstteki Bölmeyi uygula seçeneğine ve ardından Konum seçeneğine tıklayın.

5. Bölümün üst çubuğundan istediğiniz zaman çerçevesini seçin.

Önemli

Şu anda portalda klasik katmanlardaki örnekler için Ağ Geçidinin CPU Yüzdesi ve Ağ Geçidi ölçümlerinin Bellek Tüketimi de gösterilir. Ancak bunlar klasik katmanlarda kullanılmak üzere desteklenmez ve 0 değerini gösterir.

Not

• Beklenmeyen bir şey olduğunda size haber vermek için bir ölçüm uyarısı ayarlayabilirsiniz. Örneğin, API Management örneğiniz beklenen en yüksek kapasiteyi 20 dakikadan fazla aştığında bildirimler alın.
• Bir Azure API Management birimini otomatik olarak eklemek için Azure İzleyici otomatik ölçeklendirmesini kullanabilirsiniz. Ölçeklendirme işlemi yaklaşık 30 dakika sürebilir, bu nedenle kurallarınızı uygun şekilde planlamanız gerekir.
• Çok bölgeli dağıtımlarda yalnızca birincil konumu ölçeklendirmeye izin verilir.

Çalışma alanı ağ geçitleri

1. Azure portalında API Management örneğine gidin.
2. Soldaki menüde, API'ler'in altında, izlemek istediğiniz ağ geçidiyle ilişkilendirilmiş çalışma alanı > alanları'nı seçin.
3. Soldaki menüde, Dağıtım + altyapı altında, izlemek istediğiniz çalışma alanı ağ geçidini ağ geçitleri'ni> seçin.
4. Soldaki menüde İzleme'nin altında Ölçümler'i seçin.
5. Kullanılabilir ölçümlerden CPU Kullanımı (%) veya Bellek Kullanımı (%) ölçümünü seçin. En yüksek kullanımı görmek için varsayılan Ortalama toplamayı seçin veya Maksimum toplama'yı seçin.
6. Bölümün üst çubuğundan istediğiniz zaman çerçevesini seçin.

Not

Beklenmeyen bir şey olduğunda size haber vermek için bir ölçüm uyarısı ayarlayabilirsiniz. Örneğin, çalışma alanı ağ geçidiniz beklenen en yüksek CPU veya Bellek kullanımını 20 dakikadan fazla aştığında bildirim alın.

Ölçeklendirme kararları için kapasite kullanma

Bir API Management örneğinin (veya çalışma alanı ağ geçidinin) daha fazla yüke uyum sağlamak için ölçeklendirilip ölçeklendirilmeyeceği konusunda karar vermek için kapasite ölçümlerini kullanın. Genel olarak dikkat edilmesi gerekenler şunlardır:

• Uzun vadeli eğilime ve ortalamaya bakın.
• Büyük olasılıkla yük artışından kaynaklanmayan ani artışları yoksayın (açıklama için Kapasite metriği davranışı bölümüne bakın).
• Genel bir kural olarak, kapasite ölçüm değeri uzun bir süre boyunca %60 - %70'i aştığında örneğinizi yükseltin veya ölçeklendirin (örneğin, 30 dakika). Hizmetiniz veya senaryonuz için farklı değerler daha iyi çalışabilir.
• Örneğiniz veya çalışma alanı ağ geçidiniz yalnızca 1 birimle yapılandırılmışsa, kapasite ölçüm değeri uzun bir süre için 40% aştığında ağ geçidini yükseltin veya ölçeklendirin. Bu öneri, temel alınan hizmet platformundaki konuk işletim sistemi güncelleştirmeleri için kapasite ayırma gereksinimini temel alır.
• API çağrılarının yanıt sürelerini izlemek için kullanılabilir tanılama araçlarını kullanın. Artan kapasite ölçümü değeriyle yanıt sürelerinin azalmış olduğunu fark ederseniz ölçeklendirme eşiklerini ayarlamayı göz önünde bulundurun.

İpucu

Trafiğinizi önceden tahmin edebiliyorsanız API Management örneğinizi veya çalışma alanı ağ geçidinizi beklediğiniz iş yüklerinde test edin. İstek yükünü aşamalı olarak artırabilir ve en yüksek yüke karşılık gelen kapasite ölçümünün değerini izleyebilirsiniz. Herhangi bir zamanda ne kadar kapasite kullanıldığını anlamak için Azure portalını kullanmak için önceki bölümde verilen adımları izleyin.

Önemli

Otomatik ölçeklendirme kurallarını tanımlarken, ölçeği küçültme/büyütme döngüsüne neden olacak otomatik ölçeklendirmenin dalgalanmasını önlemeye dikkat edin. Daha fazla bilgi edinmek için Azure İzleyici Otomatik Ölçeklendirme'nin dalgalanma üzerine kılavuzunu okumanızı öneririz.

İlgili içerik

• Azure API Management hizmet örneğini yükseltme ve ölçeklendirme
• Bir Azure API Management örneğini otomatik olarak ölçeklendirme
• API Management maliyetlerini planlama ve yönetme