Sorunları araştırma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

İnceleme kontrol paneli, tüm API trafiği için metrik ve özelliklerin pivot tablolarını görüntülemenize ve sorunları daha hızlı inceleyip teşhis etmek için metrikler arasındaki ilişkisel etkinliği karşılaştırmanıza olanak tanır. Kontrol panelinde son 30 güne ait verilere erişebilirsiniz.

Edge kullanıcı arayüzünde Analyze > API Monitoring > Investigate'i (Analiz > API İzleme > İncele) seçerek İncele kontrol panelini açın. Kontrol panelinde iki ana alan bulunur:

• Durum Kodu, API proxy'leri ve hedef hizmetler için durum kodu metriklerini incelemenize olanak tanır.
• Gecikme, API proxy'leri ve hedef hizmetlerle ilgili gecikme sorunlarını araştırmanıza olanak tanır.

Ayrıca, İnceleme kontrol panelinde belirli bir uyarıdan kaynaklanan sorunları da inceleyebilirsiniz. Bir uyarı gerçekleştiğinde, Uyarı Geçmişi sayfasında uyarının adını tıklayarak İnceleme kontrol panelinde uyarıyı açın.

Sorunu teşhis etmek için İnceleme kontrol panelini kullanma

Örneğin, 5xx hata oranının belirtilen eşiği aştığını belirten bir uyarı alırsınız. Bu sorunu araştırmak için İnceleme kontrol panelinde aşağıdaki görevleri gerçekleştirebilirsiniz:

1. Son bir saatteki hata kodu etkinliğini görüntülemek için hata kodu ve zaman matrisini inceleyin.
2. Önceki adımda belirtildiği gibi, son bir saat içinde sayısı artan hata kodlarıyla ilişkili belirli HTTP durum kodlarını belirlemek için hata kodu ve HTTP durumu matrisine geçin.
3. Önceki adımda tanımlanan hata kodlarını tetikleyen API proxy'lerini belirlemek için hata kodu ve proxy karşılaştırması matrisine geçin.
4. Daha fazla ayrıntı görüntülemek ve günlükleri incelemek için matriste çok sayıda hata koduyla ilişkilendirilmiş bir API proxy'siyle ilişkili bir kutuyu tıklayın.
5. Sorunun teşhis edilmesine daha fazla yardımcı olmak için uyarı oluşturun ve özel rapor oluşturun.

6. Soruna çözüm bulmak için izleme ve diğer araçları kullanarak API proxy'sinde sorun giderme işlemlerine devam edin.

Durum kodu kontrol panelini kullanma

Durum Kodu kontrol paneli, kuruluşunuzdaki API proxy'leri ve hedef hizmetler için durum kodu metriklerini incelemenize olanak tanır. Son 30 gün içinde herhangi bir zamanda bir saatlik veya dört saatlik aralık için durum kodu metriklerini görüntüleyebilirsiniz.

Durum Kodu kontrol panelini keşfetme

Durum kodu kontrol panelini görüntülemek için Edge kullanıcı arayüzünde Analyze > API Monitoring > Investigate'i (Analiz > API İzleme > İncele) seçin. Durum Kodu kontrol paneli varsayılan olarak gösterilir:

Şekilde vurgulandığı gibi, İnceleme kontrol paneli sayesinde:

• Metrikler arasındaki ilişkisel etkinliği karşılaştırmak ve daha fazla analiz elde etmek için x eksenini ve y eksenini ayarlayarak her matrisi yapılandırın.
• Bir bloğun renk tonuna göre, göreli olarak en yüksek hacimlere sahip metrikleri hızlıca belirleyin. Blok ne kadar koyu olursa göreceli hacim de o kadar yüksek olur.
• Metrik ayrıntılarını görüntülemek için matriste bir bloğu tıklayın.
• Verileri aşağıdakilere göre filtreleyin:
  • Ortam
  • Bölge
  • Proxy
  • Durum kodları (tüm trafik, tüm hatalar, 2xx, 4xx veya 5xx dahil)
  • Son 30 gün içindeki tarih ve saat
  • 1 saatlik veya 4 saatlik zaman aralığı

Aşağıdaki görevleri hızlıca gerçekleştirmek için kontrol panelini kullanın:

• Metrik ayrıntıları panelinde erişim günlükleri.
• > Son Öğelerde Görüntüle veya Zaman Çizelgesi'nde Görüntüle'yi tıklayarak mevcut bağlamı Son veya Zaman Çizelgesi'nde ya da kontrol panelinde görüntüleyin.
• Özel rapor oluşturun ve simgesini tıklayarak ek boyutlar ekleyin.
• Uyarı oluşturun, ek uyarı koşulları ekleyin, bildirimleri ayarlayın ve uyarıya dayalı özel bir rapor oluşturun.

