LogNav

탐색 및 필터링

• vim 스타일 키보드 탐색: j/k로 이동, g/G로 상단/하단 이동, PageUp/PageDown으로 페이지 탐색
• 로그 레벨별 필터링: 1(Error), 2(Warn), 3(Info), 4(Debug), 5(Trace), 6(Profile) 키로 토글, 0으로 초기화
• 정규 표현식 기반 검색: / 또는 Ctrl+F로 검색 바 열기, Ctrl+R로 정규식 모드 전환, n/N으로 매칭 결과 간 이동
• 날짜 필터: Ctrl+D로 열기, 최근 1시간/24시간/오늘/어제/최근 7일 등 빠른 필터 및 커스텀 범위 지정 가능
• 제외 필터: x로 패턴 입력하여 특정 항목 숨김, Alt+클릭으로 즉시 제외, X로 모든 제외 필터 해제
• 알림 키워드: !로 열기, 지정된 패턴과 일치할 때 터미널 벨 울림 및 고유 색상으로 강조

로그 분석 및 처리

• 다중 파일 병합: M으로 추가 파일을 현재 뷰에 병합, 타임스탬프별 정렬 및 출처별 색상 표시
• 실시간 모드: t로 토글, 새 항목이 자동 스크롤되어 표시, 스효올 업 시 자동 일시정지
• 클러스터 감지: Ctrl+P → “Find repeating patterns”로 반복 패턴 스캔, 변수 부분을 플레이스홀더로 대체하여 유사 항목 클러스터링
• 통계 대시보드: F2로 열기, 항목 수, 에러율, 레벨 분포, 이벤트율 타임라인 표시, HTML 내보내기 지원
• 내보내기: Ctrl+S로 현재 필터링된 항목을 파일로 내보내기
• 멀티라인 항목 지원: 스택 트레이스, JSON 페이로드 등 여러 줄에 걸친 항목 자동 접기 및 펼침(Enter), 상세 팝업(d)

설치 방법

Windows 사용자는 winget을 사용하여 설치할 수 있습니다.

winget install Feho.LogNav

모든 플랫폼에서 crates.io를 통해 설치할 수도 있습니다.

cargo install lognav

소스에서 직접 빌드할 경우 Rust 1.85 이상이 필요합니다.

기본 사용법

터미널에서 아래 명령으로 파일을 직접 열거나 프로그램을 실행할 수 있습니다.

lognav /path/to/app.log   # 파일 직접 열기
lognav                    # 실행 후 'o'로 파일 열기

LogNav은 로그 형식을 자동 감지하여 항목을 표시하기 시작합니다. 화면 하단의 도움말을 참고하여 다양한 기능을 사용할 수 있습니다.

지원 환경

Windows(x64), Linux, macOS에서 동작합니다. Windows용 정적 바이너리는 별도의 런타임 설치 없이 사용할 수 있습니다.

제한 사항

• 터미널 전용 애플리케이션으로, 그래픽 사용자 인터페이스가 필요 없는 환경에 적합합니다.
• 비텍스트 바이너리 로그나 특수 포맷은 자동 감지가 어려울 수 있습니다.
• 커스텀 로그 형식은 TOML 파일을 통해 정의할 수 있습니다.

라이선스

MIT 라이선스 또는 Apache License 2.0 중 선택하여 사용할 수 있습니다.