# hl - JSON/logfmt 로그를 사람이 읽기 쉬운 형태로 바꿔주는 고성능 로그 뷰어

> Clean Markdown view of GeekNews topic #24788. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=24788](https://news.hada.io/topic?id=24788)
- GeekNews Markdown: [https://news.hada.io/topic/24788.md](https://news.hada.io/topic/24788.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-12-03T09:31:01+09:00
- Updated: 2025-12-03T09:31:01+09:00
- Original source: [github.com/pamburus](https://github.com/pamburus/hl)
- Points: 44
- Comments: 0

## Summary

**JSON**과 **logfmt** 로그를 깔끔한 단일 뷰로 정리해주는 고성능 CLI 로그 뷰어입니다. 초당 **2GiB 스캔 속도**로 수백 GB 규모의 로그를 빠르게 탐색하며, **필드·레벨·시간 필터링**과 **쿼리 언어**를 통해 복잡한 조건도 한 번에 처리합니다. 실시간 **follow 모드**, **색상 테마**, **다양한 설치 옵션**까지 갖춰 개발·운영 환경 어디서든 유연하게 쓸 수 있습니다. 거대한 로그 덤프를 다루며 grep과 jq 사이에서 방황하던 분들에게 특히 반가운 도구입니다.

## Topic Body

- JSON 및 logfmt 형식 로그를 파싱해 **사람이 읽기 좋은 단일 뷰**로 보여주는 고성능 로그 뷰어·프로세서  
- 대용량 로그 파일에서 초당 **2GiB 수준 스캔 속도**, 수백 GB 규모·수백 개 파일까지 빠르게 처리  
- **필드 기반 필터링(-f)**, **레벨 필터링(-l)**, **타임스탬프 범위 필터링(--since/--until)** 을 지원해 복잡한 조건의 로그 탐색을 단일 툴로 처리  
- 논리 연산자·집합 연산·부분 문자열·와일드카드·정규식 등을 조합하는 **쿼리 언어(--query)** 를 제공해 정교한 로그 질의 구성 가능  
- 기본적으로 **less 등 외부 페이저와 자동 연동**되며, `--paging`/`-P` 옵션으로 자동/항상/사용 안 함을 세밀하게 제어  
- `-s` 옵션으로 로그를 시간순 정렬하고, 인덱싱을 통해 이후 필터링 시 **재스캔 없이 빠른 조회** 가능  
- `-F` **follow 모드**와 `--tail` 옵션을 통해 여러 소스의 실시간 로그를 합쳐 시간순으로 스트리밍 관찰하는 기능 제공  
- `--hide`·`--hide '*'`·`--hide '!field'` 조합으로 필드 단위 가리기·보이기를 제어하고, `-e`/`-E`로 빈 필드 자동 숨김 여부를 선택  
- `--time-format`, `--time-zone`, `--local` 옵션과 환경변수를 통해 **시간 포맷·타임존**을 유연하게 설정  
- YAML/TOML/JSON 기반 **설정 파일**과 `HL_` 접두사로 시작하는 환경변수, CLI 인자를 계층적으로 병합하는 설정 시스템 제공  
- **테마 시스템**을 통해 다크/라이트·16색/256색/트루컬러 등 다양한 색상 테마 적용 및 사용자 정의 테마 파일 로딩 지원  
- macOS(Homebrew), Linux(curl+tar, pacman, cargo), Windows(Scoop, cargo), NixOS(nix run/profile) 등 다양한 플랫폼 설치 경로를 공식 지원

## Comments



_No public comments on this page._