pamburus/hl

これは何？

主な機能

• 01JSONやlogfmtのログを、色付きの読みやすい形式に変換します。
• 02クエリ言語を使って、ログレベル、タイムスタンプの範囲、フィールド値でフィルタリングできます。
• 03圧縮ファイル（gzip、bzip2、xz、zstd）を直接読み込めます。
• 04インデックスを使い、複数ファイルのログを時系列順にソートできます。
• 05複数のライブソースを追跡し、タイムスタンプ順にマージできます。
• 06テーマ、時刻の形式、タイムゾーンを設定できます。

ユースケース

• デバッグ中に、ターミナルでJSON形式のアプリケーションログを確認する。
• 複数のKubernetes Podのログを1つの時系列にまとめて追跡する。
• ローテーション済みの圧縮ログアーカイブから、特定のエラーや時間範囲を検索する。

クイックスタート

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 Podのログを1つの時系列にまとめて追跡する。 ローテーション済みの圧縮ログアーカイブから、特定のエラーや時間範囲を検索する。

hl のインストール方法は？

macOSでHomebrewを使ってインストールする: brew install hl ログファイルを表示する（デフォルトではlessページャーを使用）: hl example.log

hl はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/pamburus/hl