Sorunları araştırma

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

İncele kontrol paneli, tüm API trafiği için metrik ve özelliklerin özet 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. Son 30 güne ait verilere kontrol panelinden erişebilirsiniz.

Yatırım kontrol panelini açmak için Edge kullanıcı arayüzünde Analiz > API İzleme > Araştır'ı seçin. 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 hizmetler için gecikme sorunlarını incelemenize olanak tanır.

Ayrıca, İnceleme kontrol panelinde belirli bir uyarının neden olduğu sorunları inceleyebilirsiniz. Bir uyarı oluştuğunda Uyarı Geçmişi sayfasında uyarının adını tıklayarak Invesitgate kontrol panelinde bu uyarıyı açabilirsiniz.

Bir 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ıyorsunuz. Bu sorunu incelemek için İnceleme kontrol panelinde aşağıdaki görevleri gerçekleştirebilirsiniz:

  1. Son bir saat içindeki hata kodu etkinliğini görüntülemek için hata kodu ve zaman matrisini görüntüleyin.
  2. Önceki adımda tanımlandığı gibi, sayıları son bir saat içinde artan hata kodlarıyla ilişkili belirli HTTP durum kodlarını tanımlamak için hata kodu ile HTTP durumu karşılaştırması matrisine geçin.
  3. Önceki adımda tanımlanan hata kodlarını tetikleyen API proxy'lerini belirlemek için hata kodu ile Proxy'nin karşılaştırması matrisine geçin.
  4. Daha fazla ayrıntı ve erişim günlükleri görüntülemek için, matriste çok sayıda hata kodu içeren API proxy'si ile ilişkili bir kutuyu tıklayın.
  5. Sorunun teşhis edilmesine daha fazla yardımcı olması için bir uyarı ayarlayın ve özel bir rapor oluşturun.
  6. Sorunun çözümünü belirlemek için iz ve diğer araçları kullanarak API proxy'si ile ilgili daha ayrıntılı troubleshoot işlemleri yapın.

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 bir veya dört saatlik bir zaman aralığına ait durum kodu metriklerini istediğiniz zaman görüntüleyebilirsiniz.

Durum Kodu kontrol panelini keşfedin

Durum Kodu kontrol panelini görüntülemek için Edge kullanıcı arayüzünde Analiz > API İzleme > İncele'yi seçin. Durum Kodu kontrol paneli varsayılan olarak şunları görüntüler:

durum kodu sayfası

Şekilde vurgulandığı gibi, İnceleme kontrol paneli aşağıdakileri yapmanıza olanak tanır:

  • Metrikler arasındaki ilişkisel etkinliği karşılaştırmak ve daha fazla bilgi edinmek için x ve y eksenini ayarlayarak her bir matrisi yapılandırın.
  • Bir bloğun renk gölgesine göre en yüksek göreceli hacim yaşanan metrikleri hızlı bir şekilde tanımlayın. Blok ne kadar koyuysa göreli hacim o kadar yüksektir.
  • Metrik ayrıntılarını görüntülemek için matristeki 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 pencere

Kontrol panelini kullanarak aşağıdaki görevleri hızlıca gerçekleştirebilirsiniz:

Durum Kodu matrisini yapılandırma

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

  • Hata kodu/zaman
  • Hata kodu ve HTTP durumu karşılaştırması
  • Hata kaynağı ve API proxy'si karşılaştırması

x- ve y ekseni açılır listeleri için bir değer seçerek her matrisi aşağıdaki metriklerden ikisini karşılaştıracak şekilde yapılandırın:

Matrisi yapılandırma

Durum Kodu metrik ayrıntılarını görüntüle

Matriste belirli bir metrik blokunu tıklayarak o metriğin ayrıntılarını görüntüleyebilirsiniz.

Engellemeyi seç

Şüphelenilen nedenle ilgili ayrıntılar sağ bölmede görüntülenir. Örneğin:

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

Ayrıntılar şunları da içerebilir:

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

Kardinalite belirli bir metrik için birden büyükse ayrıntılar paneli, 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 gibi hata dağıtımı ayrıntılarını içerebilir. Örneğin:

Dağılım ölçütü

Hata kaynağı hedefleniyorsa ayrıntılar panelinde Hedefe Göre Hata Oranı gösterilir. Örneğin:

Hedefe göre hata oranı

Gecikme kontrol panelini kullanma

Gecikme kontrol paneli, kuruluşunuzdaki API proxy'leri ve hedef hizmetler için gecikme bilgilerini görüntüler. Son 30 gün içinde herhangi bir zamanda bir saatlik zaman aralığı için gecikme metriklerini inceleyebilirsiniz.

