Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
API'lerinizle ilgili 5xx sorunlarını nasıl gidereceğinizi gösteren örnek bir senaryoyu adım adım inceleyin.
| # | Adım | Açıklama |
|---|---|---|
| 1 | Son API trafiğini izleme | Son bir saat içinde trafiği olan tüm API proxy'leri ve hedefleri için son API izleme verilerini görüntüleyin. Yüksek hata yüzdesi oranına sahip API proxy'leri veya hedefleri hakkında ayrıntılı bilgi edinin. |
| 2 | API izleme verilerinizdeki trendleri belirleme | Daha geniş bir bakış açısı kazanmak için API izleme verilerinizin son 3 aya kadar olan geçmiş görünümüne erişin. |
| 3 | 5xx sorunlarını inceleme | 5xx sorunlarının kaynağını daha ayrıntılı bir şekilde incelemek için zaman içinde en yüksek göreceli hacimlere sahip hata kodlarını görüntüleyin. (Genellikle 5xx durum kodları bir veya daha fazla hata kodu kullanılarak sınıflandırılabilir.) |
| 4 | 5xx uyarısı ayarlama | 5xx durum kodlarının sayısı belirli bir eşiği aştığında bildirim almak için uyarı ayarlayın. |
| 5 | Müşteri ayrıntılarını içeren özel bir rapor oluşturun (İsteğe bağlı) | İsteğe bağlı olarak, 5xx hatalarını tetikleyen istemciyle ilgili ayrıntıları belirlemek için özel bir rapor oluşturun. Not: Özel rapor oluşturmak için kuruluş yöneticisi olmanız gerekir. |
| 6 | API proxy'lerini koleksiyonda gruplandırma | API proxy'lerini gruplandırmak için bir koleksiyon oluşturun ve sorunları daha hızlı teşhis etmek amacıyla grubun tüm üyeleri için uygun uyarı eşiği değerlerini ayarlayın.
|
| 7 | 5xx sorunlarını çözme | İncelemeniz ve teşhisinize göre 5xx sorunlarını çözmek için uygun işlemleri yapın. |
1. adım: Son API trafiğini izleyin
Son bir saat içinde trafik alan API proxy'leri ve hedefleri için API izleme verilerini görüntülemek üzere:
- Son kontrol paneline erişmek için Edge kullanıcı arayüzünde Analyze > API Monitoring > Recent (Analiz > API İzleme > Son) seçeneğini belirleyin.
Son bir saat içinde hata yüzdesi yüksek olan API proxy'lerini ve hedefleri inceleyin.
başlıklı makaleyi inceleyin.
Sağ bölmede ayrıntıları görüntülemek için yüksek hata yüzdesi oranına sahip API proxy'sini veya hedefi tıklayın. Bu örnekte 5xx hatalarının yüksek yüzdesine dikkat edin.
Bu adım hakkında daha fazla bilgi için Son API trafiğini izleme başlıklı makaleyi inceleyin.
2. adım: API izleme verilerinizdeki trendleri belirleyin
Son üç aya kadar trafik alan API proxy'leri ve hedefleri için API izleme verilerinin geçmiş görünümüne erişmek üzere:
- Zaman Çizelgesi kontrol paneline erişmek için Son kontrol panelinin sağ bölmesinde
> Zaman Çizelgesi'nde görüntüle'yi seçin.
Alternatif olarak, Edge kullanıcı arayüzünde Analiz > API İzleme > Zaman Çizelgesi'ni tıklayabilirsiniz.
- API proxy'sinin veya hedefin zaman içindeki trendini görüntüleyin. Trendin son 7 gündür tutarlı olduğunu fark edin.
Bu adım hakkında daha fazla bilgi için API izleme verilerinizdeki trendleri belirleme başlıklı makaleyi inceleyin.
3. adım: 5xx sorunlarını araştırın
Apigee, sorunları teşhis etmenize yardımcı olacak bir dizi hata kodu sağlar. Genellikle 5xx durum kodları bir veya daha fazla hata kodu kullanılarak sınıflandırılabilir.
5xx sorunlarını incelemek için:
- İnceleme kontrol paneline erişmek için Zaman Çizelgesi kontrol panelinin sağ bölmesinde > İnceleme'de görüntüle'yi seçin.
Alternatif olarak, Edge kullanıcı arayüzünde Analyze > API Monitoring > Investigate (Analiz et > API İzleme > İncele) seçeneğini tıklayabilirsiniz.
Araştırma kontrol paneli, hata kodu ile zaman gibi metrikler arasındaki ilişkisel etkinliği karşılaştırmanıza olanak tanır. Son bir saatteki hata kodu etkinliğini görüntülemek için hata kodu ve zaman matrisini inceleyin. Bir bloğun renk tonuna göre en yüksek göreceli hacimlere sahip hata kodlarına dikkat edin. Blok ne kadar koyu olursa göreceli hacim de o kadar yüksek olur.
Örneğin,
policies.ratelimit.SpikeArrestViolationvepolicies.ratelimit.QuotaViolationhata kodları aşağıdaki matriste daha yüksek bir göreceli hacim göstermektedir:
Sağ bölmede daha fazla ayrıntı görüntülemek için
policies.ratelimit.SpikeArrestViolationsatırındaki en koyu bloğu (ilk blok) tıklayın.
Hata kaynağının perfBenchmark_invalid_v1 API proxy'si ve HTTP durum kodunun 500 olduğunu unutmayın. 500 durum kodu, ani artış engelleme politikası ihlallerinde sık karşılaşılan bir çalışma zamanı hata kodudur.
En yüksek hata oranlarına sahip geliştirici uygulamalarını belirlemek için Şüpheli neden panelinin hemen altındaki Geliştirici Uygulamasına Göre Dağıtım bölümünü inceleyin.
Bu adım hakkında daha fazla bilgi için Sorunları belirleme başlıklı makaleyi inceleyin.
4. adım: 5xx uyarısını ayarlayın
5xx durum kodlarının sayısı belirli bir eşiği aştığında bildirim almak için Ayrıntıları incele bölmesinde seçilen bağlama göre bir uyarı ayarlayın.
İnceleme kontrol panelinin sağ bölmesinde
> Uyarı Oluştur'u seçin.
Uyarı iletişim kutusundaki alanları doldurun. Koşul alanları, mevcut bağlamdaki verilerle önceden doldurulur. Örneğin:
Kaydet'i tıklayın.
Gelecekte, perfBenchmark_invalid_v1 API proxy'sinde 5xx hata oranı 5 dakika boyunca% 5'i aşarsa belirtilen e-posta adresine bildirim gönderilir ve kullanıcı arayüzünde görsel uyarı gösterilir. Örneğin:
Bu adım hakkında daha fazla bilgi için Uyarıları ve bildirimleri ayarlama başlıklı makaleyi inceleyin.
5. adım: Müşteri ayrıntılarını içeren özel bir rapor oluşturun (isteğe bağlı)
İsteğe bağlı olarak, 5xx hatalarını tetikleyen istemci hakkında daha fazla ayrıntı belirlemek için özel bir rapor oluşturun.
Raporlar sayfasında, bir uyarıya göre oluşturulan özel raporlar API Monitoring Generated: alert-name biçiminde adlandırılır.
Uyarı ayarlanırken oluşturulan özel rapora aşağıdaki yöntemlerden biriyle erişin:
Raporlar sayfasını görüntülemek için sol gezinme çubuğunda Analiz > Özel Raporlar > Raporlar'ı seçin. Listede raporun adını tıklayın: API Monitoring Generated: 5xx Alert
Uyarı oluşturulduğunda gösterilen bildirimi tıklayın. Örneğin:
Aşağıdaki boyutları ekleyin:
- Geliştirici Uygulaması
- Müşteri Kimliği
- İstemci IP adresi
Hata oranı yüksek olan belirli bir geliştirici uygulamasına dayalı bir raporu görüntülemek için aşağıdakine benzer bir filtre ekleyin:
and (developer_app eq 'perfBenchmarkApp0')Not: Bu durumda, Geliştirici Uygulaması'nı boyutlar listesinden kaldırın.
Kaydet'i tıklayın.
5xx durum kodunu tetikleyen geliştirici uygulaması ve istemcilerle ilgili ayrıntıları görüntülemek için raporu çalıştırın.
Bu adım hakkında daha fazla bilgi için Özel raporlar oluşturma başlıklı makaleyi inceleyin.
6. adım: API proxy'lerini bir koleksiyonda gruplandırın
API proxy'lerini gruplandırmak için bir koleksiyon oluşturun ve sorunları daha hızlı teşhis etmek amacıyla grubun tüm üyeleri için uygun uyarı eşiği değerlerini ayarlayın.
- Koleksiyonlar kontrol panelini görüntülemek için Edge kullanıcı arayüzünde Analyze > API Monitoring > Collections'ı (Analiz > API İzleme > Koleksiyonlar) seçin.
- + Koleksiyon'u tıklayın.
- Proxy'yi seçin.
- Ortam açılır listesinden prod'u seçin.
- İleri'yi tıklayın.
- Toplama iletişim kutusundaki alanları doldurun.
- Kaydet'i tıklayın
Ardından, 4. adıma benzer şekilde uyarı oluşturabilir ve boyutu yukarıda tanımladığınız koleksiyon olarak ayarlayabilirsiniz.
Bu adım hakkında daha fazla bilgi için Koleksiyonları yönetme başlıklı makaleyi inceleyin.
7. adım: 5xx sorunlarını çözün
5xx sorunlarını çözmek için uygun işlemleri yapın. Örneğin, teşhisinize bağlı olarak aşağıdaki görevlerden birini gerçekleştirebilirsiniz:
- İsteklerdeki artışın şüpheli olup olmadığını belirlemek ve özel raporda tanımlanan istemci IP adresini engellemek isteyip istemediğinize karar vermek için Apigee Sense'i kullanın.
- Geliştirici uygulamalarının belirli bir süre içinde API proxy'nize yapabileceği bağlantı sayısını sınırlamak için kota politikası ekleyin.
- Belirli bir çağrı sayısının üzerindeki kullanım için geliştiricilerden ücret almak üzere API'nizden para kazanın.