오류
실행 기록에서 실패한 파이프라인과 노드를 찾고 오류 로그를 확인합니다. 파이프라인·배치·노드 단위의 기록을 비교해 문제가 발생한 단계를 좁힙니다.
실행 이력
파이프라인을 실행할 때마다 실행 기록이 저장됩니다.
실행 이력 구조
실행 이력은 세 계층으로 나뉩니다.
| 계층 | 설명 |
|---|---|
| 파이프라인 | 전체 작업 흐름입니다. |
| 배치 | 한 번 실행한 파이프라인입니다. 실행할 때마다 새 배치가 생성됩니다. |
| 단계 | 배치 안에서 실행한 각 노드입니다. |
실행 이력 조회
- 파이프라인 편집기에서 코드 노드를 선택하고 속성 패널의 히스토리 탭을 엽니다.
- 배치 목록에서 배치를 선택하면 단계별 상세가 펼쳐집니다.
상단 실행 이력 바에 마우스를 올리면 실행 번호·상태·시각·소요 시간이 표시됩니다. 각 배치에는 다음 정보가 있습니다.
| 항목 | 설명 |
|---|---|
| 배치 ID | 실행 인스턴스의 식별자 |
| 상태 | 실행 결과 (성공/실패/실행 중 등) |
| 소요 시간 | 전체 실행에 걸린 시간 |
배치 상태
각 배치는 다음 상태 중 하나입니다.
| 상태 | 설명 | 후속 조치 |
|---|---|---|
실행 중 (running) | 현재 실행 중입니다. | 완료될 때까지 기다리거나 필요하면 중지합니다. |
성공 (ready) | 모든 단계를 완료했습니다. | 출력 데이터셋을 확인합니다. |
실패 (failed·error) | 한 단계 이상에서 오류가 발생했습니다. | 오류를 수정하고 다시 실행합니다. |
중지 (stop) | 사용자가 실행을 중단했습니다. | 필요하면 다시 실행합니다. |
오류 분석
단계별 로그 확인
실행에 실패한 배치를 분석하는 단계는 다음과 같습니다.
- 실패한 코드 노드를 선택해 속성 패널을 엽니다.
- 히스토리 탭에서 실패(빨강)로 표시된 배치를 선택합니다.
- 실패한 단계를 펼쳐 설명과 스택트레이스를 확인합니다. 스택트레이스의 복사를 누르면 내용이 클립보드에 복사됩니다.
단계 기록이 없는 실행 실패
노드 실행이 시작되기 전에 실행·등록 요청이 실패하면 히스토리 탭에 단계별 기록이나 스택트레이스가 남지 않을 수 있습니다. 이 경로는 오류 토스트나 데스크톱 알림도 보장하지 않습니다. 실행 버튼과 상태가 바뀌지 않으면 네트워크와 서비스 상태를 확인한 뒤 다시 시도합니다.
실행 상태를 반복해서 읽지 못하면 약 1분 뒤 조회가 멈추고 파이프라인 상태를 알 수 없음이 표시됩니다. 네트워크와 서비스 상태를 확인한 뒤 다시 조회합니다.
오류 메시지 해석
히스토리 탭의 단계 상세에서 확인할 수 있는 정보는 다음과 같습니다.
| 항목 | 설명 |
|---|---|
| 상태 | 단계의 실행 결과를 표시합니다. |
| 설명 | 오류 원인을 설명합니다. |
| 스택트레이스 | 상세 호출 스택을 표시합니다. |
| 시작·종료 시각 | 단계의 실행 시각을 표시합니다. |
일반적인 오류 유형과 해결 방법
| 오류 유형 | 원인 | 해결 방법 |
|---|---|---|
| ConnectionError | 데이터 소스(DB, API) 연결 실패 | 네트워크 상태, 인증 정보, 엔드포인트 주소 확인 |
| SchemaError | 입출력 데이터의 스키마 불일치 | 컬럼명, 데이터 타입 매핑 확인 |
| SyntaxError | Python/SQL 코드의 문법 오류 | 코드 문법을 수정하고 재실행 |
| RuntimeError | 코드 실행 중 예외 발생 | 스택트레이스를 분석하여 로직 수정 |
| TimeoutError | 실행 시간 초과 | 쿼리 최적화, 데이터 크기 축소, 타임아웃 값 조정 |
| ResourceError | CPU/메모리 리소스 부족 | 리소스 제한 상향 또는 데이터 분할 처리 |
코드 노드에서 오류가 반복되면 코드에 로그(print 또는 logging)를 추가해 중간 데이터 상태를 확인합니다.
단계별 실행 기록
각 단계의 실행 기록에는 다음 정보가 표시됩니다.
| 항목 | 설명 |
|---|---|
| 상태 | 단계의 실행 결과입니다. |
| 시작·종료 시각 | 단계의 시작·종료 시각입니다. |
| 설명 | 실행/오류 설명 메시지 |
| 스택트레이스 | 실패 시 상세 호출 스택 |
처리 레코드 수와 소요 시간은 실행 중에 캔버스 노드 상단의 상태 표시에서 확인합니다.
배치 재실행
실패 원인을 수정한 뒤 배치를 다시 실행합니다.
재실행 방법
- 실패 원인을 분석하고 코드 또는 설정을 수정합니다.
- 변경 사항을 저장합니다.
- 상단 툴바의 지금 실행을 눌러 새 배치를 생성합니다.
재실행하면 새 배치가 생깁니다. 이전에 실패한 배치 이력은 그대로 남으므로 두 배치를 비교 분석하는 데 쓸 수 있습니다.
디버깅 모범 사례
- 로그 확인 순서: 파이프라인 → 배치 → 단계 순서로 범위를 좁혀 분석합니다.
- 단계적 테스트: 복잡한 파이프라인은 노드를 하나씩 추가하며 각 단계를 검증합니다.
- 작은 데이터로 테스트: 전체 데이터를 돌리기 전에 소량의 샘플 데이터로 먼저 테스트합니다.
- 이전 성공 배치 비교: 실패한 배치와 이전에 성공한 배치의 입력 데이터, 설정 차이를 비교합니다.