Pinot 트러블슈팅
Pinot 트러블슈팅 (Troubleshooting Pinot)
Pinot 클러스터에서 흔히 발생하는 문제를 진단하는 방법을 안내해요.
출처: 문서
본문
개요 (Overview)
이 페이지는 Pinot 컴포넌트를 시작하거나 운영할 때 발생하는 흔한 문제들을 다뤄요. 문제 진단을 위해 로그, 클러스터 상태, 메트릭을 확인하는 방법을 소개해요.
진단 시작 (Getting started with diagnostics)
- 로그 확인 — 각 컴포넌트의 로그에서 오류 스택 트레이스를 확인해요.
- 클러스터 상태 확인 — Ideal State와 External View가 일치하는지 확인해요 (
VerifyClusterState등). - 헬스 체크 — 컨트롤러/브로커/서버의
/health엔드포인트로 상태를 확인해요. - 메트릭 확인 — 쿼리 지연, 소비 래그, 메모리 등의 지표를 모니터링해요.
흔한 문제 (Common issues)
- 컴포넌트가 시작되지 않음 — ZooKeeper 연결, 포트 충돌, Java 버전 등을 확인해요.
- 세그먼트가 로드되지 않음 — 세그먼트 상태, 딥 스토어 접근, 메모리 부족을 확인해요.
- 쿼리 실패 · 느림 — 쿼리 패턴, 인덱스, 리소스 사용량을 확인해요.
해결 접근 (Resolution approach)
문제를 좁히기 위해 단계별로 로그·상태·메트릭을 확인하고, 관련 FAQ(General FAQ, Query FAQ, Ingestion FAQ)를 참고하세요.