Menggunakan Debug

UI Konsol Cloud

Debug v2 (baru)

Untuk membuat sesi debug:

1. Login ke konsolGoogle Cloud .
2. Pilih Proxy development > API Proxies.
3. Pilih proxy API yang ingin Anda debug. Tindakan ini akan menampilkan panel Ringkasan Proxy Editor.
4. Klik tab Debug.
5. Klik Start Debug Session. Tindakan ini akan menampilkan panel Mulai sesi debug.

6. Di panel Start debug session:

   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. Nilai defaultnya adalah None (All transactions), yang mencakup semua transaksi dalam data debug.

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

   3. Klik Mulai.

UI Apigee kini menampilkan panel Debug session in progress.

Sesi debug merekam permintaan selama 10 menit atau hingga 15 permintaan telah diambil. Anda dapat menyesuaikan batas 10 menit jika membuat sesi debug menggunakan API. Kolom Berakhir dalam menampilkan jumlah waktu yang tersisa dalam sesi.

Anda tidak akan melihat informasi apa pun yang ditampilkan di panel Debug hingga Anda mengirim permintaan ke proxy yang Anda debug di lingkungan yang dipilih untuk sesi debug.

Setelah Anda mengirim permintaan, permintaan tersebut akan ditampilkan di panel daftar Transaksi. Daftar Transaksi diperbarui setiap lima detik.

Debug v1

Untuk membuat sesi debug di Editor Proxy baru:

1. Login ke konsolGoogle Cloud .

2. Pilih Proxy development > API Proxies.

3. Pilih proxy API yang ingin Anda debug. Tindakan ini akan menampilkan tampilan Ringkasan Proxy Editor.

4. Klik tab Debug di kiri atas jendela.
5. Klik Start Debug Session di kanan atas panel Debug. Ini menampilkan dialog Start debug session.

   

   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. Nilai defaultnya adalah None (All transactions), yang mencakup semua transaksi dalam data debug.

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

   3. Klik Mulai.

UI Apigee kini menampilkan tampilan Debug session in progress.

Sesi debug merekam permintaan selama 10 menit atau hingga 15 permintaan telah diambil. Anda dapat menyesuaikan batas 10 menit jika membuat sesi debug menggunakan API. Kolom Berakhir dalam menampilkan jumlah waktu yang tersisa dalam sesi.

Anda tidak akan melihat informasi apa pun yang ditampilkan di panel Debug hingga Anda mengirim permintaan ke proxy yang Anda debug di lingkungan yang dipilih. lingkungan untuk sesi debug.

Setelah Anda mengirim permintaan, permintaan tersebut akan ditampilkan di bagian bawah panel kiri.

Catatan: Selama sesi debug aktif, Anda dapat memulai sesi lain di UI Apigee. Untuk melakukannya, cukup klik Start Debug Session lagi.

UI Klasik

Untuk membuat sesi debug di Editor Proxy klasik:

1. Login ke UI Apigee.
2. Pilih API Proxies dari tampilan utama.

3. Pilih proxy API yang ingin Anda debug.

   Tab Ringkasan akan ditampilkan.

4. Klik tab Debug di kanan atas halaman:

   

   Tampilan Debug menampilkan:

   

5. Di panel Mulai sesi debug:
   1. Dari menu drop-down Env, pilih lingkungan + nomor revisi proxy API yang ingin Anda debug.

   Contoh berikut menunjukkan panel Mulai sesi proses debug:

   

   2. (Opsional) Dari menu drop-down Filter, pilih filter yang akan diterapkan ke semua transaksi dalam sesi debug yang Anda buat. Nilai defaultnya adalah None, yang mencakup semua transaksi dalam data debug.

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

   3. Klik Start Debug Session.

      UI Apigee kini menampilkan detail tentang sesi debug saat ini, termasuk ID-nya, di panel Debug details.

      Meskipun UI membuat sesi debug, Anda tetap perlu mengirim permintaan sebelum ada data yang dikumpulkan.

      Dari panel Detail debug, Anda dapat melakukan hal berikut:

      Ikon	Fungsi	Deskripsi
      	Download	Download data debug sesi aktif, yang kemudian dapat Anda lihat secara offline.
      	Kembali	Kembali ke panel sebelumnya, tempat Anda dapat memulai sesi debug lain. Sesi debug saat ini akan berlanjut hingga mencapai waktu tunggu atau jumlah transaksi.
      	Hapus	Menghapus data sesi debug yang saat ini dipilih. Tindakan ini akan menghapus data sesi, tetapi tidak menghentikan sesi.

      Ada batas waktu tunggu default 10 menit untuk sesi debug yang Anda mulai di UI (berbeda untuk sesi yang dimulai dengan API).

      Waktu mulai berjalan segera setelah Anda mengklik Mulai Sesi Debug, sehingga Anda dapat memilih untuk menunggu hingga setelah langkah berikutnya sebelum mengklik Mulai Sesi Debug untuk memaksimalkan jumlah data yang Anda kumpulkan.

6. Di panel Kirim Permintaan:
   1. Di kolom URL, masukkan endpoint yang ingin Anda kirimi permintaan. Jika perlu, tambahkan parameter string kueri ke URL. Anda tidak dapat mengirimkan permintaan selain GET.

      Cara menemukan URL endpoint

      1. Buka Admin > Environments > Groups
      2. URL adalah Hostname untuk lingkungan yang ingin Anda gunakan untuk menjalankan sesi debug.

   Panel Kirim Permintaan hanya menampilkan data untuk permintaan berbasis UI. Namun, perhatikan bahwa debug juga mencatat data untuk permintaan yang tidak dimulai oleh UI.

   2. Klik Kirim.

      Apigee mengirimkan permintaan ke URL yang ditentukan. Setiap kali Anda mengklik Send, UI Apigee mencatat permintaan di panel Debug details.

      Contoh berikut menunjukkan beberapa permintaan yang berhasil (menghasilkan kode status HTTP 200):

      

      Klik Salin untuk menyalin ID debug sebagai referensi atau kueri di masa mendatang.

      Selain itu, UI menampilkan data debug di bagian Peta Transaksi dan Detail Fase pada panel Kirim Permintaan, serta mengisi bagian Endpoint Proxy, Header Permintaan, Konten Permintaan, dan Properti, seperti yang ditunjukkan contoh berikut:

      

      Untuk mengetahui informasi selengkapnya tentang fase, peta transaksi, dan bagian lain dari tampilan Kirim Permintaan, lihat Cara membaca debug.

   Sesi debug kini aktif dan mencatat data tentang semua permintaan (kecuali jika difilter). Sesi akan tetap aktif hingga waktu tunggu tercapai atau jumlah permintaan yang dicatat dalam sesi terlampaui.