Gecikme kontrol panelini keşfedin

Gecikme kontrol panelini görüntülemek için Edge kullanıcı arayüzünde Analiz > API İzleme > İncele'yi seçin. Varsayılan olarak Durum Kodu kontrol paneli görüntülenir. Gecikme kontrol panelini görüntülemek için filtre alanında Gecikme'yi seçin.

gecikmeli sayfa

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

  • Proxy ve Zaman (milisaniye cinsinden maksimum gecikme)
  • Proxy ve Toplam gecikme (milisaniye cinsinden maksimum gecikme)
  • Proxy ve Tüm hedefler gecikmesi (milisaniye cinsinden maksimum gecikme)

Hedef gecikmelerini görüntülemek için Proxy açılır kutusunu kullanarak Hedef'i seçin.

Varsayılan olarak Gecikme kontrol paneli, bir önceki saat için en yüksek toplam P99 gecikmesine sahip 10 proxy ile ilgili bilgileri gösterir. Alternatif olarak, belirli bir proxy veya koleksiyon seçmek için En İyi 10 açılır kutusunu kullanın.

Gecikme kontrol paneli, aşağıdaki farklılıklar dışında Durum Kodu kontrol panelinin tüm özelliklerine sahiptir:

  • Yalnızca toplam yanıt gecikmesi yüzdesini (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 Herhangi biri seçeneğini belirleyemezsiniz. Görüntülemek için belirli bir bölge seçmelisiniz.

Gecikme metriği ayrıntılarını göster

Matriste belirli bir metrik blokunu tıklayarak o metriğin ayrıntılarını görüntüleyebilirsiniz.

Engellemeyi seç

Bir proxy (mavi çizgi) ve hedef (mor çizgi) için gecikmeyle ilgili ayrıntılar sağ bölmede görüntülenir. Örneğin:

  • Toplam gecikme (proxy gecikmesi artı hedef gecikme)
  • Hedef başına gecikme (hedef yanıt süresi)
  • HTTP Durumuna Göre Dağılım

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

Gecikme metriği görünümü

Hedef başına gecikme grafiği, hedef başına bir grafik olacak şekilde, maksimum gecikmeye göre ilk 16 hedefi gösterir. Her bir hedefe karşılık gelen grafiği belirlemek için farenizle 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 gecikmeyle ilgili 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:

Günlük seçimi

Trafik Günlükleri iletişim kutusu açılır ve en fazla 1.000 günlük girişi görüntüler. Listedeki bir günlük girişini tıklayarak ayrıntılarını genişletin:

Günlükler

Günlükleri aşağıdaki ölçütlere göre de filtreleyebilirsiniz:

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

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

Investigate kontrol panelinden özel rapor oluşturma

Seçilen koşul kümesine göre özel bir rapor oluşturun. Özel raporu oluşturduktan sonra düzenleyerek gerektiği gibi metrik ve boyut ekleyebilir ya da silebilirsiniz. Örneğin, araştırmanızı belirli bir erişim jetonu, geliştirici uygulaması veya API proxy'si ile daraltmak isteyebilirsiniz. Daha fazla bilgi için Analytics metrikleri, boyutları ve filtreleriyle ilgili referans başlıklı makaleyi inceleyin.

Daha fazla bilgi için Özel raporlar oluşturma başlıklı makaleye bakın.

Özel rapor oluşturmak için:

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

    Engellemeyi seç

  2. Sağ bölmede Özel rapor oluştur simgesini tıklayın.

    rapor oluştur

    Özel rapor sayfası, alakalı alanların önceden doldurulduğu yeni bir sekmede görüntülenir.

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

    Raporu düzenle

  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 panelini keşfetme başlıklı makaleyi inceleyin.

Raporlar sayfasında, API Monitoring kullanılarak oluşturulan özel raporlar şu biçim kullanılarak adlandırılmıştı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. Gösterge tablosunun üst kısmında bir grafik içerdiğine ve yalnızca uyarı için belirtilen bilgileri içerdiğine dikkat edin:

uyarı sayfasını incele

  • Uyarının tetiklendiği sırada API trafik ayrıntılarını görüntüleme.
  • Uyarının tetiklendiği zaman da dahil olmak üzere, uyarıyla ilgili bağlamsal bilgileri grafiğin ortasında görüntüleyebilirsiniz.
  • Uyarı koşulunun ayrıntılarını pop-up pencerede görüntülemek için Koşul ayrıntıları'nı tıklayın.
  • Uyarıyla ilgili başucu kitabını görüntülemek için Başucu Kitabı'nı (varsa) tıklayın:

    başucu kitabı bağlantısı

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

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

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