コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

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.yamlDeveloper の意図:ログを 7 日間保持する単一の logging コンポーネント(core/observability/loki)。
manifest.yamlコンポーネントタイプを Loki のソース由来の Recipe(loki)にマッピングします。
release.yamlKubernetes ターゲット向けの Operator のレコード:サーバーのコンピュートとチャンクストアのボリュームサイズ。

示す内容

  • 単一のオーサリング面。 1 つの Aggregate が Loki が 何であるか の 信頼できる情報源となり、Manifest がそれを どのように 実現するかを示します。
  • シングルバイナリのログバックエンド。 ソース由来の Recipe は、Loki を データボリュームを持つ 1 つの StatefulSet、設定を格納する ConfigMap、 HTTP プッシュおよびクエリのエンドポイントを公開する Service、そして ServiceAccount として レンダリングします。分散スケーリングの経路や同梱の補助サービスは無効化された、 単一の自己完結したワークロードです。
  • Developer が設定する保持期間。 Developer の retention_period はプロセス内の compactor に渡され、compactor はその期間を過ぎた保存済みログストリームを削除します。
  • エクスポートされる取り込みコントラクト。 コンポーネントはクラスター内の サービスのホストとポートを uses トポロジーを通じてエクスポートするため、ログシッパーは そこに接続してストリームをプッシュします。
  • 再現可能なイメージ。 Recipe は Loki サーバーイメージと設定リロード用サイドカーイメージを解決可能なタグに固定するため、レンダリングされたワークロードは固定されたバージョンを参照します。

サンプルを生成する

このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

Terminal window
aggrega scaffold --example loki-logging

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd loki-logging

ビルド

このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。

Terminal window
aggrega pull --release release.yaml
aggrega 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 サーバーと設定リロード用サイドカーのイメージはリリースタグに固定されているため、ワークロードは固定されたイメージを参照します。