7. Anda dapat membuat sejumlah sesi penelusuran di UI. Untuk mengetahui informasi selengkapnya, lihat Memulai sesi debug lain.

API

Untuk membuat sesi debug menggunakan API, kirim permintaan POST ke resource berikut:

https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/debugsessions

Secara opsional, Anda dapat:

• Tetapkan durasi sesi debug (dalam detik) dengan meneruskan properti timeout sebagai parameter kueri atau dalam isi permintaan. Jika keduanya ditentukan, nilai timeout yang ditentukan dalam isi permintaan akan diprioritaskan.
• Memfilter data dalam sesi debug dengan meneruskan properti filter di isi permintaan.

Contoh berikut menunjukkan cara membuat sesi debug menggunakan API.

curl "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/apis/PROXY/revisions/REV/debugsessions" \
      -X POST \
      -H "Authorization: Bearer $TOKEN"
    

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk mengetahui deskripsi variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut adalah contoh respons:

{
      "name":"56382416-c4ed-4242-6381-591bbf2788cf",
      "validity":300,
      "count":10,
      "tracesize":5120,
      "timeout":"600"
    }

Permintaan berikutnya ke proxy API Anda (hingga durasi sesi atau jumlah maksimum permintaan tercapai) akan dievaluasi dan berpotensi disimpan dalam data sesi debug.

Untuk mengetahui informasi selengkapnya, lihat API pembuatan sesi debug.

Menetapkan durasi sesi debug menggunakan API

Untuk menyetel durasi sesi debug menggunakan API, sertakan hal berikut sebagai payload dalam permintaan pembuatan sesi debug:

{
      "timeout":"debug_session_length_in_seconds"
    }

Contoh berikut membuat sesi debug yang hanya berdurasi 42 detik:

curl https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/apis/PROXY/revisions/REV/debugsessions"
      -X "POST" \
      -H "Authorization: Bearer $TOKEN" \
      -d ' {
        "timeout":"42"
      } '

Anda dapat menyetel timeout sesi hanya dalam permintaan pembuatan sesi debug; Anda tidak dapat mengubah durasi sesi setelah membuat sesi.

Nilai default timeout adalah 300 (5 menit). Nilai maksimum adalah 600 detik (10 menit).

UI Konsol Cloud

UI Klasik

Untuk menemukan dan menyalin URL endpoint:

1. Di UI Apigee, buka Admin > Environments > Groups. Anda akan dialihkan ke halaman Google Cloud konsol, Management > Environments > Environment Groups.
2. URL adalah Nama host untuk lingkungan masing-masing yang ingin Anda gunakan untuk menjalankan sesi debug. Pilih, lalu salin.

Untuk mengedit URL target:

1. Temukan URL endpoint.
2. Klik more_vert Lainnya, lalu klik edit Edit.
3. Lakukan perubahan yang diinginkan, lalu klik Perbarui.

UI Konsol Cloud

Selama sesi debug aktif, Anda dapat memulai sesi lain di UI Apigee. Untuk melakukannya, klik close Tutup di panel Sesi debug:

UI akan kembali ke panel Mulai sesi debug, tempat Anda dapat memulai sesi debug baru.

UI Klasik

Selama sesi debug aktif, Anda dapat memulai sesi lain di UI Apigee. Untuk melakukannya, klik ikon panah kembali (keyboard_arrow_left) di panel Detail debug:

UI akan kembali ke panel Mulai sesi debug, tempat Anda dapat memulai sesi debug baru.

UI Konsol Cloud

UI Klasik

Alat debug memiliki dua bagian utama, peta transaksi dan detail fase:

• Peta transaksi menggunakan ikon untuk menandai setiap langkah penting yang terjadi selama transaksi proxy API, termasuk eksekusi kebijakan, langkah bersyarat, dan transisi. Arahkan kursor ke ikon untuk melihat informasi ringkasan. Langkah-langkah alur permintaan muncul di sepanjang bagian atas peta transaksi dan langkah-langkah alur respons di sepanjang bagian bawah.
• Bagian detail fase alat mencantumkan informasi tentang pemrosesan internal proxy, termasuk variabel yang ditetapkan atau dibaca, header permintaan dan respons, dan banyak lagi. Klik ikon mana pun untuk melihat detail fase untuk langkah tersebut.

UI Konsol Cloud

Debug v2 (baru)

Berikut adalah contoh panel transaksi alat debug dengan segmen pemrosesan proxy utama yang diberi label:

Debug v1

Untuk melihat detail transaksi (permintaan dan respons) di tampilan Debug, klik baris untuk transaksi guna menampilkan diagram Gantt di panel sebelah kanan yang menunjukkan langkah-langkah dalam permintaan dan respons.

Sumbu horizontal diagram menunjukkan waktu terjadinya setiap langkah, yang diukur dalam milidetik. Setiap langkah diwakili oleh persegi panjang yang membentang dari waktu mulai hingga waktu berakhir langkah.

Anda dapat menelusuri sesi debug menggunakan tombol Kembali dan Berikutnya di kanan bawah panel debug. Klik:

• Kembali untuk memindahkan baris yang dipilih ke langkah sebelumnya dalam diagram.
• Berikutnya untuk memindahkan baris yang dipilih ke langkah berikutnya dalam diagram.

Dalam contoh yang ditunjukkan di atas, diagram menampilkan dua kebijakan yang dijalankan dalam respons:

• ResponsePayload
• Menambahkan CORS

Anda dapat mengklik salah satu langkah ini untuk melihat detailnya. Misalnya, jika Anda mengklik kebijakan Add CORS, Anda akan melihat detail seperti yang ditampilkan di bawah di samping diagram Gantt.

Jika Anda kemudian memutuskan untuk mengubah sesuatu dalam konfigurasi kebijakan, Anda dapat mengklik Develop untuk beralih ke tampilan Develop, tempat Anda akan melihat dua kebijakan yang sama di Response PostFlow.

UI Klasik

Berikut adalah contoh peta alat debug dengan segmen pemrosesan proxy utama yang diberi label:

Peta transaksi alat debug

UI Konsol Cloud

Debug v2 (baru)

Bagian ini menjelaskan ikon di panel transaksi:

• Ikon kebijakan
• Ikon lainnya

Ikon kebijakan

Setiap jenis kebijakan memiliki ikon unik. Ikon ini memungkinkan Anda melihat tempat kebijakan dijalankan dalam urutan yang benar dan apakah kebijakan tersebut berhasil atau tidak. Anda dapat mengklik ikon kebijakan untuk melihat hasil eksekusinya dan apakah hasilnya sesuai yang diharapkan atau tidak. Misalnya, Anda dapat melihat apakah pesan telah diubah dengan benar atau sedang di-cache.

Kebijakan standar melengkapi API Anda untuk mengontrol traffic, meningkatkan performa, menegakkan keamanan, dan meningkatkan kegunaan API Anda, tanpa mengharuskan Anda menulis kode atau mengubah layanan backend.

Kebijakan yang dapat di-extend memungkinkan Anda menambahkan logika kustom ke proxy API. Anda dapat menggunakan kebijakan ini untuk menambahkan fungsi yang tidak disediakan oleh kebijakan standar.

Lihat Ringkasan referensi kebijakan untuk mengetahui informasi selengkapnya tentang kebijakan dan kategori.

Untuk memfilter tabel:

• Pilih satu jenis kebijakan dan/atau satu kategori kebijakan.
• Klik header kolom Nama untuk mengurutkan tabel berdasarkan nama kebijakan.
• Ketik kata kunci untuk menelusuri nama kebijakan.

Jenis kebijakan Standard Dapat Diperluas

Kategori kebijakan Alur dialog Ekstensi Mediasi Keamanan Pengelolaan traffic

Ikon	Nama	Jenis	Kategori
manage_search	Kebijakan ParseDialogflowRequest	Dapat Diperluas	Alur dialog
chat_add_on	Kebijakan SetDialogflowResponse	Dapat Diperluas	Alur dialog
stacked_line_chart	Kebijakan DataCapture	Dapat Diperluas	Ekstensi
display_external_input	Kebijakan ExternalCallout	Standar	Ekstensi
flowsheet	Kebijakan FlowCallout	Dapat Diperluas	Ekstensi
otomatisasi	Kebijakan IntegrationCallout	Dapat Diperluas	Ekstensi
	Kebijakan JavaCallout	Dapat Diperluas	Ekstensi
	Kebijakan JavaScript	Dapat Diperluas	Ekstensi
add_notes	Kebijakan MessageLogging	Dapat Diperluas	Ekstensi
chat_paste_go	Kebijakan PublishMessage	Standar	Ekstensi
	Kebijakan PythonScript	Dapat Diperluas	Ekstensi
integration_instructions	Kebijakan ServiceCallout	Dapat Diperluas	Ekstensi
otomatisasi	Kebijakan SetIntegrationRequest	Dapat Diperluas	Ekstensi
waterfall_chart	Kebijakan TraceCapture	Dapat Diperluas	Ekstensi
cloud_done	Kebijakan AccessEntity	Dapat Diperluas	Mediasi
account_tree	Kebijakan AsseretCondition	Standar	Mediasi
edit_square	Kebijakan AssignMessage	Dapat Diperluas	Mediasi
login	Kebijakan ExtractVariables	Dapat Diperluas	Mediasi
	Kebijakan GraphQL	Standar	Mediasi
