pamburus/hl

어떤 프로젝트인가요?

핵심 기능

• 01JSON 및 logfmt 로그를 색상을 적용해 읽기 쉬운 형식으로 변환합니다.
• 02쿼리 언어를 사용해 로그 수준, 타임스탬프 범위, 필드 값으로 필터링합니다.
• 03압축 파일(gzip, bzip2, xz, zstd)을 직접 읽습니다.
• 04인덱스를 사용해 여러 파일의 항목을 시간순으로 정렬합니다.
• 05여러 실시간 소스를 추적하고 타임스탬프 순서로 병합합니다.
• 06테마, 시간 형식, 시간대를 설정할 수 있습니다.

활용 사례

• 디버깅 중 터미널에서 JSON 애플리케이션 로그를 살펴봅니다.
• 여러 Kubernetes 파드의 로그를 하나의 타임라인으로 병합해 실시간으로 확인합니다.
• 로테이션된 압축 로그 아카이브에서 특정 오류나 시간 범위를 검색합니다.

빠른 시작

1. 1

   macOS에서 Homebrew로 설치

   brew install hl
2. 2

   로그 파일 보기(기본적으로 less 페이저 사용)

   hl example.log

사용 전 알아둘 점

• !less와 같은 외부 페이저에 의존합니다. 내장 페이저는 없으며, README에서 언급된 Windows용 less 빌드에서는 ANSI 색상이 깨지는 문제가 알려져 있습니다.

토픽

자주 묻는 질문

hl은(는) 무엇인가요?

JSON 및 logfmt 로그를 읽기 쉬운 형식으로 보여 주고 필터링, 정렬, 실시간 추적을 지원하는 명령줄 로그 뷰어입니다. hl은 구조화된 로그를 읽기 위한 명령줄 도구입니다. JSON 및 logfmt 로그 항목을 파싱해 색상, 설정 가능한 시간 형식과 시간대, 선택적 필드 숨기기를 적용한 읽기 쉬운 레이아웃으로 표시합니다. 일반 파일과 여러 파일을 한 번에 읽을 수 있으며 gzip, bzip2, xz, zstd 같은 압축 형식도 지원합니다.

hl은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

hl은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

hl은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. hl의 마지막 커밋은 2026년 10월 19일입니다.

hl은(는) 어디에 사용할 수 있나요?

디버깅 중 터미널에서 JSON 애플리케이션 로그를 살펴봅니다. 여러 Kubernetes 파드의 로그를 하나의 타임라인으로 병합해 실시간으로 확인합니다. 로테이션된 압축 로그 아카이브에서 특정 오류나 시간 범위를 검색합니다.

hl는 어떻게 설치하나요?

macOS에서 Homebrew로 설치: brew install hl 로그 파일 보기(기본적으로 less 페이저 사용): hl example.log

hl은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pamburus/hl