502 Bad Gateway troubleshooting in Nginx - Mini Project: Build & Apply

502 Bad Gateway Troubleshooting with Nginx

📖 Scenario: You are managing a web server using Nginx. Sometimes, users see a 502 Bad Gateway error when trying to access your website. This error means Nginx cannot get a proper response from the backend server.In this project, you will learn how to check the Nginx configuration and backend server status to find and fix the cause of the 502 error.

🎯 Goal: Build a simple troubleshooting process to identify and fix a 502 Bad Gateway error in Nginx by checking configuration and backend server status.

📋 What You'll Learn

Create a variable with the backend server address

Add a variable for the backend server port

Write a command to check if the backend server is running

Write a command to display the Nginx error log for 502 errors

💡 Why This Matters

🌍 Real World

Web servers often use Nginx as a gateway to backend services. When backend services fail or are unreachable, users see 502 errors. Troubleshooting these errors quickly restores website availability.

💼 Career

DevOps engineers and system administrators must know how to diagnose and fix 502 Bad Gateway errors to keep web applications running smoothly.

1

Setup backend server address variable

Create a variable called backend_server and set it to the string "127.0.0.1" which is the IP address of the backend server.

Nginx

# Create a variable called backend_server with value "127.0.0.1"
# Your code here

Need a hint?

Use a simple assignment like backend_server = "127.0.0.1".

2

Add backend server port variable

Add a variable called backend_port and set it to the integer 8080, which is the port number where the backend server listens.

Nginx

backend_server = "127.0.0.1"
# Create a variable called backend_port with value 8080
# Your code here

Need a hint?

Use backend_port = 8080 to set the port number.

3

Check backend server status

Write a command string called check_command that uses curl to check if the backend server is running at backend_server and backend_port. The command should be: curl -s --connect-timeout 2 http://127.0.0.1:8080 using the variables.

Nginx

backend_server = "127.0.0.1"
backend_port = 8080
# Create a variable check_command to check backend server with curl
# Your code here

Need a hint?

Use an f-string to build the curl command with variables.

4

Display Nginx error log for 502 errors

Write a command string called log_command that uses grep to find lines containing 502 in the Nginx error log file located at /var/log/nginx/error.log. The command should be: grep 502 /var/log/nginx/error.log.

Nginx

backend_server = "127.0.0.1"
backend_port = 8080
check_command = f"curl -s --connect-timeout 2 http://{backend_server}:{backend_port}"
# Create a variable log_command to grep 502 errors from Nginx error log
# Your code here

Need a hint?

Use log_command = "grep 502 /var/log/nginx/error.log" to find 502 errors.