sync_alt	Kebijakan HTTPModifier	Standar	Mediasi
sync_alt	Kebijakan JSONtoXML	Standar	Mediasi
account_tree	Kebijakan KeyValueMapOperations	Dapat Diperluas	Mediasi
sync_alt	Kebijakan MonetizationLimitsCheck	Dapat Diperluas	Mediasi
cloud_done	Kebijakan OASValidation	Standar	Mediasi
laporan	Kebijakan RaiseFault	Standar	Mediasi
sync_alt	Kebijakan ReadPropertySet	Standar	Mediasi
cloud_done	Kebijakan SOAPMessageValidation	Standar	Mediasi
sync_alt	Kebijakan XMLtoJSON	Standar	Mediasi
cloud_done	Kebijakan XSLTransform	Dapat Diperluas	Mediasi
kunci	Kebijakan AccessControl	Standar	Keamanan
keamanan	Kebijakan BasicAuthentication	Dapat Diperluas	Keamanan
connect_without_contact	Kebijakan CORS	Standar	Keamanan
kunci	Kebijakan DecodeJWS	Dapat Diperluas	Keamanan
kunci	Kebijakan DecodeJWT	Standar	Keamanan
kunci sandi	Kebijakan DeleteOAuthV2Info	Dapat Diperluas	Keamanan
kunci	Kebijakan GenerateSamlAssertion	Dapat Diperluas	Keamanan
kunci	Kebijakan GenerateJWS	Dapat Diperluas	Keamanan
kunci	Kebijakan GenerateJWT	Dapat Diperluas	Keamanan
kunci sandi	Kebijakan GetOAuthV2Info	Dapat Diperluas	Keamanan
kunci	Kebijakan HMAC	Standar	Keamanan
keamanan	Kebijakan JSONThreatProtection	Dapat Diperluas	Keamanan
kunci sandi	Kebijakan OAuthV2	Dapat Diperluas	Keamanan
keamanan	Kebijakan RegularExpressionProtection	Dapat Diperluas	Keamanan
kunci sandi	Kebijakan RevokeOAuthV2	Dapat Diperluas	Keamanan
kunci sandi	Kebijakan SetOAuthV2Info	Dapat Diperluas	Keamanan
kunci	Kebijakan ValidateSamlAssertion	Dapat Diperluas	Keamanan
key	Kebijakan VerifyAPIKey	Dapat Diperluas	Keamanan
kunci sandi	VerifyIAM policy	Dapat Diperluas	Keamanan
kunci	Kebijakan VerifyJWS	Dapat Diperluas	Keamanan
kunci	Kebijakan VerifyJWT	Standar	Keamanan
keamanan	Kebijakan XMLThreatProtection	Dapat Diperluas	Keamanan
di-cache	Kebijakan InvalidateCache	Dapat Diperluas	Pengelolaan traffic
di-cache	Kebijakan LookupCache	Dapat Diperluas	Pengelolaan traffic
di-cache	Kebijakan PopulateCache	Dapat Diperluas	Pengelolaan traffic
bar_chart_4_bars	Kebijakan kuota	Dapat Diperluas	Pengelolaan traffic
repartisi	Kebijakan ResetQuota	Dapat Diperluas	Pengelolaan traffic
di-cache	Kebijakan ResponseCache	Dapat Diperluas	Pengelolaan traffic
emergency_home	Kebijakan SpikeArrest	Standar	Pengelolaan traffic

Ikon lainnya

Tabel berikut menjelaskan maksud dari ikon lain yang akan Anda lihat di panel transaksi. Ikon ini menandai setiap langkah pemrosesan penting di seluruh alur proxy.

Untuk memfilter tabel:

• Pilih satu jenis ikon.
• Klik header kolom Nama untuk mengurutkan tabel berdasarkan nama ikon.
• Ketik kata kunci untuk menelusuri nama ikon.

Jenis ikon Transaksi standar Status langkah

Ikon	Nama	Jenis	Deskripsi
monitor	Aplikasi klien	Transaksi standar	Aplikasi klien yang mengirim permintaan ke ProxyEndpoint proxy API.
circle	Endpoint transisi	Transaksi standar	Lingkaran menandai endpoint transisi dalam alur proxy. Mereka ada saat permintaan masuk dari klien, saat permintaan dikirim ke target, saat respons kembali dari target, dan saat respons dikirim kembali ke klien.
stat_0	Segmen alur	Transaksi standar	Berlian menunjukkan awal segmen alur dalam alur proxy API. Segmen alur adalah: Permintaan ProxyEndpoint, Permintaan TargetEndpoint, respons TargetEndpoint, dan respons ProxyEndpoint. Segmen mencakup PreFlow, Conditional Flows, dan PostFlow. Lihat Alur bersyarat untuk mengetahui informasi selengkapnya.
	Alur bersyarat benar	Transaksi standar	Alur bersyarat yang bernilai benar (seperti pernyataan if yang bernilai true). Untuk pengantar alur bersyarat, lihat Alur bersyarat. Perhatikan bahwa beberapa kondisi dibuat oleh Apigee. Misalnya, berikut adalah ekspresi yang digunakan Apigee untuk memeriksa apakah terjadi error di ProxyEndpoint: ((error.state equals PROXY_REQ_FLOW) or (error.state equals PROXY_RESP_FLOW))
	Alur bersyarat salah	Transaksi standar	Alur kondisional yang bernilai salah. Untuk pengantar alur bersyarat, lihat Alur bersyarat. Perhatikan bahwa beberapa kondisi dibuat oleh Apigee. Misalnya, berikut adalah ekspresi yang digunakan Apigee untuk memeriksa apakah terjadi error di TargetEndpoint: (((error.state equals TARGET_REQ_FLOW) or (error.state equals TARGET_RESP_FLOW)) or ((error.state equals REQ_SENT) or (error.state equals RESP_START)))
	Info alur	Transaksi standar	Mewakili informasi kontekstual tentang eksekusi proxy API, yang bervariasi bergantung pada titik dalam alur. Hal ini mencakup detail tentang konfigurasi proxy, status eksekusi saat ini (misalnya, PreFlow, PostFlow, hook alur), detail eksekusi kebijakan, dan variabel yang diisi selama eksekusi kebijakan, untuk menunjukkan status spesifik proxy pada saat itu.
done_all	Eksekusi alur	Transaksi standar	Menandai awal atau akhir eksekusi alur, yang menunjukkan jangka waktu segmen alur yang berbeda, untuk membatasi alur secara visual dan menunjukkan urutan eksekusi alur.
commit	Pemrosesan alur	Transaksi standar	Menunjukkan pemrosesan aktif dalam alur, yang merepresentasikan periode saat kebijakan dan logika alur dieksekusi.
bar_chart	Data yang diambil oleh analisis Apigee	Transaksi standar	Menunjukkan bahwa tindakan Analytics telah terjadi di latar belakang.
location_on	Layanan backend	Transaksi standar	Layanan backend yang menerima permintaan. Target backend yang dipanggil oleh proxy API.
	Nonaktif	Status langkah	Muncul di ikon kebijakan saat kebijakan dinonaktifkan. Kebijakan dapat dinonaktifkan dengan API publik. Lihat Referensi konfigurasi proxy API.
	Error	Status langkah	Muncul di ikon kebijakan saat kondisi langkah kebijakan dievaluasi ke salah (lihat Kondisi dengan variabel alur), atau di ikon kebijakan RaiseFault setiap kali kebijakan RaiseFault dijalankan.
	Dilewati	Status langkah	Muncul di ikon kebijakan saat kebijakan tidak dijalankan karena kondisi langkah bernilai salah (false). Lihat Kondisi dengan variabel alur) untuk mengetahui informasi selengkapnya.

