All Products
Search
Document Center

Edge Security Acceleration:Mulai dengan membuat ruang tunggu

Last Updated:Jul 15, 2026

Fitur Waiting Room mengantrekan trafik berlebih di edge saat permintaan melebihi kapasitas server origin Anda, melindunginya dari kelebihan beban selama penjualan kilat atau acara bertrafik tinggi sekaligus menampilkan perkiraan waktu tunggu kepada pengguna.

Konfigurasikan ruang tunggu dasar untuk penjualan kilat dalam 5 menit

Asumsikan server origin Anda dapat menangani hingga 300 pengguna aktif secara bersamaan. Konfigurasikan ruang tunggu untuk halaman penjualan kilat di promo.example.com/flash-sale guna melindunginya.

Prosedur

  1. Di Konsol ESA, pilih Websites, lalu klik situs target di kolom Website.

  2. Di panel navigasi sebelah kiri, pilih Traffic > Waiting Room.

  3. Di area Waiting Room, klik Create Waiting Room. Isi parameter inti berikut:

    • Waiting Room Name: flash-sale-room

    • Hostname and Path: promo.example.com/flash-sale

      • Subdomain: promo

      • Path: flash-sale

    • Custom Cookie: __aliwaitingroom_flash_sale (node ESA merespons klien dengan bidang Set-Cookie, yaitu kredensial antrean ruang tunggu yang digunakan untuk mengidentifikasi dan melacak status antrean setiap pengguna. Klien harus menyimpan cookie khusus ruang tunggu ini dan menyertakannya dalam semua permintaan berikutnya ke node ESA.)

    • Total Active Users: 300 (sesuaikan dengan kapasitas konkuren origin Anda)

    • New Users per Minute: 300 (mengizinkan semua pengguna masuk dengan cepat saat acara dimulai)

    • Session Duration: 5

Verifikasi hasil

Ruang tunggu diaktifkan secara default. Saat jumlah pengguna aktif di promo.example.com/flash-sale melebihi batas Total Active Users sebesar 300, pengguna tambahan akan melihat halaman tunggu beserta perkiraan waktu tunggunya.

image

Buat ruang tunggu

Ikuti langkah-langkah berikut untuk kontrol yang lebih rinci.

Langkah 1: Waiting Room Settings

Pada langkah ini, konfigurasikan informasi dasar, kapasitas, dan laju admisi ruang tunggu Anda.image

Basic Information

Parameter

Deskripsi

Waiting Room Name

Tetapkan nama yang mudah dikenali, seperti promo_activity_room.

Hostname and Path

URL eksak tempat ruang tunggu aktif. Hanya berlaku untuk Subdomain dan Path yang ditentukan. Contoh: Jika hostname adalah event.example.com dan path-nya adalah /route, ruang tunggu hanya berlaku untuk permintaan ke event.example.com/route.

Custom Cookie

Node ESA merespons klien dengan bidang Set-Cookie (kredensial antrean ruang tunggu yang digunakan untuk mengidentifikasi dan melacak status antrean setiap pengguna). Klien harus menyimpan cookie khusus ruang tunggu ini dan menyertakannya dalam semua permintaan berikutnya ke node ESA. Nama cookie memiliki awalan tetap __aliwaitingroom_. Sesuaikan akhirannya. Contoh: __aliwaitingroom_promo_user.

Waiting Room Settings

image

Parameter

Deskripsi

Total Active Users

Tujuan: Jumlah maksimum pengguna konkuren yang diizinkan di server origin.

Deskripsi: Tetapkan berdasarkan kapasitas konkuren aktual origin Anda. Saat pengguna aktif mencapai ambang batas ini, permintaan baru akan masuk antrean.

Catatan: Nilai minimum adalah 200. Jika origin Anda menangani kurang dari 200 pengguna konkuren, atur nilai ini menjadi 200 dan gunakan New Users per Minute untuk mengontrol laju admisi.

New Users per Minute

Tujuan: Jumlah maksimum pengguna baru yang diizinkan masuk dari antrean per menit. Mengontrol laju pertumbuhan beban.

Deskripsi: Menentukan kecepatan pemrosesan antrean. Misalnya, jika diatur ke 300, hingga 300 pengguna dapat masuk dari halaman tunggu per menit.

Catatan: Nilai minimum adalah 200. Nilai ini harus kurang dari atau sama dengan Total Active Users.

Session Duration

Tujuan: Durasi sesi pengguna tetap valid setelah meninggalkan antrean.

Deskripsi: Jika pengguna meninggalkan origin (misalnya, dengan menutup halaman) dan kembali dalam periode ini, mereka melewati antrean. Default: 5 menit.

Disable Session Renewal

Tujuan: Apakah pengatur waktu sesi pengguna direset selama penjelajahan aktif.

Catatan: Nama toggle ini berlawanan dengan efeknya:

  • Off (Default): Mengaktifkan perpanjangan sesi. Pengguna aktif mempertahankan sesinya dan tidak dimasukkan kembali ke antrean. Cocok untuk sebagian besar skenario.

  • On: Menonaktifkan perpanjangan sesi. Pengatur waktu sesi dimulai saat pengguna memasuki origin dan tidak direset. Setelah kedaluwarsa, pengguna kembali ke antrean meskipun masih menjelajah. Cocok untuk kontrol durasi kunjungan yang ketat, seperti penjualan kilat.

