Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Bu bölümde, API İzleme ile Edge Analytics karşılaştırılmaktadır. Hem API Monitoring hem de Edge Analytics, API verilerini toplamanıza ve görüntülemenize olanak tanır ancak farklı amaçlara hizmet eder:
- API İzleme'nin amacı, API'lerinizin amaçlandığı şekilde çalışmasını sağlamaktır. Bu amaçla, mevcut en son verileri görmek istiyorsunuz. API Monitoring, anlık verilere çok yakın veriler sağlar ve bir sorun ortaya çıkması durumunda sizi bilgilendiren uyarılar oluşturmanıza olanak tanır.
- Edge Analytics'in amacı, API'lerinizin uzun vadeli davranışını anlamaktır. Böylece, API'lerinizin işletme gereksinimlerinizi desteklediğinden emin olabilir veya gerekirse değişiklik yapabilirsiniz. Bu amaçlar için gerçek zamanlı verileri görmek daha az önemlidir. Sonuç olarak, Analytics verileri genellikle en fazla 10 dakika olmak üzere biraz gecikmeli olarak gösterilir.
Çoğunlukla hata kodları ve gecikmeyle ilgili olan API izleme verilerinin, Analytics verilerinin küçük bir alt kümesi olduğunu unutmayın.
API İzleme verileri ile Analytics verileri arasındaki farklar
Bu bölümde, Edge Analytics ve API İzleme tarafından toplanan veriler arasındaki bazı küçük farklar açıklanmaktadır. API İzleme ve Analytics farklı veri işlem hatları kullandığından, İzleme tarafından oluşturulan özel raporlar ile Analytics tarafından oluşturulan raporlar arasında küçük farklılıklar görebilirsiniz. Örneğin, hem arka uç zaman aşımları (istekte HTTP durum kodu 504) hem de istemci zaman aşımları (HTTP durum kodu 499) için bildirilen sonuçlarda zaman aşımı hatalarıyla ilgili tutarsızlıklar görebilirsiniz. Bunlar, Analytics özel raporlarında 200 durum koduyla görünebilir ancak izleme özel raporlarında 504 veya 499 durum koduyla gösterilir.API Monitoring
API Monitoring, API performansı hakkında gerçek zamanlı analizler sunar ve API'lerinizin amaçlandığı gibi çalışmaya devam etmesi için sorunları hızlıca teşhis edip düzeltmenize yardımcı olur.
API Monitoring ile şunları yapabilirsiniz:
- API kullanılabilirliğini artırın ve ortalama teşhis süresini (MTTD) kısaltın.
- Tüketiciler etkilenmeden önce bağlamsal uyarılara göre uygun işlemleri yapın.
- Teşhisi hızlandırmak için Apigee hata kodlarından yararlanın.
- Hata, performans ve gecikme sorunlarını ve bunların kaynağını teşhis etmek için sorunlu alanları hızlıca belirleyin.
Edge API Analytics
Edge API Analytics, API'lerden geçen bilgileri toplar ve analiz eder. API Analytics aşağıdaki gibi bilgileri yakalar:
- API trafiğinizin zaman içindeki eğilimi
- En popüler uygulamalarınız hangileri?
- En iyi geliştiricileriniz kimler?
- En popüler API yöntemleri hangileri?
- API yanıt süresi ne zaman en hızlı/en yavaş olur?
- Coğrafi olarak en fazla API trafiğini nerede görüyorsunuz?
API Analytics tarafından toplanan veriler
API Analytics, API'ler arasında akan geniş bir veri yelpazesini toplar ve analiz eder. Örneğin, API'niz dağıtılırken Analytics sürekli olarak alınan mesajların sayısını, geliştirici sayısını, yanıt sürelerini, hataları, kullanılan uygulama sayısını, istek boyutunu ve diğer birçok veri parçasını kaydeder.
Metrikler ve bunları nasıl kullanabileceğiniz hakkında iyi bir giriş için API programı performansını ölçmek için metrik API'lerini kullanma başlıklı makaleyi inceleyin. Metriklerin tam listesi için Analytics metrikleri, boyutları ve filtreleri referansı başlıklı makaleyi inceleyin.
Özel metrikleri toplama
StatisticsCollector politikasını kullanarak özel metrikler de toplayabilirsiniz. StatisticsCollector politikası, analiz ve rapor oluşturma için istek başlıklarındaki, XML/JSON yüklerindeki, sorgu parametrelerindeki, URI'lerdeki ve diğer konumlardaki bilgileri Analytics sunucusuna yazabilir.
Analytics verilerine erişme
Oluşturulduktan sonra, kontrol paneli, özel raporlar ve GeoMap dahil olmak üzere API Analytics görselleştirme araçlarını kullanarak önceden tanımlanmış metriklere ve özel metriklere erişebilirsiniz. API Analytics'in sağladığı görselleştirme araçları hakkında daha fazla bilgi için Analytics kontrol panelleri başlıklı makaleyi inceleyin. Özel raporlar hakkında daha fazla bilgi için Özel raporlar oluşturma başlıklı makaleyi inceleyin.
API İzleme ve API Analizlerini Karşılaştırma
API geliştiriciler hem API İzleme hem de API Analizleri'ni kullanır. İkisi arasındaki temel farklardan biri, API İzleme'ye yerleştirilmiş uyarı mekanizmasıdır. Uyarılar, operasyon ekibinizin API'lerinizle ilgili sorunlara anında yanıt vermesini sağlayarak API'lerinizin kullanılabilir olmasını ve beklendiği gibi çalışmasını sağlar.
Uyarı koşulları, belirli durum kodu (2xx/4xx/5xx), gecikme ve hata kodu eşiklerini tanımlar. Bu eşikler aşıldığında kullanıcı arayüzünde görsel uyarılar tetiklenir ve e-posta, Slack, PagerDuty veya webhook'lar gibi çeşitli kanallar üzerinden bildirimler gönderilir. Uyarıları ortam, API proxy'si veya hedef hizmet ya da bölge düzeyinde ayarlayabilirsiniz.
Bir uyarı tetiklendikten sonra operasyon ekibiniz, sorunu araştırmak ve temel nedenini ayrıntılı olarak incelemek için API Monitoring kullanıcı arayüzünü kullanabilir. Daha sonra, uyarıyla ilgili önceden tanımlanmış bilgileri içeren bir özel rapor oluşturabilirsiniz. Örneğin:
- Toplam yanıt süresi
- Hedeflenen yanıt süresi
- Proxy hataları
- Hedef hataları
- İstek UUID'si
- ve daha birçok
API Analytics, çeşitli ekiplerin kullanması için çok çeşitli verileri yakalamak üzere tasarlanmıştır. Örneğin:
- Operasyon ekibi, değişen talepleri karşılamak için hizmetlerinizi ölçeklendirebilmek amacıyla yüksek veya düşük trafik dönemlerini belirlemek için Analytics verilerini kullanabilir.
- Pazarlama ekibi, tek tek API'ler, uygulamalar, müşteriler veya diğer veriler tarafından tanımlanan müşteri kullanım kalıplarını belirlemek için Analytics verilerini kullanabilir.
- Tüm ekipler, üstbilgi değerleri, sorgu parametreleri veya istek yükü gibi belirli bilgileri izlemek için bir istekten toplanan özel verilere erişebilir.