Debug v1

Versi ini menggunakan diagram Gantt untuk menampilkan langkah-langkah dalam permintaan dan respons; tidak ada legenda yang diberikan.

UI Klasik

Tabel berikut menjelaskan maksud ikon yang akan Anda lihat di peta transaksi. Ikon ini menandai setiap langkah pemrosesan penting di seluruh alur proxy.

Ikon peta transaksi

	Aplikasi klien yang mengirim permintaan ke ProxyEndpoint proxy API.
	Lingkaran menandai endpoint transisi dalam alur proxy. Log ini ada saat permintaan masuk dari klien, saat permintaan dikirim ke target, saat respons kembali dari target, dan saat respons dikirim kembali ke klien.
	Batang tinggi menunjukkan awal segmen alur dalam alur proxy API. Segmen alur adalah: Permintaan ProxyEndpoint, permintaan TargetEndpoint, respons TargetEndpoint, dan respons ProxyEndpoint. Segmen mencakup PreFlow, Conditional Flows, dan PostFlow. Lihat Mengonfigurasi alur untuk mengetahui informasi selengkapnya.
	Menunjukkan bahwa tindakan Analytics telah terjadi di latar belakang.
	Alur bersyarat yang dievaluasi sebagai benar. Untuk pengantar alur bersyarat, lihat Mengonfigurasi alur. Perhatikan bahwa beberapa kondisi dibuat oleh Apigee. Misalnya, berikut adalah ekspresi yang digunakan Apigee untuk memeriksa apakah terjadi error di ProxyEndpoint: ((error.state equals PROXY_REQ_FLOW) or (error.state equals PROXY_RESP_FLOW))
	Alur kondisional yang bernilai salah. Untuk pengantar alur bersyarat, lihat Mengonfigurasi alur. Perhatikan bahwa beberapa kondisi dibuat oleh Apigee. Misalnya, berikut adalah ekspresi yang digunakan Apigee untuk memeriksa apakah terjadi error di TargetEndpoint: (((error.state equals TARGET_REQ_FLOW) or (error.state equals TARGET_RESP_FLOW)) or ((error.state equals REQ_SENT) or (error.state equals RESP_START)))
	Kebijakan. Setiap jenis kebijakan memiliki ikon unik. Yang ini untuk kebijakan AssignMessage. Ikon ini memungkinkan Anda melihat tempat kebijakan dijalankan dalam urutan yang benar dan apakah kebijakan tersebut berhasil atau tidak. Anda dapat mengklik ikon kebijakan untuk melihat hasil eksekusinya dan apakah hasilnya sesuai yang diharapkan atau tidak. Misalnya, Anda dapat melihat apakah pesan telah ditransformasikan dengan benar atau apakah pesan sedang di-cache. Kebijakan yang dijalankan dengan benar ditunjukkan dengan jelas oleh tanda centang. Jika terjadi error, tanda seru merah akan ditampilkan pada ikon.
	Target backend yang dipanggil oleh proxy API.
	Garis waktu menunjukkan durasi (dalam milidetik) yang diperlukan untuk menyelesaikan waktu pemrosesan. Membandingkan segmen waktu yang telah berlalu membantu Anda mengisolasi kebijakan yang membutuhkan waktu paling lama untuk dieksekusi yang memperlambat panggilan API Anda.
	Epsilon menunjukkan rentang waktu yang lebih kecil dari milidetik.
	Dinonaktifkan. Muncul di ikon kebijakan saat kebijakan dinonaktifkan. Kebijakan dapat dinonaktifkan dengan API publik. Lihat referensi konfigurasi proxy API.
	Error. Muncul di ikon kebijakan saat kondisi Langkah Kebijakan bernilai salah (lihat Variabel dan kondisi alur), atau di ikon kebijakan RaiseFault setiap kali kebijakan RaiseFault dijalankan.
	Dilewati. Muncul di ikon kebijakan saat kebijakan tidak dijalankan karena kondisi langkah bernilai salah (false). Lihat Variabel dan kondisi alur untuk mengetahui informasi selengkapnya.

UI Konsol Cloud

UI Klasik

Bagian Detail Fase pada alat ini memberi tahu Anda banyak hal tentang status proxy Anda di setiap langkah pemrosesan. Berikut beberapa detail yang diberikan dalam Detail Fase. Klik ikon apa pun di alat debug untuk melihat detail langkah yang dipilih, atau gunakan tombol Berikutnya/Kembali untuk berpindah dari satu langkah ke langkah lainnya.

UI Konsol Cloud

Debug v2 (baru)

Debug v1

UI Klasik

UI Konsol Cloud

Debug v2 (baru)

Langkah-langkah transaksi, untuk permintaan dan respons, dikelompokkan berdasarkan cara konfigurasinya sebelumnya di tab Develop; berdasarkan alur bersama. Misalnya: pra-proxy, pasca-proxy, pra-target, dan pasca-target.

Setiap pengelompokan menampilkan kebijakan, persyaratan, alur bersama, dan informasi alur yang relevan dengan jelas.

Alur bersama dikelompokkan dan diciutkan secara default.

Tindakan berikut tersedia di panel Transaksi:

Item	Nama	Deskripsi
<img <="" alt="collapse all slider" class="screenshot" src="/static/apigee/docs/api-platform/debug/images/collapse_all_slider.png" td="" width="" />	Luaskan semua Ciutkan semua	Luaskan atau ciutkan semua grup.
	Luaskan Ciutkan	Luaskan atau ciutkan grup.