Durum kodu matrisini yapılandırma

Durum Kodu kontrol panelini seçtiğinizde varsayılan olarak aşağıdaki matrisler gösterilir:

• Hata kodu ve zaman
• Hata kodu ve HTTP durumu
• Hata kaynağı ve API proxy'si

X ve Y ekseni açılır listelerinden bir değer seçerek aşağıdaki metriklerden herhangi ikisini karşılaştırmak için her matrisi yapılandırın:

• Hata kodu
• Hata politikası
• Arıza kaynağı
• HTTP durumu
• Proxy
• Saat
• Bölge
• Hedef (Hedef hizmet veya ServiceCallout politikası). Hedef bir ServiceCallout politikası ise gösterilen değere sc:// öneki eklenir. Örneğin, sc://my.endpoint.net.)

Durum kodu metriği ayrıntılarını görüntüleme

Matriste ilgili bloğu tıklayarak belirli bir metriğin ayrıntılarını görüntüleyin.

Şüphelenilen nedene ilişkin ayrıntılar sağ bölmede gösterilir. Bu ayrıntılar arasında şunlar yer alır:

• Ortam
• Kurumsal
• Bölge
• Hata Kaynağı (proxy, hedef veya Apigee altyapısı)

Ayrıntılar arasında şunlar da bulunabilir:

• Hata Politikası: Politika türü (dahili ad) ve kullanıcı tanımlı politika adı da dahil olmak üzere, çalışma zamanı hatasını tetikleyen politika hakkında bilgiler. Adı, API proxy akışına politikayı eklerken tanımlarsınız.
• Proxy adı
• HTTP durum kodu
• Hata Kodu

Belirli bir metrik için kardinalite birden büyükse ayrıntılar panelinde hata dağıtımı ayrıntıları (ör. Geliştirici Uygulamasına Göre Dağıtım, Hata Politikasına Göre Dağıtım, Hata Koduna Göre Dağıtım, HTTP Durumuna Göre Dağıtım vb.) yer alabilir. Örneğin:

Hata kaynağı hedefse ayrıntılar panelinde Hedefe Göre Hata Oranı yer alır. Örneğin:

Gecikme kontrol panelini kullanma

Gecikme kontrol panelinde, kuruluşunuzdaki API proxy'leri ve hedef hizmetlerle ilgili gecikme bilgileri gösterilir. Son 30 gün içinde herhangi bir zamanda bir saatlik pencere için gecikme metriklerini inceleyebilirsiniz.

Gecikme kontrol panelini keşfetme

Gecikme kontrol panelini görüntülemek için Edge kullanıcı arayüzünde Analyze > API Monitoring > Investigate (Analiz > API İzleme > İncele) seçeneğini belirleyin. Durum Kodu kontrol paneli varsayılan olarak görüntülenir. Gecikme süresi kontrol panelini görüntülemek için filtre alanında Gecikme süresi'ni seçin:

Gecikme kontrol panelini seçtiğinizde varsayılan olarak aşağıdaki matrisler gösterilir:

• Proxy ve Süre (milisaniye cinsinden maksimum gecikme)
• Proxy'ye karşı toplam gecikme (milisaniye cinsinden maksimum gecikme)
• Proxy ile tüm hedefler arasındaki gecikme (milisaniye cinsinden maksimum gecikme)

Hedef gecikmeleri görüntülemek için Hedef'i seçmek üzere Proxy açılır kutusunu kullanın.

Gecikme kontrol panelinde varsayılan olarak, son bir saat içinde toplam P99 gecikmesi en yüksek olan 10 proxy'nin bilgileri gösterilir. Alternatif olarak, belirli bir proxy veya koleksiyon seçmek için En iyi 10 açılır kutusunu kullanın.

Gecikme kontrol panelinde, Durum Kodu kontrol panelinin tüm özellikleri bulunur. Ancak aşağıdaki farklılıklar vardır:

• Yalnızca toplam yanıt gecikmesi yüzdelik dilimini (p50, p90, p95, p99) yapılandırırsınız.
• Gecikme metrikleri için yalnızca bir saatlik bir aralık seçebilirsiniz.
• Filtrelerde Bölge için Tümü'nü seçemezsiniz. Görüntülemek için belirli bir bölge seçmeniz gerekir.

Gecikme metriği ayrıntılarını görüntüleme

Matriste ilgili bloğu tıklayarak belirli bir metriğin ayrıntılarını görüntüleyin.

