logviewer (Install)

로그 읽기 및 필터링

lv은 파일, 파이프, Kubernetes 클러스터에서 로그를 읽을 수 있습니다. 로그 레벨별 필터링(–level)과 JSONPath 유사 필터(–filter)를 지원하여 원하는 로그만 볼 수 있습니다. 토픽과 스코프 필드가 있는 로그는 색상으로 표시됩니다.

출력 형식 및 표시 옵션

기본적으로 터미널에서 페이저와 색상으로 로그를 표시하지만, –no-pager로 페이저 사용을 끌 수 있습니다. 시간은 기본적으로 UTC로 표시되지만, –local로 로컬 시간이나 –time으로 특정 시간대를 사용할 수 있습니다. –o short 플래그로 시간을 짧은 형식으로 표시할 수 있습니다.

Kubernetes 로그 지원

Kubernetes 플래그(–namespace, –selector, –container 등)를 사용하면 lv은 kubectl logs 명령을 실행하여 클러스터의 로그를 가져옵니다. –follow만으로는 충분하지 않으며, Kubernetes 로그를 스트리밍하려면 –k8s 플래그나 다른 Kubernetes 플래그를 함께 사용해야 합니다.

다운로드·설치 방법

Windows에서는 Chocolatey를 통해 lv을 설치할 수 있습니다. 공식 Chocolatey 패키지 이름은 bunyan-logviewer이며, 다음 명령으로 설치합니다:

choco install bunyan-logviewer

Scoop을 사용하는 경우, 먼저 gildas 버킷을 추가한 후 lv을 설치합니다:

scoop bucket add gildas https://github.com/gildas/scoop-bucket
scoop install lv

또한 GitHub 릴리스 페이지에서 최신 바이너리를 직접 다운로드할 수 있습니다.

기본 사용법/명령어

로그 파일을 보려면 다음 명령을 사용합니다:

lv /path/to/logfile

파이프를 통해 로그를 보려면:

tail -f /path/to/logfile | lv

또는 –follow 플래그를 사용합니다:

lv –follow /path/to/logfile
lv -f /path/to/logfile

시간대를 지정하려면:

lv –local /path/to/logfile
lv –time America/New_York /path/to/logfile
lv –time +02:00 /path/to/logfile
lv –time -3 /path/to/logfile

로그 레벨을 필터링하려면:

lv –level=info /path/to/logfile
lv –level=debug /path/to/logfile

JSONPath 유사 필터를 사용하려면:

lv –filter ‘.field == “value”‘ /path/to/logfile
lv –filter ‘.field1 == .field2’ /path/to/logfile

이런 경우에 유용합니다

Bunyan 또는 Pino.js 형식의 로그 파일을 자주 보는 개발자나 시스템 관리자에게 유용합니다. 특히 Kubernetes 환경에서 파드 로그를 실시간으로 모니터링해야 할 때, –namespace와 –selector 같은 플래그를 사용하여 특정 애플리케이션의 로그만 필터링해 볼 수 있습니다.

지원 환경·시스템 요구사항

lv은 Windows, Linux, macOS에서 실행됩니다. Windows에서는 Chocolatey 또는 Scoop을 통해 설치할 수 있으며, GitHub 릴리스 페이지에서 바이너리를 직접 다운로드할 수 있습니다.

최신 버전·업데이트

현재 버전은 0.4.0입니다. 최신 버전과 업데이트 내역은 GitHub 릴리스 페이지에서 확인할 수 있습니다.