Lihat juga:

• Zoom
• Memilih opsi tampilan di UI

Debug v1

Memperluas dan menciutkan grup tidak tersedia dalam versi ini.

UI Klasik

Memperluas dan menciutkan grup tidak tersedia dalam versi ini.

UI Konsol Cloud

Debug v2 (baru)

Penelusuran memungkinkan Anda menemukan kata atau frasa dalam permintaan atau respons.

Perhatikan hal berikut:

• Penelusuran tidak peka huruf besar/kecil
• Penelusuran berlaku untuk satu transaksi; artinya, penelusuran tidak menelusuri semua transaksi di seluruh sesi proses debug.
• Penelusuran memperluas bagian yang diciutkan, tetapi tidak menampilkan informasi tentang node yang difilter berdasarkan pilihan Opsi Tampilan.

Untuk menelusuri:

1. Ketik teks di kotak penelusuran.

2. Tekan Enter.

   Hasil penelusuran disorot di panel Transaksi dan di panel Detail Fase.

3. Klik keyboard_arrow_up Kembali atau keyboard_arrow_down Berikutnya untuk berpindah ke langkah berikutnya atau sebelumnya.

Debug v1

Penelusuran tidak tersedia dalam versi ini.

UI Klasik

Penelusuran tidak tersedia dalam versi ini.

UI Konsol Cloud

Debug v2 (baru)

Zoom mengontrol tampilan panel Transaksi sebagai berikut:

Ikon	Deskripsi
100%	Tingkat zoom saat ini. Setelan defaultnya adalah 100%.
fit_screen	Paskan dengan layar
zoom_in	Perbesar
zoom_out	Perkecil
youtube_searched_for	Reset zoom

Debug v1

Zoom tidak tersedia dalam versi ini.

UI Klasik

Zoom tidak tersedia dalam versi ini.

UI Konsol Cloud

Saat Anda membuat sesi debug di UI, di daftar drop-down Filter, Anda dapat memilih filter yang telah ditentukan untuk diterapkan di panel Mulai sesi debug atau memilih Filter Kustom dan membuat filter Anda sendiri dengan sintaksis filter.

UI Klasik

Saat Anda membuat sesi debug di UI, di daftar drop-down Filter, Anda dapat memilih filter yang telah ditentukan sebelumnya untuk diterapkan di panel Mulai sesi debug atau memilih Filter Kustom dan membuat filter Anda sendiri dengan sintaksis filter.

API

Untuk membuat sesi debug dengan filter menggunakan API, sertakan hal berikut sebagai payload dalam permintaan pembuatan sesi debug Anda:

{
  "filter":"filter_body"
}

Untuk mengetahui informasi tentang cara membuat filter, lihat Sintaksis filter.

Contoh berikut membuat sesi debug yang hanya menyertakan transaksi yang header A-nya sama dengan 42 dan header B-nya sama dengan 43, atau kode errornya adalah ExpectedEOF:

curl -H "Authorization: Bearer $TOKEN" -X "POST"
  https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/apis/PROXY/revisions/REV/debugsessions
  -d ' {
    "filter":"(request.header.A == '42' && request.header.B == '43') || fault.code == 'jsonparser.ExpectedEOF'"
  } '

Anda hanya dapat menentukan filter dalam permintaan pembuatan sesi debug; Anda tidak dapat menambahkan filter ke sesi debug yang ada, dan Anda tidak dapat menghapus filter dari sesi debug yang aktif.

UI Konsol Cloud

UI Klasik

Untuk melihat sesi debug menggunakan Editor Proxy Klasik:

1. Login ke UI Apigee.
2. Pilih API Proxies dari tampilan utama.
3. Pilih proxy yang ingin Anda debug.
4. Klik tab Debug di kanan atas tampilan Deployments.
5. Di panel Sesi debug terbaru:
   1. Dari menu drop-down Env, pilih lingkungan proxy API yang sesi penelusurannya ingin Anda lihat.
   2. Dari menu drop-down Rev, pilih nomor revisi proxy API yang sesi pen-debug-annya ingin Anda lihat.

   UI Apigee menampilkan daftar sesi debug yang tersedia.

6. Klik link untuk sesi yang ingin Anda lihat.

   UI Apigee memuat sesi debug dan mengisi panel Send Requests dengan data debug.

API

Dengan menggunakan API, Anda dapat:

• Melihat semua sesi debug
• Melihat semua transaksi untuk sesi debug
• Melihat data transaksi untuk sesi debug

Melihat semua sesi debug menggunakan API

Untuk melihat semua sesi debug terbaru yang ditentukan untuk revisi proxy API di lingkungan, kirim permintaan GET ke resource berikut:

https://apigee.googleapis.com/v1/organizations/org/environments/env/apis/api/revisions/rev/debugsessions

Secara opsional, Anda dapat menentukan salah satu parameter kueri berikut untuk mengontrol jumlah data yang ditampilkan:

• pageSize: Jumlah maksimum sesi debug yang akan dicantumkan. Ukuran halaman default adalah 25.
• pageToken: Token halaman, yang ditampilkan dari panggilan sebelumnya, yang dapat Anda gunakan untuk mengambil halaman berikutnya.

Contoh berikut menunjukkan cara melihat sesi debug untuk revisi 1 proxy API helloworld di lingkungan test.

curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/apis/helloworld/revisions/1/debugsessions" \
-X GET \
-H "Authorization: Bearer $TOKEN"

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk mengetahui deskripsi variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Respons mencakup objek sessions yang berisi daftar sesi debug yang sedang aktif, seperti yang ditunjukkan dalam contoh berikut:

{
"sessions": [
{
"id": "a423ac73-0902-4cfa-4242-87a353a84d87",
"timestamp_ms": 1566330186000
},
{
"id": "f1eccbbe-1fa6-2424-83e4-3d063b47728a",
"timestamp_ms": 1566330286000
}
]
}

