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 tutorial ini, lakukan hal berikut:

• Pastikan curl diinstal di komputer Anda untuk melakukan panggilan API dari command line.
• Selesaikan langkah-langkah di Sebelum memulai.
• Tambahkan kebijakan SpikeArrest ke proxy Anda. Kebijakan SpikeArrest adalah kebijakan yang membatasi jumlah permintaan yang dapat dikirim ke proxy API Anda. Proxy Anda harus memiliki minimal satu kebijakan.

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.

Halaman ini menjelaskan cara menggunakan tampilan Debug untuk melihat apa yang terjadi saat tingkat kebijakan SpikeArrest terlampaui.

Catatan: Alat Debug tersedia di konsol Google Cloud, UI Klasik, dan beberapa tindakan debug dapat dilakukan menggunakan API seperti yang dijelaskan di tab berikut. Opsi konsol Google Cloud adalah Debug v2 (baru) dan Debug v1 (dirilis 07/01/2022). Anda dapat beralih antarversi Alat Debug di konsol Google Cloud dan UI Klasik.

UI Cloud ConsoleUI Klasik

Debug v2 (baru)Debug v1

Untuk menggunakan tampilan Debug di UI Konsol Cloud guna melihat apa yang terjadi saat rasio kebijakan SpikeArrest terlampaui:

1. Buka UI Cloud Console.
2. Pilih project Anda.
3. Klik Proxy development > API Proxies.
4. Klik nama proxy API yang ingin Anda debug.
5. Klik tab Mengembangkan.
6. Klik kebijakan Kebijakan > SpikeArrest.
7. Di panel edit, ubah Rate menjadi 1pm.
8. Klik Simpan.Tindakan ini akan memungkinkan Anda melihat panggilan API yang berhasil dan gagal (melebihi batas).
9. Deploy proxy yang telah diperbarui.
10. Klik tab Debug.
11. 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 mencakup 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.

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

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

13. Klik transaksi 429. Di panel Peta transaksi, tindakan ini akan menampilkan diagram alur yang menyertakan kebijakan SpikeArrest dengan ikon error.

    

14. Klik ikon error. Panel Error Properties akan ditampilkan.

    

Anda dapat mengklik tombol Previous dan Next untuk beralih antarlangkah 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.

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.

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. Pada 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 flow untuk berpindah di antara titik dalam flow 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.