Loki Logo

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

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

他のログ集約システムと比較して、Loki は次の特徴を持ちます:

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

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

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

Promtail は機能が完成したと見なされており、ログ収集の今後の開発は Grafana Alloy で行われるため、スタック内の Promtail は Alloy に置き換えられたことに注意してください。

Loki は Prometheus のようなものですが、ログ向けです: 私たちは多次元のラベルベースのアプローチによるインデックス化を好み、依存関係のない、運用が容易なシングルバイナリのシステムを望んでいます。 Loki が Prometheus と異なるのは、メトリクスではなくログに焦点を当てており、ログを pull ではなく push で配信する点です。

はじめに

⚠️ Helm チャートの移行

2026 年 3 月 16 日をもって、Grafana Loki Helm チャートは新しいリポジトリ grafana-community/helm-charts にフォークされます。Loki リポジトリ内のチャートは GEL ユーザーのみを対象に維持され続けます。詳細は #20705 を参照してください。

アップグレード

Loki のアップグレード

ドキュメント

最新リリース
次回リリース、main ブランチの先端

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

Loki にログを取り込むための API ドキュメント。
ラベル
運用
Docker Driver Client は、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: Log Aggregation for Incident Investigations」。
Grafana Labs のブログ記事「How We Designed Loki to Work Easily Both as Microservices and as Monoliths」。
Tom Wilkie による 2019 年初頭の CNCF Paris/FOSDEM での講演「Grafana Loki: like Prometheus, but for logs」(スライド、動画)。
David Kaltschmidt による KubeCon 2018 での講演「On the OSS Path to Full Observability with Grafana」(スライド、動画)。Loki がクラウドネイティブ環境にどのように適合するかについて解説しています。
Goutham Veeramachaneni のブログ記事「Loki: Prometheus-inspired, open source logging for cloud natives」。Loki アーキテクチャの詳細について解説しています。
David Kaltschmidt のブログ記事「Closer look at Grafana's user interface for 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 を使用してバイナリをビルドできます。これにより、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

人気