Konfigurasikan TTL cache untuk kode status - Edge Security Acceleration

Saat server origin mengembalikan kode status non-2xx, titik keberadaan (POPs) Edge Security Acceleration (ESA) dapat menyimpan cache kode status tersebut. Selama periode validitas cache berlangsung, POPs merespons permintaan secara langsung, sehingga menghindari permintaan berulang ke origin dan mengurangi beban pada server origin.

Skenario

Secara normal, POP ESA menyimpan cache resource saat berhasil mengambilnya dari server origin yang mengembalikan kode status 2xx. Namun, jika server origin mengembalikan kode status non-2xx, seperti 404 atau 502, Anda dapat menghindari pengiriman semua permintaan kembali ke origin dengan mengonfigurasi waktu hidup (TTL) cache untuk kode status tersebut. POP ESA kemudian akan langsung merespons dengan kode status tersebut, sehingga mengurangi beban pada server origin Anda.

Skema tipikal

File A telah dihapus dari server origin, tetapi klien terus mengaksesnya. Karena POP ESA belum menyimpan cache File A, semua permintaan untuk File A dikirim ke server origin. Server origin kemudian merespons dengan kode status 404, yang secara signifikan meningkatkan beban pada server origin.

Jika Anda mengonfigurasi POP ESA untuk menyimpan cache kode status 404, POP tersebut akan menyimpannya setelah pengambilan asal pertama. Selama periode validitas cache berlangsung, permintaan berikutnya akan menerima respons 404 langsung dari POP ESA, sehingga menghindari pengambilan asal dan mengurangi beban pada server origin.

Prosedur

Di Konsol ESA, pilih Site Management. Di kolom Website, klik situs target.
Di panel navigasi sebelah kiri, pilih Rules > Cache Rules.
Klik Create Rule dan masukkan Rule Name.
Di area If requests match..., atur atribut permintaan yang sesuai. Untuk informasi lebih lanjut tentang konfigurasi aturan, lihat Composition of rule expressions.
Di area Edge Cache TTL, klik Configure.
Klik Add untuk Status Code Cache TTL. Konfigurasikan parameter berikut, lalu klik OK:
- Status Code: Kode status HTTP yang akan disimpan dalam cache. Mendukung kode status 4xx (kesalahan klien) dan 5xx (kesalahan sisi server), seperti 404, 502, dan 503.
- Expired At: Periode penyimpanan kode status dalam cache oleh POP. Nilainya berkisar antara 1 detik hingga 31.536.000 detik (1 tahun). Setelah TTL berakhir, POP akan mengambil ulang kode status dari server origin.

Contoh konfigurasi

Skema 1: Simpan cache error 404 untuk resource statis

Kebutuhan bisnis: Gambar di folder gambar website mungkin telah dihapus, tetapi halaman antarmuka depan masih mereferensikan path lama.

Konfigurasi:

Kondisi pencocokan: Path URL berisi /images
Kode status: 404
TTL cache: 600 detik (10 menit)

Hasil: Saat permintaan pertama untuk gambar yang tidak ada dilakukan, POP mengambil respons 404 dari origin dan menyimpannya dalam cache selama 10 menit. Selama 10 menit berikutnya, permintaan berikutnya untuk gambar yang sama akan menerima respons 404 langsung dari POP tanpa perlu mengambil dari origin.

Skema 2: Cache jangka pendek saat server origin gagal

Kebutuhan bisnis: Server origin kadang-kadang tidak tersedia dalam waktu singkat dan mengembalikan error 5xx. Anda ingin memulihkan layanan dengan cepat.

Konfigurasi:

Kondisi pencocokan: All Requests
Kode status: 5xx
Cache TTL: 60 detik (1 menit)

Hasil: Saat server origin gagal, POP menyimpan cache kode status 5xx selama 1 menit. Hal ini mencegah banyak permintaan ke origin yang dapat meningkatkan beban pada server origin. Setelah 1 menit, POP akan mengambil ulang dari origin untuk memeriksa apakah server telah pulih.

Verifikasi konfigurasi

Setelah menyelesaikan konfigurasi, gunakan metode berikut untuk memverifikasi bahwa konfigurasi telah berlaku.

Metode 1: Gunakan perintah curl

Bersihkan cache lokal dan kirim permintaan pertama:
```
curl -I https://example.com/non-existent-page
```
Header respons harus berisi x-site-cache-status: MISS. Ini menunjukkan pengambilan asal pertama.
Segera minta kembali URL yang sama:
```
curl -I https://example.com/non-existent-page
```
Header respons harus berisi x-site-cache-status: HIT, yang menunjukkan adanya cache hit. Nilai bidang yang menunjukkan durasi cache juga akan bertambah secara otomatis.

Metode 2: Gunakan alat developer browser

Buka Chrome DevTools (tekan F12), beralih ke tab Network, dan centang Preserve log.
Akses resource yang tidak ada, misalnya https://example.com/test404.
Lihat Response Headers di detail permintaan. Permintaan pertama menampilkan x-site-cache-status: MISS. Permintaan berikutnya menampilkan x-site-cache-status: HIT, dan nilai bidang yang menunjukkan durasi cache akan bertambah secara otomatis.

FAQ

Mengapa permintaan masih dikirim ke server origin setelah konfigurasi?

Cache telah kedaluwarsa: Periksa apakah nilai TTL yang dikonfigurasi terlalu singkat. Anda dapat memeriksa header respons seperti Cache-Control untuk mengonfirmasi masa hidup cache.
Parameter URL berbeda: Secara default, parameter URL yang berbeda dianggap sebagai kunci cache yang berbeda. Konfigurasikan aturan kunci cache untuk mengabaikan parameter yang tidak relevan.
Aturan belum berlaku: Verifikasi kondisi pencocokan aturan, seperti pola path, untuk memastikan mencakup permintaan target.

Bagaimana cara memverifikasi status cache untuk URL tertentu?

Anda dapat menggunakan perintah curl untuk melihat header respons secara detail:

curl -v -I https://example.com/target-url

Header respons utama:

x-site-cache-status: HIT — Cache hit
x-site-cache-status: MISS — Cache miss, pengambilan asal dilakukan
Cache-Control:max-age=120 — Cache telah aktif selama 120 detik

Bagaimana cara membersihkan cache secara manual untuk kode status tertentu?

Anda dapat melakukan refresh cache berdasarkan URL atau berdasarkan folder.

Referensi

Fitur terkait aturan memiliki variasi dalam execution priority, rule behavior, dan configuration scope. Untuk informasi lebih lanjut, lihat How ESA rules take effect.