고급 기능

고급 기능을 사용하려면 클러스터 안에 Kubetail API를 설치해야 합니다. Kubetail API가 설치되면 로그 요청은 kube-apiserver 대신 클러스터 내부의 전용 서비스로 라우팅되며, 이를 통해 Kubernetes API만으로는 제공되지 않는 기능을 사용할 수 있습니다.

Kubetail API 설치

kubetail CLI 도구를 사용 중이라면 kubetail cluster 명령으로 Kubetail API를 설치할 수 있습니다.

kubetail cluster install

이 명령은 Kubetail Helm 차트를 사용해 API를 설치하므로, 원한다면 이후에는 Helm으로 독립적으로 관리할 수 있습니다. 자세한 내용은 cluster 명령어 레퍼런스를 참고하세요.

Helm으로 직접 Kubetail API를 설치할 수도 있습니다. 절차는 클러스터 설치 가이드를 참고하세요.

로그 파일 메타데이터

Kubetail API를 설치하면 워크로드 목록에 로그 파일 크기와 마지막 이벤트 타임스탬프가 표시됩니다.

Kubetail home page showing workloads with log file sizes and last event timestamps

이 메타데이터는 Cluster Agent가 각 Node의 로그 파일에서 직접 수집한 뒤 Cluster API를 통해 제공합니다. Kubernetes API만으로는 이 정보를 얻을 수 없습니다.

로그 검색

Kubetail API가 설치되면 로그 콘솔 헤더에 검색 입력창이 나타나며, 여기에 일반 문자열이나 /regex/ 패턴을 입력해 로그 스트림을 필터링할 수 있습니다. 매칭은 각 Node에서, 데이터가 대시보드로 보내지기 전에 수행되므로, 일치하는 줄만 전송됩니다. 덕분에 로그 양이 많은 워크로드에서도 대역폭 사용량을 낮게 유지할 수 있습니다.