# 고급 기능
import { Aside } from "@astrojs/starlight/components";
import { Image } from "astro:assets";
import homePageWithLogMetadataLight from "@/assets/screenshots/light/home-page-with-log-metadata.webp";
import homePageWithLogMetadataDark from "@/assets/screenshots/dark/home-page-with-log-metadata.webp";
import consoleWithSearchLight from "@/assets/screenshots/light/logging-console-with-search.webp";
import consoleWithSearchDark from "@/assets/screenshots/dark/logging-console-with-search.webp";
고급 기능을 사용하려면 클러스터 안에 **Kubetail API**를 설치해야 합니다. Kubetail API가 설치되면 로그 요청은 kube-apiserver 대신 클러스터 내부의 전용 서비스로 라우팅되며, 이를 통해 Kubernetes API만으로는 제공되지 않는 기능을 사용할 수 있습니다.
---
## Kubetail API 설치
`kubetail` CLI 도구를 사용 중이라면 `kubetail cluster` 명령으로 Kubetail API를 설치할 수 있습니다.
```sh
kubetail cluster install
```
이 명령은 Kubetail Helm 차트를 사용해 API를 설치하므로, 원한다면 이후에는 Helm으로 독립적으로 관리할 수 있습니다. 자세한 내용은 [`cluster` 명령어 레퍼런스](/ko/reference/cli#kubetail-cluster)를 참고하세요.
Helm으로 직접 Kubetail API를 설치할 수도 있습니다. 절차는 [클러스터 설치 가이드](/ko/guides/cluster/installation)를 참고하세요.
---
## 로그 파일 메타데이터
Kubetail API를 설치하면 워크로드 목록에 로그 파일 크기와 마지막 이벤트 타임스탬프가 표시됩니다.
이 메타데이터는 Cluster Agent가 각 Node의 로그 파일에서 직접 수집한 뒤 Cluster API를 통해 제공합니다. Kubernetes API만으로는 이 정보를 얻을 수 없습니다.
---
## 로그 검색
Kubetail API가 설치되면 로그 콘솔 헤더에 검색 입력창이 나타나며, 여기에 일반 문자열이나 `/regex/` 패턴을 입력해 로그 스트림을 필터링할 수 있습니다. 매칭은 각 Node에서, 데이터가 대시보드로 보내지기 전에 수행되므로, 일치하는 줄만 전송됩니다. 덕분에 로그 양이 많은 워크로드에서도 대역폭 사용량을 낮게 유지할 수 있습니다.