Loki — Kubernetes ログ集約サーバー
この例では、小規模ながら実用的なスタックである Grafana Loki ログ集約
サーバーを、Developer が作成した 1 つの Aggregate から Kubernetes 向けにコンパイルします。
その基盤には、シングルバイナリ構成の 公式 Grafana Loki Helm チャート を使用します。
Loki はログバックエンドです。HTTP プッシュ API でログストリームを受信し、 全文の内容ではなくラベルでインデックスを作成してチャンクオブジェクト ストアに保存し、同じ HTTP API でログクエリと範囲リクエストに応答します。 シングルバイナリ構成では、distributor、ingester、querier、compactor といった すべての Loki サブシステムが、ローカルのチャンクストアを基盤とする 1 つのプロセス内で動作するため、 サーバー全体が 1 つのステートフルなワークロードになります。ログシッパーがストリームを Loki にプッシュし、 ダッシュボードサーバーがクエリ API でそれを読み出します。
ファイル
| ファイル | 役割 |
|---|---|
aggregate.yaml | Developer の意図:ログを 7 日間保持する単一の logging コンポーネント(core/observability/loki)。 |
manifest.yaml | コンポーネントタイプを Loki のソース由来の Recipe(loki)にマッピングします。 |
release.yaml | Kubernetes ターゲット向けの Operator のレコード:サーバーのコンピュートとチャンクストアのボリュームサイズ。 |
示す内容
- 単一のオーサリング面。 1 つの Aggregate が Loki が 何であるか の 信頼できる情報源となり、Manifest がそれを どのように 実現するかを示します。
- シングルバイナリのログバックエンド。 ソース由来の Recipe は、Loki を
データボリュームを持つ 1 つの
StatefulSet、設定を格納するConfigMap、 HTTP プッシュおよびクエリのエンドポイントを公開するService、そしてServiceAccountとして レンダリングします。分散スケーリングの経路や同梱の補助サービスは無効化された、 単一の自己完結したワークロードです。 - Developer が設定する保持期間。 Developer の
retention_periodはプロセス内の compactor に渡され、compactor はその期間を過ぎた保存済みログストリームを削除します。 - エクスポートされる取り込みコントラクト。 コンポーネントはクラスター内の
サービスのホストとポートを
usesトポロジーを通じてエクスポートするため、ログシッパーは そこに接続してストリームをプッシュします。 - 再現可能なイメージ。 Recipe は Loki サーバーイメージと設定リロード用サイドカーイメージを解決可能なタグに固定するため、レンダリングされたワークロードは固定されたバージョンを参照します。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example loki-loggingその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd loki-loggingビルド
このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。
aggrega pull --release release.yamlaggrega build --release release.yamlレンダリングされた成果物は dist/ 以下に出力されます。ビルドは aggrega pull 時に
アップストリームのチャートを OCI 参照で解決し、ロックファイルに固定します。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `loki-logging` フォルダーがない場合は、`example` を `loki-logging` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。これにより、例が新しい `loki-logging` フォルダーに書き込まれます。次に、`workspace_root` を `loki-logging`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `loki-logging/dist/` の下にあります。レンダリングされるもの
ビルドは Loki サーバーを、自己完結した 1 組の Kubernetes オブジェクトとして出力します:
StatefulSet— シングルバイナリの Loki プロセス。チャンクストアは 永続ボリューム上に置かれます。ConfigMap— Loki の設定とランタイム設定。Service— ポート 3100 で HTTP プッシュおよびクエリのエンドポイントを公開します。- ワークロード用の
ServiceAccountとそのアクセスバインディング。
分散構成の read/write/backend ワークロード、オブジェクトストアのサブチャート、キャッシュ、オペレーターはいずれもレンダリングされません。レンダリング結果は単一の Loki ワークロードです。Loki サーバーと設定リロード用サイドカーのイメージはリリースタグに固定されているため、ワークロードは固定されたイメージを参照します。