Öğretici: İstek izleme kullanarak API'lerinizin hata ayıklaması

Bu öğreticide, API'nizin hata ayıklama ve sorunlarını gidermenize yardımcı olmak için Azure API Management'da istek işlemeyi inceleme (izleme) adımları anlatılır.

Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz:

  • Örnek bir çağrıyı izleme
  • İstek işleme adımlarını gözden geçirme

API denetçisi

Önkoşullar

İzlemeye izin ver ayarını doğrulama

API'niz için kullanılan abonelik için İzlemeye izin ver ayarının etkinleştirilmesi gerekir. Yerleşik tüm erişim aboneliğini kullanıyorsanız bu abonelik varsayılan olarak etkindir. Portalda doğrulamak için uygulama örneğinize gidin API Management Abonelikler'i seçin.

Abonelik için izlemeye izin ver

Çağrı izleme

  1. Azure portal'daoturum API Management ve API Management gidin.
  2. API’ler seçeneğini belirleyin.
  3. API listesinden Demo Conference API'sini seçin.
  4. Test sekmesini seçin.
  5. GetSpeakers işlemini seçin.
  6. HTTP isteği üst bilgisinde Ocp-Apim-Trace: True ve Ocp-Apim-Subscription-Key için geçerli bir değer olduğunu onaylayın. Değilse, üst bilgi eklemek için + Üst Bilgi Ekle'yi seçin.
  7. API çağrısı yapmak için Gönder'i seçin.

API izlemeyi yapılandırma

İpucu

HTTP isteğinde Ocp-Apim-Subscription-Key otomatik olarak doldurulmazsa portaldan bunu alın. Abonelikler'i seçin ve simgenizin bağlam menüsünü (...) açın. Anahtarları göster/gizle'yi seçin. Gerekirse anahtarları da yeniden üretin. Ardından üst bilgiye bir anahtar ekleyin.

İzleme bilgilerini gözden geçirme

  1. Çağrı tamamlandıktan sonra HTTP Yanıtı'nın İzleme sekmesine gidin.

  2. Ayrıntılı izleme bilgilerine atlamak için aşağıdaki bağlantılardan birini seçin: Gelen, Arka Uç, Giden.

    Yanıt izlemesini gözden geçirme

    • Gelen - Çağırandan API Management özgün isteği ve iraca uygulanan ilkeleri gösterir. Örneğin, Öğretici: API'nizi dönüştürme ve koruma'da ilkelereklediysanız, bunlar burada görünür.

    • Arka Uç - API API Management gönderilen istekleri ve aldığı yanıtı gösterir.

    • Giden - Çağırana geri göndermeden önce yanıta uygulanan ilkeleri gösterir.

    İpucu

    Her bir adım, isteğin API Yönetimi tarafından alınmasından bu yana geçen süreyi de gösterir.

  3. İleti sekmesinde ocp-apim-trace-location üst bilgisi, Azure blob depolamada depolanan izleme verilerini gösterir. Gerekirse, izlemeyi almak için bu konuma gidin.

    Azure Depolama'de izleme konumu

Sonraki adımlar

Bu öğreticide, şunların nasıl yapıldığını öğrendiniz:

  • Örnek bir çağrıyı izleme
  • İstek işleme adımlarını gözden geçirme

Sonraki öğreticiye ilerleyin: