Doris
1 스토리지 엔진을 Doris로 전환한 후 호스트 목록이 비어 있음¶
문제 설명: 스토리지 엔진을 Doris로 전환한 후 새 워크스페이스를 생성하면 로그에서 데이터를 조회할 수 있지만, 인프라에서 호스트 목록이 비어 있고 정보가 표시되지 않습니다.
검색 종료 시간을 현재 시간 기준 하루 뒤로 조정하면(예: 현재 시간이 4월 23일 16시인 경우, 검색 종료 시간을 4월 24일 16시로 조정) 인프라에서 내용을 조회할 수 있습니다.
문제 해결: Doris 클러스터의 시간대 설정을 확인하여 Asia/Shanghai로 설정되어 있는지 확인합니다. 그렇지 않은 경우 Asia/Shanghai로 변경합니다.
# fe 머신에서 mysql 명령어를 통해 클러스터에 연결
mysql -uroot -h127.0.0.1 -P 9030
show variables like '%time_zone%';
# 결과가 Asia/Shanghai가 아닌 경우 다음 명령어로 수정
set global time_zone = "Asia/Shanghai";
2 Doris insert 컴포넌트 오류: 디스크 공간 부족¶
문제 설명: Guance 데이터 업로드가 비정상적이며 NSQ에 메시지가 쌓입니다. 그러나 조회 시 오류가 없고, Doris-logs insert 컴포넌트 로그를 확인하면 디스크 공간 부족을 발견할 수 있으며 df -h 명령어로도 확인할 수 있습니다.

문제 해결: 해당 디렉터리를 다시 마운트하고 insert 컴포넌트를 재시작합니다. 이 문제가 자주 발생하는 경우 Doris-logs 서버 메모리를 업그레이드하는 것이 좋습니다.
# 머신 메모리가 16GB인 경우 size=8G; 32GB인 경우 size=16G; 64GB인 경우 size=16G 또는 size=32G
mount -o size=8G -t tmpfs none /data-tmp && sudo supervisorctl restart guance-insert
3 Doris BE 노드 디스크 사용률 100%¶
문제 설명: Guance 데이터 업로드 및 조회가 비정상적이며 NSQ에 메시지가 쌓입니다. 로그를 확인하면 BE 노드의 디스크 사용률이 100%임을 알 수 있습니다.
문제 해결: 테이블을 삭제하여 디스크 공간을 확보합니다.
주의
테스트 환경에서는 데이터가 필요 없을 경우 테이블 삭제가 가능하지만, 프로덕션 환경에서는 테이블 삭제를 금지하며 디스크 확장이 필요합니다.
대용량 테이블 확인 방법 1: BE가 단일 노드인 경우 실행 시 오류가 발생할 수 있습니다.
# fe 머신에서 mysql 명령어를 통해 클러스터에 연결
mysql -uroot -h127.0.0.1 -P 9030
# 데이터량이 많은 테이블 이름 확인
select concat(table_schema, '.', table_name)
from information_schema.tables
where table_schema like 'db%'
order by data_length desc
limit 1;
# 테이블 삭제
drop table <table_name>;
대용량 테이블 확인 방법 2:
자체 모니터링을 도입한 경우, Doris 대시보드의 [테이블 쓰기 QPS TOP 10] 항목을 통해 대용량 테이블을 확인할 수 있습니다.
이 그래프에서 accountID를 확인합니다.
# BE 노드 머신에서 손상된 디스크 표시 제거
sed -i '/broken/d' /home/doris/doris/be/conf/be_custom.conf
# BE 재시작
manager web에 로그인하여 BE 노드 재시작
4 워크스페이스 수준의 핫 데이터 수정이 유효한지 확인하는 방법¶
문제 설명: Guance 백엔드에서 워크스페이스 수준의 인덱스 핫 데이터 보존 기간을 수정한 후, 수정이 유효한지 확인하는 방법입니다.

문제 해결:
# fe 머신에서 mysql 명령어를 통해 클러스터에 연결
mysql -uroot -h127.0.0.1 -P 9030
show storage policy;
# CooldownTtl은 핫 데이터 기간(초)이며, PolicyName은 해당 객체, 중간 숫자는 워크스페이스 ID입니다.
5 Doris 서버 doris 사용자 비밀번호 만료¶
문제 설명: Doris 서버의 doris 사용자 비밀번호가 만료되어 manager가 클러스터를 정상적으로 관리할 수 없습니다.
문제 해결:
방법 1:
doris 사용자 비밀번호 만료 정책을 수정합니다.
# 사용자 비밀번호 정책 확인
chage -l username
# -M -1은 비밀번호가 만료되지 않음을 의미합니다. 자세한 내용은 chage 사용법을 참조하세요.
chage -M -1 username
방법 2:
모든 Doris 서버의 doris 사용자 비밀번호를 변경한 후(변경 후 비밀번호는 동일해야 함), manager-web(fe01_ip:8004)에서 클러스터 관리를 해제한 후 다시 클러스터를 관리하도록 설정합니다.

6 Doris 클러스터 BE 노드 축소¶
문제 설명: 데이터 수집량이 감소하여 Doris 클러스터의 사양이 높아 BE 노드 수를 줄여야 하는 경우입니다.
문제 해결:
manager-web에서 BE 노드를 오프라인으로 전환합니다.
오프라인으로 전환된 BE 노드의 tablet이 완전히 마이그레이션될 때까지 기다립니다.
# fe 머신에서 mysql 명령어를 통해 클러스터에 연결
mysql -uroot -h127.0.0.1 -P 9030
show backends;
# TabletNum과 DataUsedCapacity가 0으로 감소하면 데이터 마이그레이션이 완료된 것입니다.
7 호스트 개체 페이지 클릭 시 오류: kodo 서비스 API 요청 오류: Service Unavailable¶
문제 설명: 호스트 개체를 클릭하면 kodo 서비스 API 요청 오류: Service Unavailable 오류가 발생합니다.
문제 해결:
GuanceDB for logs select 컴포넌트 로그를 확인하면 다음 오류가 발견됩니다.
Doris manager web에 로그인하여 BE 역할 매개변수를 확인합니다. arrow_flight_sql_port 매개변수가 없는 경우 manager에서 BE 노드에 arrow_flight_sql_port 매개변수를 추가합니다.