Melihat data pesan dengan tampilan Debug

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Yang akan Anda pelajari

Dalam tutorial ini, Anda akan mempelajari:

• Lihat header dan isi pesan respons.
• Lihat pesan error.

Yang Anda butuhkan

• Sebelum memulai, Anda harus menyelesaikan langkah-langkah di Ringkasan dan prasyarat.
• Minimal satu kebijakan di proxy.
• curl yang diinstal di komputer Anda untuk melakukan panggilan API dari command line.

Melihat data pesan

Tampilan Debug di Editor Proxy Apigee memungkinkan Anda melihat header, variabel, objek, dan detail lainnya seperti waktu respons dalam alur respons dan permintaan proxy API. Tampilan Debug juga memungkinkan Anda melihat bagaimana permintaan atau respons berubah saat diproses oleh proxy API. Untuk deskripsi yang lebih detail tentang tampilan debug, lihat Menggunakan Debug.

Dalam tutorial sebelumnya, Anda membatasi jumlah permintaan dengan kebijakan SpikeArrest. Halaman ini menjelaskan cara menggunakan tampilan Debug untuk melihat apa yang terjadi jika tarif tersebut terlampaui.

Catatan: Apigee memperkenalkan versi baru Editor Proxy, yang akan mempermudah pengelolaan proxy.

Petunjuk pada dua tab pertama di bawah menjelaskan cara menggunakan Proxy Editor baru atau Proxy Editor klasik.

Editor Proxy Baru

1. Di tab Develop Proxy API, edit <Rate> kebijakan Spike Arrest menjadi 13.00 lagi, lalu Save proxy. Ini akan memungkinkan Anda melihat panggilan API yang berhasil dan gagal (melebihi batas).
2. Di Proxy Editor, klik tab Debug.
3. Klik Start Debug Session.

Dalam dialog:

1. Pilih Lingkungan tempat Anda ingin menjalankan sesi debug.
2. (Opsional) Dari menu drop-down Filter, pilih filter untuk diterapkan ke semua transaksi dalam sesi debug yang Anda buat. Defaultnya adalah None (All transactions), yang menyertakan semua transaksi dalam data debug.

   Untuk mengetahui informasi tentang cara menggunakan filter, lihat Menggunakan filter dalam sesi debug. Untuk informasi tentang filter bawaan, lihat Menggunakan filter standar.

3. Klik Start.

4. Panggil proxy API lagi menggunakan curl (atau dengan URL di browser web) beberapa kali hingga Anda melihat setidaknya satu respons 200 dan satu respons 429 di panel sebelah kiri.

   

   Catatan: Kode status HTTP untuk melebihi batas kapasitas adalah 429 Too many requests.
5. Klik transaksi 429 di panel sebelah kiri. Tindakan ini akan menampilkan Diagram Gantt untuk transaksi di panel sebelah kanan.

   

   Perhatikan bahwa ada baris untuk kebijakan Penangkapan Lonjakan, yang ditampilkan dengan ikon error.

6. Klik baris berlabel Error. Fungsi ini menampilkan detail error di sebelah kanan diagram. Gambar di bawah ini menunjukkan bagian Properties dari detail error:

   

Anda dapat mengklik tombol Kembali dan Berikutnya di bawah diagram Gannt untuk berpindah antar-langkah dalam alur dan melihat detail setiap langkah.

Untuk mendownload seluruh sesi debug sebagai satu dokumen, klik Download Sesi. Sesi debug dihapus dalam waktu 24 jam setelah selesai, sehingga jika ingin melihat sesi setelah waktu tersebut, Anda harus mendownloadnya sebelum tanggal tersebut.

Editor Proxy Klasik

1. Di tab Develop proxy API, edit <Rate> kebijakan Spike Arrest menjadi 1pm lagi, lalu Save proxy. Ini akan memungkinkan Anda melihat panggilan API yang berhasil dan gagal (melebihi batas).
2. Di Proxy Editor, klik tab Debug.
3. Di bagian Mulai sesi debug, pilih lingkungan tempat proxy Anda di-deploy.
4. Klik Start Debug Session.

5. Panggil proxy API lagi menggunakan curl (atau dengan URL di browser web) sampai Anda melihat setidaknya satu respons 200 dan satu respons 429 di panel Transaksi Debug.

   curl -v https://YOUR_ENV_GROUP_HOSTNAME/my-proxy

   dengan YOUR ENV_GROUP_HOSTNAME adalah nama host grup lingkungan. Lihat Menemukan nama host grup lingkungan.

   Respons 200 dan respons 429 ditampilkan di bawah ini.

   

   Catatan: Kode status HTTP default untuk melebihi batas kapasitas adalah 429 Too many requests.

   Jika Anda ingin kode statusnya berbeda (misalnya 500) untuk semua kebijakan Penangkapan Spike yang digunakan dalam organisasi, properti harus ditetapkan di organisasi Anda. Jika Anda pelanggan Cloud, hubungi Dukungan Apigee untuk menetapkan properti tersebut.

6. Klik transaksi 200 di panel Transaksi sebelah kiri. Detail Debug-nya dimuat di jendela utama di bagian Transaction Map, yang menampilkan diagram permintaan/respons. Ikon Spike Ditangkap ada dalam alur permintaan.
7. Dalam diagram alur, klik ikon lingkaran dalam respons, yang terjauh di sebelah kanan (ditunjukkan dalam diagram berikut).

   Panel Phase Details menampilkan data yang tersedia pada titik tersebut dalam alur. Saat men-scroll panel tersebut, Anda akan melihat header respons HTTP dan konten isi.

8. Sekarang, lihat error di Debug.

   Klik transaksi 429 di panel Transaksi. Di jendela editor utama, Anda akan melihat diagram alur yang hanya berisi item yang diminta, termasuk ikon Spike Arrest dengan tanda seru berwarna merah yang menunjukkan adanya error.

   Klik ikon error berbentuk tabung kecil di sebelah kanan ikon Spike Arrest, dan lihat detail pelanggaran penangkapan lonjakan di panel Phase Details.

   

Anda dapat mengklik tombol Back dan Next dalam diagram alur untuk berpindah di antara titik-titik dalam alur dan melihat detail Debug.

Jika Anda ingin melihat seluruh sesi Debug sebagai satu dokumen, download dokumen dengan mengklik Download Sesi Debug.

Untuk informasi selengkapnya, lihat Menggunakan Debug.