全部产品
Search
文档中心

Microservices Engine:Konfigurasikan kebijakan pengulangan

更新时间:Jul 06, 2025

Gateway cloud-native memungkinkan Anda mengonfigurasi kebijakan pengulangan pada tingkat rute. Setelah dikonfigurasi, gateway cloud-native dapat secara otomatis mengulang permintaan yang gagal berdasarkan kebijakan tersebut. Dalam kebijakan ini, Anda dapat menentukan kondisi pengulangan seperti koneksi gagal, layanan backend tidak tersedia, atau respons dengan kode status HTTP tertentu.

Kondisi pengulangan

Jika layanan backend mengembalikan kode status 5xx, gateway cloud-native akan secara otomatis mengulang permintaan yang gagal hingga jumlah kali tertentu.

  • Kondisi pengulangan untuk permintaan HTTP:

    • 5xx: Layanan backend mengembalikan kode status 5xx, atau terjadi peristiwa disconnection, reset, atau timeout baca.

      Catatan

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

    • reset: Terjadi peristiwa disconnection, reset, atau timeout baca.

    • connect-failure: Permintaan gagal karena disconnection.

    • refused-stream: Server backend mengembalikan kode status REFUSED_STREAM.

    • retriable-status-codes: Server backend mengembalikan salah satu dari kode status yang ditentukan.

      Catatan

      Anda hanya dapat menentukan kode status jika memilih retriable-status-codes sebagai kondisi pengulangan.

  • Kondisi pengulangan untuk permintaan gRPC:

    • cancelled: Kode status CANCELLED terdapat dalam header respons dari layanan gRPC backend.

    • deadline-exceeded: Kode status DEADLINE_EXCEEDED terdapat dalam header respons dari layanan gRPC backend.

    • internal: Kode status INTERNAL terdapat dalam header respons dari layanan gRPC backend.

    • resource-exhausted: Kode status RESOURCE_EXHAUSTED terdapat dalam header respons dari layanan gRPC backend.

    • unavailable: Kode status UNAVAILABLE terdapat dalam header respons dari layanan gRPC backend.

Konfigurasikan kebijakan pengulangan

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

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

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

  4. Pada tab Routes, temukan aturan routing yang ingin dimodifikasi, dan klik Policies di kolom Actions.

  5. Pada tab Policies, klik Retry.

  6. Pada tab Retry, konfigurasikan parameter dan klik OK.

    Parameter

    Deskripsi

    Retry Times

    Jumlah maksimum pengulangan untuk permintaan yang gagal. Anda dapat menyetel parameter ini ke bilangan bulat mulai dari 0 hingga 10. Kami merekomendasikan agar Anda menyetel parameter ini ke 0, 1, atau 2.

    Catatan

    Jika Anda menyetel parameter ini ke 0, permintaan yang gagal tidak akan diulang.

    Retry Condition

    Kondisi yang memicu pengulangan. Anda dapat memilih satu atau lebih kondisi. Untuk informasi lebih lanjut, lihat bagian "Kondisi pengulangan" dalam topik ini.

    Retry Status Code

    Kode status HTTP yang memicu pengulangan. Anda dapat menentukan satu atau lebih kode status HTTP.

    Catatan

    Parameter ini hanya valid jika Anda memilih retriable-status-codes untuk parameter Retry Condition.Retry Status Code

    Enable

    Menentukan apakah akan mengaktifkan kebijakan pengulangan.

    • Jika Anda menghidupkan sakelar, kebijakan pengulangan akan berlaku.

    • Jika Anda mematikan sakelar, kebijakan pengulangan tidak akan berlaku.

    Catatan

    Jika Anda menonaktifkan kebijakan pengulangan, gateway secara otomatis akan mengulang permintaan yang gagal sebanyak maksimal dua kali berdasarkan kondisi berikut: connect-failure, refused-stream, unavailable, cancelled, dan retriable-status-codes.

    Setelah kebijakan pengulangan dibuat dan diaktifkan, Anda dapat memeriksa apakah kebijakan tersebut sesuai dengan kebutuhan bisnis Anda.