Nginx/Apache 에러 로그 분석으로 서버 문제 진단하기

액세스 로그는 요청 기록이지만, 에러 로그는 서버 내부에서 발생한 문제를 기록합니다. 500 에러의 원인, PHP 오류, 파일 권한 문제 등 서비스 장애의 근본 원인은 에러 로그에서 찾을 수 있습니다.

---

에러 로그 파일 위치

---

Nginx 에러 로그 구조

`` 2024/10/10 14:05:22 [error] 12345#12345: *678 open() "/var/www/html/favicon.ico" failed (2: No such file or directory), client: 192.0.2.100, server: example.com, request: "GET /favicon.ico HTTP/1.1", host: "example.com" `

---

주요 에러 유형

1. 파일 없음 (404)

` open() "/var/www/html/missing.jpg" failed (2: No such file or directory) `

원인: 링크된 파일이 실제로 없음 해결: 파일 업로드 또는 링크 수정

2. 권한 거부 (403)

` open() "/var/www/html/admin/config.php" failed (13: Permission denied) `

원인: Nginx 프로세스(www-data)가 파일 읽기 권한 없음 해결:

`bash sudo chown -R www-data:www-data /var/www/html sudo chmod -R 755 /var/www/html `

3. FastCGI 연결 실패 (502)

` connect() to unix:/run/php/php8.2-fpm.sock failed (2: No such file or directory) `

원인: PHP-FPM 서비스가 중단됨 해결:

`bash sudo systemctl status php8.2-fpm sudo systemctl start php8.2-fpm `

4. 업스트림 타임아웃 (504)

` upstream timed out (110: Connection timed out) while reading response header from upstream `

원인: 백엔드 서버(PHP/Python 등)가 60초 안에 응답 못 함 해결: 타임아웃 늘리기

`nginx location ~ \.php$ { fastcgi_read_timeout 300; } `

5. 메모리 부족 (500)

` recv() failed (104: Connection reset by peer) while reading response header from upstream `

원인: PHP 메모리 제한 초과 해결: /etc/php/8.2/fpm/php.ini에서

`ini memory_limit = 256M `

---

Apache 에러 로그 구조

` [Fri Oct 10 14:05:22.123456 2024] [core:error] [pid 12345] [client 192.0.2.100:54321] File does not exist: /var/www/html/favicon.ico `

---

에러 로그 레벨

Nginx/Apache 모두 동일한 레벨 체계:

웹 서버	로그 경로
--------	----------
Nginx	/var/log/nginx/error.log
Apache (Ubuntu)	/var/log/apache2/error.log
Apache (CentOS)	/var/log/httpd/error_log
필드	의미
------	------
날짜/시각	2024/10/10 14:05:22
로그 레벨	[error] (debug/info/notice/warn/error/crit/alert/emerg)
프로세스 ID	12345#12345 (마스터#워커)
연결 ID	*678
메시지	open() failed...
클라이언트 IP	192.0.2.100
서버명	example.com
요청	GET /favicon.ico HTTP/1.1
필드	의미
------	------
날짜/시각	Fri Oct 10 14:05:22.123456 2024
모듈:레벨	[core:error]
프로세스 ID	[pid 12345]
클라이언트	[client 192.0.2.100:54321]
메시지	File does not exist...
레벨	심각도	의미
------	--------	------
emerg	최고	시스템 사용 불가
alert	매우 높음	즉시 조치 필요
crit	높음	치명적 오류
error	중간	일반 오류 (기본 로깅)
warn	낮음	경고
notice	매우 낮음	주목할 이벤트
info	정보	정보성 메시지
debug	디버그	개발 전용

운영 환경에서는 error 레벨만 로깅하는 것이 일반적입니다.

---

에러 로그 분석 명령어

가장 많이 발생한 에러

`bash awk '{for(i=1;i<=NF;i++){if($i~/\[error\]/){print;break}}}' /var/log/nginx/error.log \ | sort | uniq -c | sort -rn | head -10 `

특정 시간대 에러

`bash grep '2024/10/10 14:' /var/log/nginx/error.log `

PHP Fatal Error 찾기

`bash grep -i 'fatal error' /var/log/nginx/error.log `

502/504 에러 원인

`bash grep -E '(upstream timed out|connect\(\) failed)' /var/log/nginx/error.log `

---

로그 레벨 조정

Nginx

/etc/nginx/nginx.conf:

`nginx error_log /var/log/nginx/error.log warn; # error → warn으로 변경 `

Apache

/etc/apache2/apache2.conf:

`apache LogLevel warn # error → warn `

재시작 필요:

`bash sudo systemctl restart nginx sudo systemctl restart apache2 `

---

에러 로그 로테이션

/etc/logrotate.d/nginx:

` /var/log/nginx/*.log { daily missingok rotate 14 compress delaycompress notifempty create 0640 www-data adm sharedscripts postrotate [ -f /var/run/nginx.pid ] && kill -USR1 cat /var/run/nginx.pid endscript } ``

---

정리

에러 로그는 500/502/504 에러의 실제 원인을 알려줍니다. 파일 권한, FastCGI 연결 실패, 타임아웃, 메모리 부족 등 액세스 로그만으로는 알 수 없는 서버 내부 문제를 진단할 수 있습니다.