Melihat data pesan dengan tampilan Debug

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Yang akan Anda pelajari

Dalam tutorial ini, Anda akan mempelajari cara:

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

Yang Anda butuhkan

• Sebelum memulai, Anda harus menyelesaikan langkah-langkah di Ringkasan dan prasyarat.
• Setidaknya satu kebijakan di proxy Anda.
• 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 permintaan dan respons proxy API. Tampilan Debug juga memungkinkan Anda melihat perubahan permintaan atau respons saat diproses oleh proxy API. Untuk deskripsi tampilan debug yang lebih mendetail, 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 kapasitas tersebut terlampaui.

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

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

Editor Proxy Baru

1. Di tab Develop pada Proxy API, edit <Rate> kebijakan Spike Arrest menjadi 1pm lagi, lalu Save proxy. Dengan demikian, Anda dapat melihat panggilan API yang berhasil dan gagal (melebihi batas).
2. Di Proxy Editor, klik tab Debug.
3. Klik Mulai Sesi Debug.

Dalam dialog:

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

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

3. Klik Mulai.

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 Spike Arrest, yang ditampilkan dengan ikon error.

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

   

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

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

Editor Proxy Klasik

1. Di tab Develop proxy API, edit <Rate> kebijakan Spike Arrest menjadi 1pm lagi, lalu Save proxy. Dengan demikian, Anda dapat 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 Mulai Sesi Debug.

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

   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.

   

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

   Jika Anda ingin kode status berbeda (misalnya, 500) untuk semua kebijakan Spike Arrest yang digunakan di organisasi, properti harus ditetapkan di organisasi Anda. Jika Anda adalah pelanggan Cloud, hubungi Cloud Customer Care untuk menetapkan properti tersebut.

6. Klik transaksi 200 di panel Transaksi sebelah kiri. Detail Debugnya dimuat di jendela utama pada bagian Peta Transaksi, yang menampilkan diagram permintaan/respons. Ikon Spike Arrest ada dalam alur permintaan.
7. Dalam diagram alur, klik ikon lingkaran dalam respons, yang paling jauh di sebelah kanan (ditampilkan dalam diagram berikut).

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

8. Sekarang, lihat error di Debug.

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

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

   

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

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

Untuk mengetahui informasi selengkapnya, lihat Menggunakan Debug.