# 웹사이트 오류 로그 접근하기

Source: https://support.kapsulehost.com/ko-kr/error-logs

Oracle 로그는 PHP 에러, 데이터베이스 연결 실패, 플러그인 문제 등 웹사이트에서 발생하는 문제를 기록합니다. 사이트에 문제가 발생했을 때, 에러 로그는 원인을 파악하는 가장 빠른 방법인 경우가 많습니다.

### File Manager 또는 SFTP로 로그 액세스하기

KPanel에는 별도의 Logs 탭이 없습니다. 로그 파일은 서버에 저장되며 File Manager 또는 SFTP를 통해 액세스할 수 있습니다.

**[File Manager](https://support.kapsulehost.com/ko-kr/file-manager) 사용하기:**

1. [kpanel.kapsulehost.com](https://kpanel.kapsulehost.com)에서 KPanel에 로그인합니다
2. **웹사이트**로 이동하여 해당 사이트를 선택합니다
3. **Settings → File Manager**를 클릭합니다
4. 사이트 루트에서 `logs/` 디렉터리로 이동합니다

**[SFTP](https://support.kapsulehost.com/ko-kr/sftp-access) 사용하기:**

1. KPanel에서 해당 사이트의 연결 정보를 확인하려면 **Settings → SFTP**로 이동합니다
2. FileZilla 또는 선호하는 SFTP 클라이언트로 연결합니다
3. 사이트 루트에서 `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 사이트의 경우, 디버그 모드를 활성화하면 더 상세한 에러 정보를 출력합니다:

1. SFTP로 연결하거나 KPanel의 File Manager를 사용합니다
2. WordPress 루트에서 `wp-config.php`를 엽니다
3. 다음 줄을 추가하거나 수정합니다:

```php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
```

에러는 화면에 표시되는 대신 `wp-content/debug.log`에 기록됩니다.

> **Warning:** 실제 운영 중인 사이트에서는 `WP_DEBUG_DISPLAY`을 `true`로 설정한 채로 두지 마십시오. 방문자에게 민감한 정보가 노출될 수 있습니다.

> **Tip:** [WordPress, 플러그인 또는 테마를 업데이트한](https://support.kapsulehost.com/ko-kr/wordpress-updates) 직후에는 반드시 에러 로그를 확인하십시오. 업데이트 이후 발생하는 많은 문제가 PHP 에러 로그에 뚜렷한 흔적을 남깁니다.