Error 502 pada website sekolah sering muncul saat jam sibuk, lalu hilang sendiri. Gejala itu biasanya bukan tanda server kurang tenaga, melainkan proses PHP yang kehabisan ruang atau antrean yang salah ukuran.
Tuning PHP-FPM adalah pekerjaan mengukur, bukan menyalin angka dari panduan. Nilai yang cocok untuk satu server belum tentu cocok untuk server lain dengan aplikasi berbeda.
Yang perlu diingat
- Hitung jumlah worker dari RAM yang tersedia dan rata-rata memori per proses.
- Pantau antrean dan proses aktif sebelum menaikkan batas, karena worker berlebih bisa memicu swap.
- Ubah satu parameter pada satu waktu dan catat hasilnya.
PHP-FPM mengelola kumpulan proses yang menangani permintaan PHP. Jika semua proses sibuk, permintaan baru menunggu. Jika antrean penuh, web server mengembalikan error. Dari luar, gejalanya mirip: halaman tidak bisa dibuka.
Menambah worker terdengar seperti solusi, tetapi setiap worker memakai memori. Di server kecil, terlalu banyak worker justru membuat sistem kehabisan RAM dan membunuh proses secara acak.
Baca kondisi sebelum mengubah
Aktifkan halaman status PHP-FPM dan pantau jumlah proses aktif, idle, serta antrean. Jika proses aktif sering menyentuh batas sementara antrean panjang, ada dua kemungkinan: permintaan terlalu banyak atau setiap permintaan terlalu lama.
Periksa juga log lambat. Satu plugin yang memakan waktu lama bisa memenuhi semua worker meski trafiknya biasa saja. Menambah worker untuk kasus seperti ini hanya memperbanyak proses yang menunggu.
Halaman status sebaiknya hanya bisa diakses dari localhost atau jaringan tepercaya. Informasi tentang proses dan antrean berguna untuk diagnosis, tetapi tidak perlu terbuka untuk umum.
Hitung worker dari RAM
Ukur memori rata-rata per proses PHP. Caranya bisa dengan memantau proses saat beban normal, bukan saat kosong. Setelah itu, sisihkan RAM untuk sistem, database, dan cache, lalu bagi sisanya dengan angka tersebut.
Misalnya, server memiliki RAM yang sebagian sudah dipakai database dan sistem. Jika sisa yang aman untuk PHP hanya sekitar beberapa ratus megabyte dan satu proses memakai puluhan megabyte, jumlah worker yang masuk akal jauh lebih kecil daripada angka bawaan yang besar.
Perhitungkan juga lonjakan. Aplikasi yang memuat laporan atau impor data bisa memakai memori jauh lebih besar daripada halaman biasa. Batas memori per proses harus menampung kebutuhan itu, atau pekerjaan tersebut dijalankan terpisah.
Pilih model manajemen proses
Model dinamis menyesuaikan jumlah proses dengan beban. Model statis menyiapkan jumlah tetap. Untuk server kecil dengan beban stabil, statis bisa lebih mudah diprediksi. Untuk beban naik-turun, dinamis lebih hemat.
Perhatikan parameter jumlah proses maksimum dan proses idle yang dipertahankan. Nilai yang terlalu agresif membuat proses dibuat dan dihancurkan terus-menerus; nilai yang terlalu longgar menahan memori yang tidak terpakai.
Atur juga jumlah permintaan sebelum satu proses didaur ulang. Daur ulang membantu membatasi kebocoran memori kecil, tetapi terlalu sering membuat proses baru terus dibuat. Nilai yang wajar berbeda untuk setiap aplikasi.
Memory limit, eksekusi, dan opcache
Batas memori PHP harus cukup untuk tugas terberat yang sah, tetapi tidak berlebihan. Batas besar membuat satu permintaan bermasalah bisa menghabiskan RAM. Batas kecil membuat impor atau unggahan gagal di tengah jalan.
Naikkan batas hanya untuk situs atau proses yang membutuhkan, bukan untuk semua akun. Jika memakai panel, atur per akun agar satu situs tidak memengaruhi yang lain.
Untuk WordPress, batas memori di konfigurasi PHP dan batas di aplikasi perlu selaras. Jika aplikasi meminta lebih besar daripada batas server, ia akan berhenti di tengah tugas tanpa pesan yang jelas bagi pengguna.
Opcache menyimpan kode yang sudah dikompilasi. Pastikan memori cukup untuk berkas yang sering dipakai. Jika cache penuh, berkas dibuang dan dikompilasi ulang, sehingga manfaatnya berkurang.
Setelah mengubah konfigurasi, muat ulang PHP-FPM. Perubahan pada opcache tidak selalu langsung terlihat sampai proses lama diganti.
Menangani 502 dan 504
502 biasanya berarti web server tidak mendapat respons dari PHP-FPM, misalnya karena proses mati atau antrean penuh. 504 berarti permintaan menunggu terlalu lama. Keduanya perlu dilihat bersama log, bukan hanya dari kode error.
Periksa apakah proses dibunuh karena memori, apakah ada worker yang macet, dan apakah database menjadi lambat. Menambah batas waktu tanpa memperbaiki penyebab hanya memindahkan keluhan.
Batas waktu antara web server dan PHP-FPM juga perlu diperiksa. Jika web server menyerah lebih dulu daripada aplikasi selesai, pengunjung melihat error meski pekerjaan di latar belakang tetap berjalan.
Ubah bertahap
Catat nilai sebelum perubahan dan ukur setelahnya pada jam yang sebanding. Ubah satu parameter, lalu beri waktu beberapa hari. Perubahan bertahap membuat penyebab perbaikan atau kemunduran bisa diketahui.
Pantau antrean, memori tersedia, dan error setelah perubahan. Jika antrean turun tetapi swap naik, perubahan belum sepenuhnya berhasil. Keseimbangan antara jumlah worker dan memori adalah inti dari tuning ini.
Tuning yang baik membuat situs stabil pada beban normal dan tetap bisa dijelaskan saat beban naik. Angka yang terlihat bagus di dasbor tidak berguna jika tidak diuji dengan pola trafik nyata.
Layanan yang berkaitan
Jika Anda ingin menerapkan panduan ini tanpa mengerjakan sendiri, tim Abyfine bisa membantu.
Tim teknis Abyfine Intermedia di Cilacap. Kami membangun dan merawat website, server, serta jaringan untuk sekolah, UMKM, dan instansi sejak 2004.