Queuing Method

Kebijakan untuk mengizinkan pengguna masuk dari antrean.

  • FIFO: Mengizinkan pengguna masuk sesuai urutan permintaan. Direkomendasikan sebagai default.

  • Random: Memilih pengguna secara acak dari antrean. Cocok untuk undian atau skenario di mana urutan tidak penting.

  • Reject All: Mengarahkan semua pengguna baru ke halaman tunggu tanpa mengizinkan siapa pun masuk. Berguna untuk pemanasan pra-acara, maintenance, atau keadaan darurat.

  • Passthrough: Semua permintaan melewati antrean dan langsung menuju origin. Secara efektif menonaktifkan ruang tunggu. Gunakan untuk mengembalikan akses normal setelah acara atau untuk pengujian.

Langkah 2: Custom Settings

Konfigurasikan konten halaman atau respons API yang dilihat pengguna yang sedang dalam antrean.image

Parameter

Deskripsi

Type

Default Waiting Room: Halaman tunggu bawaan sistem yang menampilkan perkiraan waktu tunggu. Anda dapat memilih Default Language Template (English, Simplified Chinese, atau Traditional Chinese).

Custom Waiting Room: Memungkinkan Anda mengunggah halaman HTML kustom. Untuk menggunakan fitur ini, hubungi perwakilan penjualan Anda.

  • Anda dapat mengedit templat atau langsung mengimpor file .html (ukuran maksimal 50 KB).

  • Anda dapat menggunakan variabel dinamis (seperti ${waitTime}) dalam HTML untuk menampilkan informasi antrean.

Preview

Pratinjau halaman tunggu dalam berbagai kondisi, seperti Queuing atau Queue All.

JSON Response

Tujuan: Menyediakan status antrean terstruktur untuk klien non-browser (aplikasi, program mini).

Aktifkan toggle ini. Saat permintaan menyertakan header Accept: application/json, ESA mengembalikan status antrean dalam format JSON alih-alih halaman HTML. Deskripsi parameter respons JSON.

Alur interaksi:

  1. Permintaan pertama: Akses URL target dengan header Accept: application/json.

  2. Ambil dan simpan cookie: Node ESA merespons klien dengan bidang Set-Cookie (kredensial antrean ruang tunggu yang digunakan untuk mengidentifikasi dan melacak status antrean setiap pengguna). Klien harus menyimpan cookie khusus ruang tunggu ini dan menyertakannya dalam semua permintaan berikutnya ke node ESA.

  3. Polling status: Sertakan cookie dalam setiap permintaan. Lakukan permintaan ulang ke URL dengan interval yang ditentukan oleh bidang refreshIntervalSeconds dalam badan respons.

  4. Akses origin: Saat nilai inWaitingRoom berubah menjadi false, klien telah keluar dari antrean dan dapat mengakses sumber daya origin dengan cookie tersebut.

Contoh respons:

{
  "WaitingRoom": {
    "inWaitingRoom": true,
    "waitTime": 5,
    "waitTimeKnown": true,
    "waitTimeFormatted": "5 minutes",
    "queueIsFull": false,
    "queueAll": false,
    "lastUpdated": "2024-09-10T12:00:00.000Z",
    "refreshIntervalSeconds": 20
  }
}

Queuing Status Code

Kode status HTTP yang dikembalikan kepada pengguna yang sedang dalam antrean. Default: 200. Ubah ke kode lain seperti 202 jika diperlukan.

Langkah 3: Review

  1. Halaman Review menampilkan semua pengaturan dari Langkah 1 dan Langkah 2 dalam tampilan read-only. Setelah mengonfirmasi parameter, klik OK untuk membuat ruang tunggu.

    image

  2. Ruang tunggu diaktifkan secara default setelah dibuat.

    image

  3. Aktifkan atau nonaktifkan toggle Queue All sesuai kebutuhan:

    • Off (default): Permintaan berlebih masuk antrean saat ambang batas Total Active Users dan New Users per Minute tercapai.

    • On: Semua pengunjung baru harus masuk antrean. Gunakan untuk peluncuran produk atau acara terjadwal.

      Catatan
      • Pengguna aktif melanjutkan sesinya dan tidak dimasukkan kembali ke antrean hingga sesinya kedaluwarsa.

      • Queue All mengesampingkan semua pengaturan ruang tunggu lainnya, termasuk pengaturan acara.

    image

Langkah selanjutnya

Sebagai pengguna Enterprise, Anda dapat menggunakan fitur lanjutan berikut:

  • Scheduled waiting room events: Sesuaikan parameter kapasitas dan laju pada waktu yang telah ditentukan untuk menangani lonjakan dan penurunan trafik yang dapat diprediksi.

  • Waiting room bypass rules: Izinkan permintaan tertentu melewati antrean berdasarkan kondisi IP, header, atau cookie.