Microservices Engine:Konfigurasikan kebijakan retry

Prasyarat

• Instans cloud-native gateway telah dibuat.

• Setidaknya satu rute telah dikonfigurasi untuk gateway tersebut.

Kondisi retry rute

Ketika permintaan ke layanan backend gagal, cloud-native gateway dapat secara otomatis mencoba ulang permintaan tersebut berdasarkan kondisi yang Anda konfigurasi. Kondisi retry bersifat spesifik terhadap protokol. Daftar berikut menjelaskan kondisi yang tersedia untuk protokol HTTP dan gRPC.

• Kondisi retry berikut tersedia untuk protokol HTTP:

  • 5xx: Cloud-native gateway mencoba ulang permintaan yang gagal jika layanan backend mengembalikan respons 5xx apa pun, atau jika terjadi disconnection, reset, atau read timeout.

    Catatan

    Kondisi 5xx mencakup kondisi connect-failure dan refused-stream.

  • reset: Cloud-native gateway mencoba ulang permintaan yang gagal jika terjadi disconnection, reset, atau read timeout.

  • connect-failure: Cloud-native gateway mencoba ulang permintaan yang gagal jika permintaan gagal karena disconnection.

  • refused-stream: Cloud-native gateway mencoba ulang permintaan yang gagal jika layanan backend mereset aliran dengan kode kesalahan REFUSED_STREAM.

  • retriable-status-codes: Cloud-native gateway mencoba ulang permintaan jika kode status HTTP dalam respons dari layanan backend sesuai dengan kode status retry yang Anda tentukan.

    Catatan

    Anda hanya dapat menggunakan kode status retry jika Anda menentukan retriable-status-codes sebagai kondisi retry.

• Kondisi retry berikut tersedia untuk protokol gRPC:

  • cancelled: Cloud-native gateway mencoba ulang permintaan jika kode status gRPC dalam header respons layanan gRPC backend adalah cancelled.

  • deadline-exceeded: Cloud-native gateway mencoba ulang permintaan jika kode status gRPC dalam header respons layanan gRPC backend adalah deadline-exceeded.

  • internal: Cloud-native gateway mencoba ulang permintaan jika kode status gRPC dalam header respons layanan gRPC backend adalah internal.

  • resource-exhausted: Cloud-native gateway mencoba ulang permintaan jika kode status gRPC dalam header respons layanan gRPC backend adalah resource-exhausted.

  • unavailable: Cloud-native gateway mencoba ulang permintaan jika kode status gRPC dalam header respons layanan gRPC backend adalah unavailable.

Konfigurasikan kebijakan retry rute

1. Masuk ke Konsol MSE. Di bilah navigasi atas, pilih Wilayah.

2. Di panel navigasi sebelah kiri, pilih Cloud-native Gateway > Gateways. Di halaman Gateways, klik ID gateway tersebut.

3. Di panel navigasi sebelah kiri, klik Routes. Lalu, klik tab Routes.

4. Temukan rute yang ingin Anda ubah, lalu klik Policies di kolom Actions.

5. Di tab Policies, klik Retry.

6. Konfigurasikan parameter dalam aturan Retry, lalu klik Save.

   Parameter	Deskripsi
   Retry Times	Jumlah maksimum percobaan ulang untuk permintaan yang gagal. Nilai yang valid: 0 hingga 10. Disarankan untuk menggunakan nilai tidak lebih dari 2. Catatan Nilai 0 menonaktifkan retry.
   Retry Condition	Pilih kondisi retry yang sesuai dengan workload Anda. Anda dapat memilih beberapa kondisi, yang dijelaskan di Kondisi retry rute.
   Retry Status Code	Tentukan kode status HTTP yang responsnya akan dicoba ulang. Anda dapat mengonfigurasi beberapa kode status HTTP. Catatan Anda harus menentukan retriable-status-codes untuk Retry Condition sebelum dapat mengonfigurasi Retry Status Code.
   Enable	Sakelar aktif/nonaktif untuk kebijakan retry rute. Enable: Kebijakan retry rute gateway berlaku. Disable: Kebijakan retry rute kustom tidak berlaku. Catatan Setelah Anda menonaktifkan kebijakan retry kustom, gateway akan kembali ke konfigurasi retry default internalnya. Jumlah retry default adalah 2, dan kondisi retry defaultnya adalah connect-failure, refused-stream, unavailable, cancelled, dan retriable-status-codes.

   Setelah Anda mengonfigurasi dan mengaktifkan kebijakan retry, kirim permintaan uji ke rute tersebut dan verifikasi bahwa permintaan yang gagal dicoba ulang sesuai dengan kondisi dan jumlah retry yang telah dikonfigurasi.