Hanya sesi debug yang berisi setidaknya satu transaksi yang disertakan dalam respons; sesi debug yang tidak memiliki transaksi tidak disertakan dalam daftar ini.

Untuk mengetahui informasi selengkapnya, lihat List Debug sessions API.

Melihat semua transaksi untuk sesi debug menggunakan API

Untuk melihat daftar transaksi untuk sesi debug, kirim permintaan GET ke resource berikut:

https://apigee.googleapis.com/v1/organizations/org/environments/env/apis/api/revisions/rev/debugsessions/debugsession/data

Dengan debugsession adalah ID sesi debug yang ditampilkan saat Anda melihat sesi debug.

Contoh berikut menunjukkan cara melihat transaksi untuk sesi debug untuk revisi 1 helloworld API di lingkungan test.

curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/apis/helloworld/revisions/1/debugsessions/a423ac73-0902-4cfa-4242-87a353a84d87/data" \
-X GET \
-H "Authorization: Bearer $TOKEN"

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk mengetahui deskripsi variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Respons mencakup array ID transaksi, seperti yang ditunjukkan dalam contoh berikut:

[
"myorg-test-ver-5qxdb-64",
"myorg-test-ver-5qxdb-65",
"myorg-test-ver-5qxdb-66",
"myorg-test-ver-5qxdb-67",
"myorg-test-ver-5qxdb-68",
"myorg-test-ver-5qxdb-69",
"myorg-test-ver-5qxdb-70",
"myorg-test-ver-5qxdb-71",
"myorg-test-ver-5qxdb-72"
]

Untuk mengetahui informasi selengkapnya, lihat List debug session data API.

Melihat data transaksi untuk sesi debug menggunakan API

Untuk melihat data transaksi untuk sesi debug, kirim permintaan GET ke resource berikut:

https://apigee.googleapis.com/v1/organizations/{org}/environments/{env}/apis/{api}/revisions/{rev}/debugsessions/{debugsession}/data/{transactionId}

Dengan debugsession adalah ID sesi debug yang ditampilkan saat Anda melihat sesi debug dan transactionId adalah ID transaksi yang ditampilkan saat Anda Melihat daftar transaksi untuk sesi debug.

Data transaksi yang disimpan selama sesi debug diformat dalam JSON. Anda dapat memuat data ini di alat Debug Offline.

Contoh berikut menunjukkan cara mendownload data transaksi untuk sesi debug untuk revisi 1 helloworld API di lingkungan test.

curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/apis/helloworld/revisions/1/debugsessions/a423ac73-0902-4cfa-4242-87a353a84d87/data/myorg-test-ver-5qxdb-64" \
-X GET \
-H "Authorization: Bearer $TOKEN"

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk mengetahui deskripsi variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Respons terdiri dari payload JSON yang berisi data untuk transaksi yang ditentukan, seperti yang dijelaskan dalam Struktur data download.

Data debug berisi semua informasi tentang permintaan dan respons untuk setiap bagian alur dalam format JSON eksklusif. Anda dapat menyimpan data ini dan menggunakannya nanti di alat Debug Offline.

Jika tidak ada permintaan yang ditambahkan ke sesi sebelum sesi berakhir, respons akan terlihat seperti berikut:

[]

Untuk mengetahui informasi selengkapnya, lihat API untuk mendapatkan data sesi debug.

UI Konsol Cloud

Untuk memilih opsi tampilan sesi debug, pilih atau hapus opsi dari panel Opsi tampilan. Opsi tampilan ini dipertahankan di seluruh sesi debug untuk setiap pengguna.

UI Klasik

Untuk memilih opsi tampilan sesi debug, pilih atau hapus opsi dari panel Opsi tampilan:

UI Konsol Cloud

Debug v2 (baru)

Untuk mendownload sesi debug saat ini di konsol Google Cloud , klik Download di tampilan Debug.

Debug v1

Untuk mendownload sesi debug saat ini di Editor Proxy baru, klik Download Session di panel sebelah kiri tampilan Debug.

Perhatikan bahwa sesi debug akan dihapus dalam waktu 24 jam setelah selesai, jadi jika Anda ingin melihat sesi debug setelah waktu tersebut, Anda harus mendownloadnya sebelum waktu tersebut.

UI Klasik

Untuk mendownload data sesi debug saat ini menggunakan Editor Proxy klasik:

• Sesi aktif: Klik ikon Download ( ) di panel Detail debug.
• Sesi sebelumnya: Klik nama sesi di panel Sesi debug terbaru, seperti yang dijelaskan dalam Melihat sesi debug. Kemudian klik di panel Debug details.

API

Untuk melihat ID semua transaksi untuk sesi debug saat ini menggunakan Apigee API, masukkan perintah berikut:

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/apis/PROXY/revisions/REV/debugsessions/SESSION_ID/data

dengan SESSION_ID adalah ID untuk sesi debug yang ingin Anda download.

Lihat Mencantumkan ID transaksi dari sesi debug.

Untuk mendapatkan data debug transaksi menggunakan Apigee API, masukkan perintah berikut:

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/apis/PROXY/revisions/REV/debugsessions/SESSION_ID/data/TRANSACTION_ID

UI Konsol Cloud

Saat Anda mendownload data menggunakan UI Apigee, struktur data:

• Mencakup semua transaksi dalam seluruh sesi
• Menyimpan transaksi dalam array Messages
• Mencakup metadata tentang sesi (sebagai objek DebugSession)

UI Klasik

Saat Anda mendownload data menggunakan UI Apigee, struktur data:

• Mencakup semua transaksi dalam seluruh sesi
• Menyimpan transaksi dalam array Messages
• Mencakup metadata tentang sesi (sebagai objek DebugSession)

API

