Loki ロゴ

Loki: Prometheus のように、ただしログ向け。

Loki は、Prometheus に触発された、水平スケーラブルで高可用性、マルチテナントのログ集約システムです。コスト効率が非常に高く、運用が容易になるように設計されています。ログの内容ではなく、各ログストリームのラベルセットをインデックス化します。

他のログ集約システムと比較して、Loki には以下の特徴があります:

ログの全文インデックス作成は行いません。圧縮された非構造化ログを保存し、メタデータのみをインデックス化することで、Loki は運用が簡単で、実行コストも低くなります。
Prometheus で既に使用しているラベルと同じラベルを使用してログストリームをインデックス化およびグループ化し、同じラベルを使ってメトリクスとログをシームレスに切り替えることができます。
Kubernetes Pod ログの保存に特に適しています。Pod ラベルなどのメタデータは自動的にスクレイピングされ、インデックス化されます。
Grafana でネイティブにサポートされています (Grafana v6.0 以降が必要です)。

Loki ベースのロギングスタックは、3 つのコンポーネントで構成されます:

Alloy はエージェントであり、ログを収集して Loki に送信する役割を担います。
Loki はメインサービスであり、ログの保存とクエリの処理を担当します。
Grafana はログのクエリと表示を行います。

このスタックでは、Alloy が Promtail に取って代わりました。Promtail は機能が完成しているとみなされ、ログ収集の将来の開発は Grafana Alloy で行われるためです。

Loki は Prometheus と同様ですが、ログ向けです。インデックス作成には多次元のラベルベースのアプローチを採用し、依存関係のない単一バイナリで運用が容易なシステムを目指しています。Loki は Prometheus とは異なり、メトリクスではなくログに焦点を当て、プルではなくプッシュでログを配信します。

はじめに

⚠️ Helm Chart の移行

2026 年 3 月 16 日以降、Grafana Loki Helm チャートは新しいリポジトリ grafana-community/helm-charts にフォークされます。Loki リポジトリ内のチャートは、GEL ユーザーのためだけに引き続きメンテナンスされます。詳細は #20705 を参照してください。

アップグレード

Loki のアップグレード

ドキュメント

最新リリース
次期リリース、main ブランチの先端にあります。

よく使われるセクション:

API ドキュメント - ログを Loki に取り込むための API について。
ラベル
運用
Docker ドライバークライアント - Docker コンテナから Loki に直接ログを送信するための Docker プラグインです。
LogCLI - ログをクエリするためのコマンドラインインターフェースを提供します。
Loki Canary - Loki インストール環境で欠落したログを監視します。
トラブルシューティング - エラーメッセージへの対処に役立つ情報を提供します。
Grafana での Loki - Grafana で Loki データソースを設定する方法について説明します。

サポート

Loki に関する質問やフィードバックがあれば:

Grafana Labs コミュニティフォーラムの Loki に関する既存スレッドを検索: https://community.grafana.com
Loki Slack チャンネルで質問してください。Grafana Slack に参加するには、https://slack.grafana.com/ にアクセスし、#loki チャンネルに参加してください。
バグ、問題、機能提案については、Issue を報告してください。
[email protected] にメールを送信するか、ウェブインターフェースをご利用ください。
UI の問題は Grafana に直接報告してください。

フィードバックはいつでも歓迎します。

参考資料

Loki の元の設計ドキュメントは、動機と設計上の決定についての議論に適した資料です。
Callum Styan による 2019 年 3 月の DevOpsDays Vancouver での講演「Grafana Loki: インシデント調査のためのログ集約」。
Grafana Labs のブログ記事「Loki をマイクロサービスとモノリスの両方として簡単に動作させる設計方法」。
Tom Wilkie による 2019 年初頭の CNCF Paris/FOSDEM での講演「Grafana Loki: Prometheus と同様ですが、ログ向け」(スライド、ビデオ)。
David Kaltschmidt による KubeCon 2018 での講演「Grafana による完全な可観測性への OSS パス」(スライド、ビデオ)。Loki がクラウドネイティブ環境にどのように適合するかについての講演です。
Goutham Veeramachaneni のブログ記事「Loki: Prometheus に着想を得た、クラウドネイティブ向けのオープンソースロギング」は、Loki アーキテクチャの詳細を説明しています。
David Kaltschmidt のブログ記事「Grafana の Loki ユーザーインターフェースを詳しく見る」は、ロギングユーザーインターフェースに込められたアイデアについて述べています。

コントリビューション

CONTRIBUTING.md を参照してください。

ソースからのビルド

以下のコマンドを使用すると、Loki を単一ホスト、依存関係なしモードで実行できます。

最新の Go が必要です。Makefile に記載されているバージョンを使用することをお勧めします。

# Checkout source code
$ git clone https://github.com/grafana/loki
$ cd loki

# Build binary
$ go build ./cmd/loki

# Run executable
$ ./loki -config.file=./cmd/loki/loki-local-config.yaml

あるいは、Unix システムでは make を使ってバイナリをビルドすることもできます。make は go build コマンドに追加の引数を加えます。

# Build binary
$ make loki

# Run executable
$ ./cmd/loki/loki -config.file=./cmd/loki/loki-local-config.yaml

ローカルで複数の Loki テナントを実行するには、auth_enabled が true に設定されていることを確認し、テナント固有のオーバーライドを含むランタイム設定を指定してください。

# Build binary
$ make loki

# Run executable
./loki -config.file=./cmd/loki/loki-local-multi-tenant-config.yaml -runtime-config.file=./cmd/loki/loki-overrides.yaml

採用者

現在 Loki を使用している一部の組織については、ADOPTERS.md を参照してください。あなたの組織をリストに追加したい場合は、PR を開いてリストに追加してください。

ライセンス

Grafana Loki は AGPL-3.0-only の下で配布されています。Apache-2.0 の例外については、LICENSING.md を参照してください。

loki

人気