CockroachDB를 사용하다 문제가 발생했을 때 참고할 수 있는 대표적인 문제 해결 가이드입니다. 로그 확인, 일반적인 오류 및 트랜잭션 재시도 처리, 각종 문제 상황별 문서 안내 등 실질적인 트러블슈팅 절차를 소개합니다.
CockroachDB 사용 중 문제가 발생했다면 아래 단계들을 따라 문제를 해결해보세요:
로그에서 오류를 확인하세요. CockroachDB 로그는 각 노드 단위로 작성되므로, 문제가 발생한 노드의 로그를 찾거나 클러스터 내 모든 노드의 로그를 수집해야 합니다.
문제가 일반적인 오류가 아니라면, 다음 페이지를 참고하세요:
CockroachDB Cloud를 사용한다면, 클라우드 문제 해결에 나온 오류 및 해결법을 확인하세요.
메트릭에 불일치가 발견되면 서드파티 모니터링 통합과 DB 콘솔 간 메트릭 차이를 참고하세요.
Critical Nodes Endpoint를 이용하면 데이터 복제, 배치, 영역 제약 준수 상태 등을 쿼리할 수 있습니다.
복제본이 영역 설정에 따라 동작하지 않는 것처럼 보인다면 복제 영역 문제 해결을 참고하세요.
자체 해결이 어렵다면 아래 도구들을 활용해 추가적인 도움을 받을 수 있습니다:
지원 요청(에스컬레이션) 시 Cockroach Labs 지원팀이 아래 기능 사용을 안내할 수 있습니다:
이 안내가 도움이 되었습니까?