> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 로그 및 이벤트 추적

> 로그와 이벤트 추적으로 Octoparse 작업 실행을 이해하고 실패 문제를 해결하며 추출 동작을 모니터링하세요.

로그와 이벤트 추적은 작업 실행 중 발생한 일을 이해하는 데 도움이 됩니다. 실패한 실행, 불완전한 데이터, 예기치 않은 중지, 페이지 넘기기 문제, 로그인 문제 또는 클라우드 추출 동작을 해결할 때 사용하세요.

## 로그의 용도

로그는 다음과 같은 질문에 답하는 데 도움이 됩니다.

* 작업이 성공적으로 시작되었나요?
* 어느 단계에서 실패했나요?
* 페이지가 올바르게 로드되었나요?
* 페이지 넘기기가 예상대로 계속되었나요?
* 로그인 또는 쿠키 상태가 누락되었나요?
* 작업에서 레코드를 추출했나요?
* 클라우드 실행이 중지된 이유는 무엇인가요?

## 로그를 확인해야 하는 경우

다음과 같은 경우 로그를 확인하세요.

| 상황             | 로그가 도움이 되는 이유           |
| -------------- | ----------------------- |
| 작업 실패          | 실패한 단계 또는 페이지 식별        |
| 데이터 누락         | 추출 필드에 도달했는지 확인         |
| 예상보다 적은 레코드    | 페이지 넘기기, 루프 또는 중지 조건 검토 |
| 클라우드 실행 동작이 다름 | 클라우드 동작과 로컬 테스트 비교      |
| 예약 작업 중지       | 실행 기록 및 실패 시점 확인        |

## 문제 해결 워크플로

<Steps>
  <Step title="실패하거나 불완전한 실행 찾기">
    작업의 실행 기록을 열고 확인할 실행을 선택합니다.
  </Step>

  <Step title="타임라인 검토">
    첫 번째 경고, 실패한 동작 또는 예기치 않은 중지를 찾습니다.
  </Step>

  <Step title="워크플로와 비교">
    로그 이벤트를 작업의 해당 동작과 연결합니다.
  </Step>

  <Step title="작업 조정">
    필요에 따라 대기, 선택자, 페이지 넘기기, 로그인, 쿠키, [프록시](/docs/ko/platform/proxy) 또는 추출 설정을 업데이트합니다.
  </Step>

  <Step title="샘플 다시 실행">
    작업을 예약하거나 확장하기 전에 업데이트된 워크플로를 테스트합니다.
  </Step>
</Steps>

## 실행 문제의 일반적인 원인

* 페이지 구조 변경
* 요소 선택자가 더 이상 일치하지 않음
* 콘텐츠 로딩이 너무 느림
* 로그인 세션 만료
* CAPTCHA 또는 차단 발생
* 페이지 넘기기가 계속되지 않음
* 클라우드 환경이 로컬 테스트와 다름
* 모든 페이지에 도달하기 전에 작업 중지

## 모범 사례

* 작업을 크게 변경한 후 로그를 검토하세요.
* 성공한 실행을 비교 기준으로 보관하세요.
* 페이지 동작을 직접 관찰해야 할 때 [로컬에서 테스트](/docs/ko/platform/local-vs-cloud)하세요.
* 예약 또는 무인 실행이 실패하면 클라우드 로그를 사용하세요.
* 로그를 데이터 수 및 내보내기 상태와 함께 사용해 작업 상태를 확인하세요.

<Note>
  로그는 실행 중 발생한 일을 보여 주지만 웹사이트가 다르게 동작한 이유까지 항상 설명하지는 못합니다. 복잡한 사이트에서는 로컬 테스트, 클라우드 로그 및 대상 페이지 구조를 함께 비교하세요.
</Note>