Technote

서버 · 인프라 실무

프로덕션 로그 — 화면에 띄우지 않고 파일에만 남기기

오류를 화면에 띄우면 방문자에게 내부 구조가 새고, 로그 파일을 웹 루트에 두면 주소를 짐작한 누구에게나 샙니다. 두 문장이 프로덕션 로그 설정의 전부입니다.

운영 중인 사이트에서 로그를 완전히 꺼 두는 경우를 자주 봅니다. 이유는 대개 “화면에 오류가 뜨니까” 인데, 그것은 로그의 문제가 아니라 표시 설정의 문제입니다. 둘은 별개의 스위치이고, 프로덕션에서 필요한 조합은 정해져 있습니다 — 기록은 켜고 표시는 끕니다.

로그가 없는 프로덕션은 고장을 고객에게서 듣게 되는 프로덕션입니다. 그 사이의 시간이 곧 피해 규모입니다.

표시와 기록은 다른 스위치입니다

워드프레스는 세 개의 상수로 이 조합을 만듭니다. WP_DEBUG 가 수집 수준을, WP_DEBUG_LOG 가 기록 여부와 위치를, WP_DEBUG_DISPLAY 가 화면 출력 여부를 정합니다.

여기서 놓치기 쉬운 것은 WP_DEBUG_DISPLAY 의 기본값이 켜짐 쪽이라는 점입니다. 정의하지 않으면 WP_DEBUG 가 켜졌을 때 화면 출력도 함께 켜집니다. 그래서 프로덕션에서는 명시적으로 false 를 적습니다.

// wp-config.php — 프로덕션
define( 'WP_DEBUG', true );            // 수집은 한다
define( 'WP_DEBUG_DISPLAY', false );   // 화면에는 내보내지 않는다 (명시가 필수)
define( 'WP_DEBUG_LOG', '/var/log/wper/php-errors.log' );  // 웹 루트 밖 파일로
@ini_set( 'display_errors', 0 );

WP_DEBUG_LOG 에 경로를 직접 넣을 수 있다는 점이 중요합니다. true 로 두면 wp-content/debug.log 에 쌓이는데, 그 자리는 웹으로 읽히는 경로입니다. 주소를 짐작한 누구든 우리 서버의 절대 경로 · 플러그인 구성 · 쿼리 조각을 읽게 됩니다.

WP_DEBUG 를 켜는 것이 부담스러운 환경이라면, 워드프레스 상수 대신 PHP 자체의 로그 설정만 켜는 선택지도 있습니다. 치명적 오류와 경고만 조용히 파일로 받는 구성이고, 수집 범위는 좁지만 사이트 동작에는 아무 영향을 주지 않습니다.

화면에 뜨는 오류가 실제로 내보내는 것

오류 메시지는 생각보다 많은 것을 말합니다.

화면에 뜬 오류 한 줄이 내보내는 정보 — 전부 우리가 숨기려던 것들이다

그래서 표시를 끄는 것은 편의가 아니라 보안 설정입니다. 그리고 한 가지 더 — 워드프레스가 로드되기 전에 나는 오류(예: wp-config.php 자체의 문법 오류)는 이 상수들의 관할 밖입니다. 서버의 php.ini 기본값도 display_errors = Off 여야 그 구간까지 닫힙니다.

파일을 어디에 두고 어떻게 관리하나

원칙은 웹 루트 밖입니다. 사정상 안쪽에 둬야 한다면 서버 설정으로 접근을 차단하고, 그 경우에도 두 겹으로 둡니다 — 설정은 실수로 사라질 수 있고, 위치는 실수로 사라지지 않습니다.

# nginx — wp-content 아래의 로그 파일 접근 차단
location ~* /(?:wp-content|wp-includes)/.*.log$ {
    deny all;
}

그다음이 회전입니다. 매 요청마다 찍히는 경고 하나가 있으면 로그는 놀랄 만큼 빨리 자랍니다. 디스크가 차면 사이트가 멈추므로, 로그를 켜는 작업과 회전을 거는 작업은 한 번에 같이 합니다.

# /etc/logrotate.d/wper
/var/log/wper/php-errors.log {
    weekly
    rotate 8
    compress
    missingok
    notifempty
    create 0640 www-data adm
}

실제로 무엇이 적용됐는지 확인합니다

설정을 적었다고 적용된 것은 아닙니다. 특히 CLI 와 웹(FPM)은 서로 다른 php.ini 를 읽습니다 — CLI 에서 확인한 값이 웹 요청에도 같다고 가정하면 안 됩니다.

wp eval 'var_dump( WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY );'
wp eval 'var_dump( ini_get( "display_errors" ), ini_get( "error_log" ) );'

확인이 끝나면 실제로 한 줄을 흘려 보고 파일에 도착하는지 봅니다. 설정한 것과 동작하는 것을 따로 확인하는 습관이 이런 종류의 작업에서 가장 큰 차이를 만듭니다.

마지막으로 우리가 직접 남기는 로그에도 규칙이 필요합니다. error_log() 로 요청 본문을 통째로 찍는 코드는 결제 자격증명이나 접속 정보를 로그 파일에 영구 보관하는 코드가 되기 쉽습니다. 예외 기록은 마스킹을 거치게 하고, 무엇을 남길지는 미리 정해 둡니다.

서버 구성과 하드닝에 관한 글은 서버 · 인프라 아카이브에, 환경별 설정을 배포 절차로 굳히는 방법은 개발 환경과 배포 연재에 있습니다. 로그와 지표를 상시로 지켜보는 구성이 필요하다면 InfraGuard 이용권이 그 자리를 맡습니다.

이 주제의 다른 글

노하우 목록으로

서버 · 인프라 실무

업로드 폴더에서 PHP 를 실행하지 않게 합니다

파일이 올라가는 것과 실행되는 것은 다른 단계입니다. 그 사이를 끊는 설정 하나가 업로드 문제를 정리 작업으로 끝나게 합니다.

운영 · 관리자 4분 읽기

서버 · 인프라 실무

디스크가 차면 사이트는 이상한 방식으로 죽습니다

증상이 원인을 가리키지 않는 대표적인 고장입니다. 무엇이 공간을 먹는지 알면 찾는 데 3분이면 되고, 되찾는 순서에도 안전한 쪽과 위험한 쪽이 있습니다.

운영 · 관리자 6분 읽기

서버 · 인프라 실무

PHP 버전을 올리기 전에 deprecated 를 먼저 찾습니다

deprecated 경고는 지금 고장 난 것이 아니라 다음 버전에서 고장 날 것의 목록입니다. 올린 뒤에 읽으면 사고 보고서지만, 올리기 전에 읽으면 작업 목록입니다.

개발자 5분 읽기

₩270,000 · 신청하기