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 inceleyin.
| # | Adım | Açıklama |
|---|---|---|
| 1 | Son API trafiğini izleme | Son bir saat içinde trafik almış tüm API proxy'leri ve hedefleri için güncel API izleme verilerini görüntüleyin. Yüksek hata yüzdesi oranına sahip API proxy'lerini veya hedefleri ayrıntılı olarak inceleyin. |
| 2 | API izleme verilerinizdeki trendleri belirleme | Daha geniş bir bakış açısı elde etmek için API izleme verilerinizin son 3 aya kadarki 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 araştırmak için, zaman içinde en yüksek göreceli hacim görülen hata kodlarını görüntüleyin. (5xx durum kodları genellikle bir veya daha fazla hata kodu kullanılarak sınıflandırılabilir.) |
| 4 | 5xx uyarısı oluşturma | 5xx durum kodu sayısı belirli bir eşiği aştığında bilgilendirilmek için bir uyarı ayarlayın. |
| 5 | Müşteri ayrıntılarını içeren özel rapor oluşturma (İsteğe bağlı) | İsteğe bağlı olarak, 5xx hatalarını tetikleyen istemciyle ilgili ayrıntıları tanımlamak için özel bir rapor oluşturun. Not: Özel rapor oluşturmak için kuruluş yöneticisi olmanız gerekir. |
| 6 | API proxy'lerini bir 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 | Araştırmanız ve teşhisinize göre, 5xx sorunlarını çözmek için gereken önlemleri alın. |
1. Adım: Son API trafiğini izleyin
Son bir saat içinde trafik alan API proxy'leri ve hedeflerin API izleme verilerini görüntülemek için:
- Son kontrol paneline erişmek için Edge kullanıcı arayüzünde Analiz > API İzleme > Son seçeneklerini belirleyin.
Son bir saat içinde yüksek hata yüzdesi oranına sahip API proxy'leri ve hedeflere dikkat edin.
Ayrıntıları sağ bölmede görüntülemek için hata yüzdesi yüksek olan API proxy'sini veya hedefi tıklayın. Bu örnekte 5xx hata oranının yüksek olduğuna dikkat edin.
Bu adım hakkında daha fazla bilgi için Son API trafiğini izleme başlıklı makaleye bakın.
2. Adım: API izleme verilerinizdeki trendleri belirleyin
Son üç aya kadar trafik almış 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öster'i seçin.
Alternatif olarak, Edge kullanıcı arayüzünde Analiz > API İzleme > Zaman Çizelgesi'ni de tıklayabilirsiniz.
- API proxy'si veya hedefin zaman içindeki trendini görüntüleyin. Trendin son 7 gündür tutarlı olduğuna dikkat edin.
Bu adım hakkında daha fazla bilgi için API izleme verilerinizdeki trendleri belirleme bölümüne bakın.
3. Adım: 5xx sorunlarını inceleyin
Apigee, sorunları teşhis etmenize yardımcı olan bir dizi hata kodu sağlar. 5xx durum kodları genellikle 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 > İncelemede görüntüle'yi seçin.
Alternatif olarak, Edge kullanıcı arayüzünde Analiz > API İzleme > İncele'yi de tıklayabilirsiniz.
Investigate kontrol paneli, metrikler arasındaki ilişkisel etkinlikleri (ör. hata kodu ve zaman) karşılaştırmanızı sağlar. Son bir saat içindeki hata kodu etkinliğini görüntülemek için hata kodu ile zaman matrisini görüntüleyin. Bir blokun renk gölgesine göre en yüksek bağıl hacimlere sahip olan hata kodlarına dikkat edin. Blok ne kadar koyuysa göreli hacim o kadar yüksektir.
Örneğin,
policies.ratelimit.SpikeArrestViolationvepolicies.ratelimit.QuotaViolationhata kodları aşağıdaki matriste daha yüksek bir bağıl 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 perfBenchmark_invalid_v1 olduğuna dikkat edin. 500 durum kodu, Spike Arrest politika ihlallerinde yaygın olarak kullanı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ğılım'ı görüntüleyin.
Bu adım hakkında daha fazla bilgi için Sorunları belirleme bölümüne bakın.
4. Adım: 5xx uyarısı ayarlayın
5xx durum kodu sayısı belirli bir eşiği aştığında bilgilendirilmek için Ayrıntıları inceleme bölmesinde seçili bağlama göre bir uyarı oluşturun.
İnceleme kontrol panelinin sağ bölmesinde
> Uyarı Oluştur'u seçin.
Uyarı iletişim kutusundaki alanları doldurun. Koşul alanları, mevcut bağlamdan alınan verilerle önceden doldurulur. Örneğin:
Kaydet'i tıklayın.
Gelecekte perfBenchmark_invalid_v1 API proxy'si için 5xx hata oranı 5 dakika boyunca% 5'i aştığında, belirtilen e-posta adresine bir perfBenchmark_invalid_v1 gönderilir ve kullanıcı arayüzünde bir perfBenchmark_invalid_v1 gösterilir. Örneğin:
Bu adım hakkında daha fazla bilgi için Uyarıları ve bildirimleri ayarlama başlıklı makaleye bakın.
5. Adım: 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 daha fazla ayrıntı tanımlamak için özel bir rapor oluşturabilirsiniz.
Raporlar sayfasında, bir uyarıya dayalı olarak oluşturulan özel raporlar şu biçim kullanılarak adlandırılır: API Monitoring Generated: alert-name.
Uyarıyı ayarlarken oluşturulan özel rapora aşağıdaki yöntemlerden birini kullanarak erişebilirsiniz:
Raporlar sayfasını görüntülemek için soldaki gezinme çubuğunda Analiz > Özel Raporlar > Raporlar'ı seçin. Listede raporun adını tıklayın: API İzleme Oluşturuldu: 5xx Uyarısı
Uyarı oluşturulduğunda görüntülenen bildirimin içini tıklayın. Örneğin:
Aşağıdaki boyutları ekleyin:
- Geliştirici Uygulaması
- İstemci Kimliği
- İstemci IP Adresi
Yüksek hata oranına sahip belirli bir geliştirici uygulamasını temel alan 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.
Geliştirici uygulaması ve 5xx durum kodunu tetikleyen 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 Analiz > API İzleme > Koleksiyonlar'ı seçin.
- + Koleksiyon'u tıklayın.
- Proxy'yi seçin.
- Ortam açılır menüsünden ürün'ü seçin.
- Sonraki'yi tıklayın.
- Koleksiyon iletişim kutusundaki alanları doldurun.
- Kaydet'i tıklayın
Ardından, 4. adıma benzer şekilde bir uyarı oluşturabilir ve boyutu yukarıda tanımladığınız koleksiyona 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ı gidermek için gereken işlemleri yapın. Örneğin, teşhisinize göre 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 istediğ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 bir kota politikası ekleyin.
- Geliştiricilerden belirli sayıda çağrı için kullanım ücreti almak üzere API'nizden para kazanın.