Cara Memperbaiki Pesan Kesalahan Umum Nginx: Panduan Langkah-demi-Langkah

Bagaimana cara memperbaiki kesalahan NGINX?

Sekarang setelah Anda melihat beberapa kesalahan umum NGINX, Anda mungkin memiliki pertanyaan: 'Bagaimana cara memperbaiki kesalahan NGINX?'

Yah, jawabannya tidak sesulit kelihatannya. Ada berbagai metode pemecahan masalah yang tersedia untuk kesalahan NGINX. Namun, penting untuk dicatat bahwa metode pemecahan masalah ini hanya untuk tahap awal. Investigasi lebih lanjut diperlukan untuk menentukan penyebab pasti dari masalah ini.

Pada dasarnya ada tiga perintah yang dapat membantu Anda memulai perjalanan pemecahan masalah untuk kesalahan NGINX.

• Dapatkan log Kesalahan dan detail masalah menggunakan perintah ini: sudo cat /var/log/nginx/error.log
• Untuk memeriksa status aktif Nginx: sudo systemctl status nginx
• Untuk memeriksa kesalahan sintaks pada file konfigurasi: sudo nginx -t

1. Memecahkan masalah kesalahan Nginx dengan log kesalahan

Saat Anda mengalami masalah dengan NGINX, sebagian besar kesalahan NGINX ini tidak jelas, dan tidak mudah untuk mengetahui masalah yang sebenarnya. Kesalahan dapat dipicu karena masalah yang lebih besar atau mungkin sama sekali tidak terkait.

Ini semua tergantung pada bagaimana Anda mengonfigurasi pengaturan NGINX Anda dan situasi khusus yang Anda hadapi.

Untuk lebih memahami kesalahan NGINX yang terjadi, Anda dapat menjalankan perintah untuk melihat daftar kesalahan ini. Inilah perintahnya:

sudo cat /var/log/nginx/error.log

Untuk menjalankan perintah ini, Anda harus menjadi pengguna yang memiliki hak istimewa. Disarankan untuk memiliki akses sudo daripada menggunakan pengguna root.

Perintah ini memungkinkan Anda untuk membaca seluruh isi file /var/log/nginx/error.log, yang berisi log error NGINX. Ini akan menampilkan log ini di jendela terminal Anda.

Dengan menjalankan perintah ini, Anda akan dapat melihat daftar error NGINX yang telah dicatat. Ingat satu hal jika tidak ada kesalahan yang tercatat di log, Anda tidak akan melihat output apa pun saat menjalankan perintah.

Berikut adalah contoh log kesalahan untuk referensi Anda,

2023/05/31 10:15:23 [error] 1234#0: *1 open() "/var/www/html/missing-page.html"
failed (2: No such file or directory), client: 192.168.0.1, server: example.com,
request: "GET /nonexistent-page HTTP/1.1", host: "example.com"

2023/05/31 12:45:57 [error] 1234#0: *2 upstream timed out (110: Connection timed out)
while reading response header from upstream, client: 192.168.0.2, server:
example.com, request: "GET /api/data HTTP/1.1", upstream:
"http://127.0.0.1:8000/api/data", host: "example.com"

2023/05/31 15:22:10 [error] 1234#0: *3 rewrite or internal redirection cycle while internally redirecting to "/index.php", client: 192.168.0.3, server: example.com, request: "GET /category/products/ HTTP/1.1", host: "example.com"

Dalam contoh ini, setiap baris mewakili kesalahan terpisah yang dicatat oleh NGINX. Mari kita uraikan informasi yang diberikan:

• Stempel waktu: Bagian pertama dari setiap baris menunjukkan tanggal dan waktu saat kesalahan terjadi, diformat sebagai YYYY/MM/DD HH:MM:SS .
• Tingkat Kesalahan: Tag [error] menunjukkan bahwa baris ini menunjukkan kesalahan.
• ID proses: Angka setelah simbol # (mis., 1234#0 ) mewakili ID proses NGINX yang menangani permintaan.
• Pesan Kesalahan: Pesan kesalahan memberikan detail tentang kesalahan tertentu. Ini mencakup informasi seperti kegagalan akses file atau sumber daya, waktu tunggu koneksi upstream, atau masalah pengalihan internal.
• IP Klien: Kolom client menampilkan alamat IP klien yang membuat permintaan ke server.
• Nama Server: Kolom server menunjukkan nama server atau host virtual tempat kesalahan terjadi.
• Detail Permintaan: Bidang request menunjukkan metode HTTP, URL yang diminta, dan versi protokol yang digunakan oleh klien.
• Host: Kolom host menentukan nama host atau alamat IP yang digunakan dalam permintaan.

Setiap entri log kesalahan membantu mendiagnosis dan memecahkan masalah dengan memberikan informasi tentang jenis kesalahan, sumber daya yang terpengaruh, IP klien, dan detail relevan lainnya.

2. Troubleshooting NGINX dengan Memeriksa statusnya

Cara lain yang bisa Anda coba untuk mengatasi masalah NGINX adalah dengan memeriksa statusnya, yaitu aktif atau tidak. Ada kemungkinan karena alasan tertentu, proses penginstalan tidak dapat diselesaikan atau layanan belum aktif.

Untuk memeriksa status layanan NGINX gunakan perintah berikut:

sudo systemctl status nginx

Jika layanan NGINX aktif, hasilnya akan seperti;

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset:
enabled)
Active: active (running) since Mon 2023-05-31 14:30:00 UTC; 5min ago
Docs: http://nginx.org/en/docs/
Process: 1234 ExecStart=/usr/sbin/nginx -g daemon on;
master_process on;
(code=exited, status=0/SUCCESS)
Main PID: 1234 (nginx)
Tasks: 2 (limit: 2319)
Memory: 3.9M
CGroup: /system.slice/nginx.service
├─1234 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
└─5678 nginx: worker process

dan jika status NGINX tidak aktif, output dari perintah sudo systemctl status nginx akan menunjukkan bahwa layanan tidak aktif atau berhenti sebagai berikut.

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: inactive (dead)
Docs: http://nginx.org/en/docs/

Jika demikian, satu-satunya hal yang perlu Anda lakukan adalah me-restart layanan NGINX Anda dengan menggunakan perintah ini:

sudo systemctl restart nginx

Setelah itu, Anda dapat menggunakan perintah status lagi untuk memeriksa apakah layanan NGINX sudah aktif atau tidak.

3. Memecahkan masalah NGINX dengan Memeriksa kesalahan sintaks

Kesalahan sintaks adalah masalah umum yang dapat muncul saat menulis skrip, kode, atau mengonfigurasi file Nginx.

Apakah Anda telah menggunakan struktur sintaks yang salah atau menghilangkan karakter tertentu, sintaks yang salah akan mencegah kode atau konfigurasi berfungsi dengan benar.

Dalam kasus file konfigurasi Nginx, mereka terdiri dari berbagai arahan, yang masing-masing perlu dideklarasikan secara akurat agar berfungsi dengan benar. Jika tidak, itu tidak akan berfungsi sebagaimana dimaksud.

Untuk memeriksa kesalahan sintaks di file konfigurasi Nginx Anda, gunakan perintah berikut.

sudo nginx -t

Jika sintaksnya ternyata benar, hasilnya adalah,

nginx: configuration file /etc/nginx/nginx.conf test is successful

Namun, jika ada masalah dalam sintaks, hasilnya akan ditampilkan sebagai,

nginx: [emerg] unexpected end of file, expecting ";" or "}" in
/etc/nginx/nginx.conf:42
nginx: configuration file /etc/nginx/nginx.conf test failed

Dengan melakukan pemeriksaan ini, Anda dapat mengidentifikasi dan memperbaiki kesalahan sintaks apa pun, menjamin bahwa konfigurasi Nginx Anda akurat dan lengkap. Merupakan praktik yang baik untuk menjalankan perintah ini setiap kali Anda membuat perubahan pada file konfigurasi atau sebelum memulai ulang Nginx untuk menghindari masalah apa pun yang disebabkan oleh kesalahan sintaks.