기본 기능

기본적으로 Kubetail은 Kubernetes API 를 사용해 워크로드를 감시하고 로그 데이터를 가져옵니다. 여기서 설명하는 모든 기능은 추가 설치 없이 Kubetail 웹 대시보드에서 사용할 수 있습니다.

여러 클러스터

Kubetail은 kubeconfig 파일을 읽어 사용 가능한 클러스터를 찾고, 그 안에 정의된 자격 증명을 사용해 각 클러스터에 인증합니다. 두 개 이상의 context가 설정되어 있으면 상단 탐색 바에 클러스터 선택기가 나타나며, 이를 통해 클러스터를 전환할 수 있습니다. Kubetail은 kubeconfig 파일의 변경도 감시하고 목록을 자동으로 새로 고치므로, 새로 추가된 context는 재시작 없이 바로 나타납니다.

Kubetail dashboard home page showing the cluster picker

워크로드 필터

대시보드 홈 페이지에서는 모든 워크로드를 실시간으로 볼 수 있고, namespace, 워크로드 유형, 검색어로 범위를 좁힐 수 있습니다.

Kubetail dashboard home page showing workload search

실시간 tail

워크로드를 선택하면 로그 콘솔이 열리고, 해당 워크로드의 모든 컨테이너 로그를 동시에 tail 하기 시작합니다. 새로운 로그 줄은 작성되는 즉시 스트리밍되고, 위로 스크롤하면 이전 줄도 볼 수 있습니다. 또한 뷰어 컨트롤을 사용해 스트림의 시작으로 이동하거나, 특정 시각으로 점프하거나, 끝으로 이동해 tailing을 다시 이어갈 수 있습니다.

Kubetail dashboard logging console showing web server log streams

컨테이너 라이프사이클 추적

Kubetail은 Kubernetes Pod 이벤트를 실시간으로 감시합니다. 새 Pod나 컨테이너가 시작되면 — rolling update, crash 후 재시작, scale-out 중이라도 — 그 로그는 자동으로 활성 스트림에 추가됩니다. Pod가 삭제되면 해당 로그 소스는 스트림에서 제거됩니다. 이러한 변화를 보기 위해 콘솔을 다시 열거나 수동으로 새로 고칠 필요가 없습니다.

로그 필터

로그 콘솔에서는 다음 기준으로 로그를 필터링할 수 있습니다.

Container — 이름으로 특정 컨테이너만 표시합니다.
Node — 특정 Node에서 실행 중인 컨테이너만 표시합니다.
Region / Zone — 클라우드 리전 또는 가용 영역으로 필터링합니다 (topology.kubernetes.io/region, topology.kubernetes.io/zone Node 라벨 사용).
OS / Arch — 운영체제 또는 CPU 아키텍처로 필터링합니다 (kubernetes.io/os, kubernetes.io/arch Node 라벨 사용).

이 필터들은 원하는 조합으로 동시에 적용할 수 있으며, 모든 필터를 제거하면 전체 스트림으로 돌아갑니다.