Oracle 로그는 PHP 에러, 데이터베이스 연결 실패, 플러그인 문제 등 웹사이트에서 발생하는 문제를 기록합니다. 사이트에 문제가 발생했을 때, 에러 로그는 원인을 파악하는 가장 빠른 방법인 경우가 많습니다.
File Manager 또는 SFTP로 로그 액세스하기
KPanel에는 별도의 Logs 탭이 없습니다. 로그 파일은 서버에 저장되며 File Manager 또는 SFTP를 통해 액세스할 수 있습니다.
File Manager 사용하기:
- kpanel.kapsulehost.com에서 KPanel에 로그인합니다
- 웹사이트로 이동하여 해당 사이트를 선택합니다
- Settings → File Manager를 클릭합니다
- 사이트 루트에서
logs/디렉터리로 이동합니다
SFTP 사용하기:
- KPanel에서 해당 사이트의 연결 정보를 확인하려면 Settings → SFTP로 이동합니다
- FileZilla 또는 선호하는 SFTP 클라이언트로 연결합니다
- 사이트 루트에서
logs/디렉터리로 이동합니다
logs/ 디렉터리에는 다음이 포함되어 있습니다:
- PHP 에러 로그, PHP 코드에서 발생한 에러(가장 많이 필요한 로그)
- 액세스 로그, 사이트로 들어온 모든 HTTP 요청 기록
- 에러 로그, 서버 수준의 에러(500, 502 등)
PHP 에러 로그 읽는 법
일반적인 PHP 에러 로그 항목은 다음과 같습니다:
[03-Jun-2026 14:32:11 UTC] PHP Fatal error: Call to undefined function get_header() in /var/www/sites/yourdomain/public_html/wp-content/themes/mytheme/page.php on line 8
이를 통해 날짜와 시간, 에러 유형, 문제에 대한 설명, 그리고 에러가 발생한 파일 경로와 줄 번호를 확인할 수 있습니다.
일반적인 에러 유형
| 유형 | 심각도 | 의미 |
|---|---|---|
| Fatal error | 높음 | 실행이 중단되었습니다. 페이지가 로드되지 않습니다. |
| Warning | 중간 | 예상치 못한 일이 발생했지만 실행은 계속되었습니다. |
| Notice | 낮음 | 경미한 문제로, 대개 코딩 모범 사례 위반입니다. |
| Deprecated | 낮음 | 사용 중인 함수가 이후 PHP 버전에서 제거될 예정입니다. |
WordPress 디버그 모드 활성화하기
WordPress 사이트의 경우, 디버그 모드를 활성화하면 더 상세한 에러 정보를 출력합니다:
- SFTP로 연결하거나 KPanel의 File Manager를 사용합니다
- WordPress 루트에서
wp-config.php를 엽니다 - 다음 줄을 추가하거나 수정합니다:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
에러는 화면에 표시되는 대신 wp-content/debug.log에 기록됩니다.
실제 운영 중인 사이트에서는 WP_DEBUG_DISPLAY을 true로 설정한 채로 두지 마십시오. 방문자에게 민감한 정보가 노출될 수 있습니다.
WordPress, 플러그인 또는 테마를 업데이트한 직후에는 반드시 에러 로그를 확인하십시오. 업데이트 이후 발생하는 많은 문제가 PHP 에러 로그에 뚜렷한 흔적을 남깁니다.