Anda tidak dapat menggunakan Apigee API untuk melihat seluruh data sesi sekaligus; Anda hanya dapat menggunakan API untuk melihat data transaksi individual, seperti yang dijelaskan dalam Melihat sesi debug.

Contoh:

{
"completed": true,
"point": [
  ...
...
}

Download contoh data

Contoh berikut menandai objek metadata DebugSession dalam data yang didownload. Objek ini diikuti oleh array Messages yang berisi transaksi dalam sesi.

{
  "DebugSession": {
    "Retrieved": "2019-06-08T13:08:13.395Z",
    "Organization": "myorg",
    "Environment": "prod",
    "API": "myproxy",
    "Revision": "1",
    "SessionId": "a2a271aa-4242-4ac6-97cb-aec8dcb115a9"
  },
  "Messages": [
    {
      "completed": true,
      "point": [
        {
          "id": "Paused"
        },
        {
          "id": "Resumed"
        },
        {
          "id": "StateChange",
          "results": [
            {
              "ActionResult": "DebugInfo",
              "properties": {
                "property": [
                  {
                    "name": "To",
                    "value": "REQ_HEADERS_PARSED"
                  },
                  {
                    "name": "From",
                    "value": "REQ_START"
                  }
                ]
              },
              "timestamp": "8-6-19 13:08:37:718"
            },
            {
              "ActionResult": "RequestMessage",
              "headers": [
                {
                  "name": "accept",
                  "value": "*/*"
                },
                {
                  "name": "accept-encoding",
                  "value": "gzip,gzip,deflate,br"
                },
                {
                  "name": "content-length",
                  "value": "0"
                },
                {
                  "name": "host",
                  "value": "myorg.example.domain.net"
                },
                {
                  "name": "user-agent",
                  "value": "Google-Apigee"
                },
                {
                  "name": "x-b3-sampled",
                  "value": "0"
                },
                {
                  "name": "x-b3-spanid",
                  "value": "d4ee579206759662"
                },
                {
                  "name": "x-b3-traceid",
                  "value": "adc1e171777c237dd4ee579206759662"
                },
                {
                  "name": "x-forwarded-for",
                  "value": "66.102.8.98"
                },
                {
                  "name": "x-forwarded-proto",
                  "value": "https"
                },
                {
                  "name": "x-request-id",
                  "value": "54e05cba-4242-4490-4242-60c45c156f90"
                }
              ],
              "uRI": "/myproxy",
              "verb": "GET"
            }
          ]
        },
        {
          "id": "FlowInfo",
          "results": [
            {
              "ActionResult": "DebugInfo",
              "properties": {
                "property": [
                  {
                    "name": "environment.name",
                    "value": "prod"
                  },
                  {
                    "name": "environment.qualifiedname",
                    "value": "myorg__prod"
                  },
                  {
                    "name": "environment.orgname",
                    "value": "myorg"
                  }
                ]
              },
              "timestamp": "8-6-19 13:08:37:718"
            }
          ]
        },
        {
          "id": "FlowInfo",
          "results": [
            {
              "ActionResult": "DebugInfo",
              "properties": {
                "property": [
                  {
                    "name": "organization.name",
                    "value": "myorg"
                  }
                ]
              },
              "timestamp": "8-6-19 13:08:37:718"
            }
          ]
        },
        {
          "id": "FlowInfo",
          "results": [
            {
              "ActionResult": "DebugInfo",
              "properties": {
                "property": [
                  {
                    "name": "apiproxy.qualifiedname",
                    "value": "myproxy__1"
                  },
                  {
                    "name": "apiproxy.basepath",
                    "value": "/"
                  },
                  {
                    "name": "apiproxy.revision",
                    "value": "1"
                  },
                  {
                    "name": "apiproxy.name",
                    "value": "myproxy"
                  }
                ]
              },
              "timestamp": "8-6-19 13:08:37:718"
            }
          ]
        },
        ...
      ...
    }
  ]
}

Jika sesi debug tidak menyertakan permintaan apa pun, array Message akan kosong, seperti yang ditunjukkan contoh berikut:

{
  "DebugSession": {
    "Retrieved": "2019-06-08T13:08:13.395Z",
    "Organization": "myorg",
    "Environment": "prod",
    "API": "myproxy",
    "Revision": "1",
    "SessionId": "a2a271aa-4242-4ac6-97cb-aec8dcb115a9"
  },
"Messages": []
}

UI Konsol Cloud

Debug v2 (baru)

Untuk menghapus sesi debug di konsol Google Cloud :

1. Di tab Debug, klik baris untuk sesi yang ingin Anda hapus.
2. Di panel Sesi debug, klik delete Hapus.

Debug v1

Untuk menghapus sesi debug di Editor Proxy baru:

1. Pilih baris untuk sesi yang ingin Anda hapus.
2. Klik menu tiga titik di akhir baris, lalu pilih Hapus.

UI Klasik

Klik di panel Detail debug untuk sesi debug.

API

Untuk menghapus semua data sesi debug menggunakan API, kirim permintaan DELETE ke resource berikut:

https://apigee.googleapis.com/v1/organizations/org/environments/env/apis/api/revisions/rev/debugsessions/debugsession/data

Dengan debugsession adalah ID sesi debug yang ditampilkan saat Anda melihat sesi debug.

Contoh berikut menunjukkan cara menghapus data sesi debug untuk revisi 1 helloworld API di lingkungan test.

curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/apis/helloworld/revisions/1/debugsessions/a423ac73-0902-4cfa-4242-87a353a84d87/data" \
      -X DELETE \
      -H "Authorization: Bearer $TOKEN"
    

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk mengetahui deskripsi variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Jika berhasil, isi respons akan kosong.

Data sesi debug hanya dipertahankan selama 24 jam. Jika Anda tidak menghapusnya secara eksplisit sebelum waktu tersebut, Apigee akan menghapusnya untuk Anda.