Bir proxy'nin (mavi çizgi) ve hedefin (mor çizgi) gecikmesiyle ilgili ayrıntılar sağ bölmede gösterilir. Bu ayrıntılar arasında şunlar yer alır:

• Toplam gecikme (proxy gecikmesi artı hedef gecikmesi)
• Hedef başına gecikme (hedef yanıt süresi)
• HTTP durumuna göre dağıtım

Ayrıntılı bilgileri görüntülemek için grafiğin üzerine gelin:

Hedef başına gecikme grafiğinde, maksimum gecikmeye göre ilk 16 hedef gösterilir. Her hedef için bir grafik bulunur. Her hedefe karşılık gelen grafiği belirlemek için fareyle bir grafiğin üzerine gelin veya açılır listeyi seçin.

Metrik ayrıntılarından günlükleri görüntüleme

Durum kodları veya gecikme süresi için metrik ayrıntılarını görüntülerken seçilen metriğe ait tüm günlükleri görüntülemek için Günlükleri görüntüle'yi tıklayın:

Trafik Günlükleri iletişim kutusu açılır ve en fazla 1.000 günlük girişi gösterilir. Listede ayrıntılarını görmek için bir günlük girişini tıklayın:

Günlükleri şu ölçütlere göre daha da filtreleyebilirsiniz:

• Trafik kaynağı
• Hata türü
• Minimum yanıt süresi

Günlük verilerini Trafik Günlükleri iletişim kutusundan indiremezsiniz. Ancak kendi veri analizinizi yapmak için özel bir rapor oluşturabilir veya analiz verilerini Google Cloud Storage ya da BigQuery gibi kendi veri deponuza indirebilirsiniz.

İnceleme kontrol panelinden özel rapor oluşturma

Seçilen koşul grubuna göre özel bir rapor oluşturun. Özel rapor oluşturulduktan sonra, gerektiğinde metrik ve boyut eklemek veya silmek için raporu düzenleyebilirsiniz. Örneğin, araştırmanızı belirli bir erişim jetonu, geliştirici uygulaması veya API proxy'si ile sınırlandırmak isteyebilirsiniz. Daha fazla bilgi için Analytics metrikleri, boyutları ve filtreleri referansı başlıklı makaleyi inceleyin.

Daha fazla bilgi için Özel raporlar oluşturma başlıklı makaleyi inceleyin.

Özel rapor oluşturmak için:

1. Daha ayrıntılı bilgi görüntülemek için matriste bir bloğu tıklayın.

   

2. Sağ bölmede simgesini tıklayın.

   

   Özel rapor sayfası, ilgili alanlar önceden doldurulmuş şekilde yeni bir sekmede gösterilir.

   Not: Varsayılan özel rapor ayarları hakkında daha fazla bilgi için Özel rapor oluşturma başlıklı makaleyi inceleyin.

   

3. Özel raporu gerektiği gibi düzenleyin. Özel raporları yönetme başlıklı makaleyi inceleyin.

4. Özel raporu kaydetmek için Kaydet'i tıklayın.

Rapor, varsayılan olarak son bir saat içinde toplanan veriler kullanılarak çalıştırılır ve veriler özel rapor gösterge tablosunda gösterilir. Özel raporlar kontrol paneline göz atma başlıklı makaleyi inceleyin.

Raporlar sayfasında, API İzleme kullanılarak oluşturulan özel raporlar şu biçimde adlandırılır: API Monitoring Investigate Generated.

Belirli bir uyarıyı inceleme

Belirli bir uyarıyı incelemek için Uyarı Geçmişi sayfasında uyarının adını seçin. İnceleme kontrol paneli görünür. Kontrol panelinin üst kısmında bir grafik olduğunu ve yalnızca uyarıya özel bilgilerin yer aldığını unutmayın:

• Uyarı tetiklendiği sırada API trafiği ayrıntılarını görüntüleyin.
• Grafiğin ortasında, uyarının tetiklendiği zaman da dahil olmak üzere uyarıyla ilgili bağlamsal bilgileri görüntüleyin.
• Uyarı koşuluyla ilgili ayrıntıları pop-up pencerede görüntülemek için Koşul ayrıntıları'nı tıklayın.

• Uyarı için başucu kitabını görüntülemek üzere Başucu kitabı'nı (varsa) tıklayın:

  

• Uyarıyı düzenlemek için Uyarıyı yönet'i tıklayın.

• Özel raporu görüntülemek için Raporu görüntüle'yi (varsa) tıklayın.

• Sayfanın otomatik yenilenmesini gerektiği şekilde etkinleştirin veya devre dışı bırakın.