Skip to content

Latest commit

 

History

History
133 lines (87 loc) · 6.84 KB

README.ja.md

File metadata and controls

133 lines (87 loc) · 6.84 KB

Kubernetes History Inspector

Language: English | 日本語

ヘッダー

Kubernetes History Inspector (KHI) は、Kubernetesクラスタのログ可視化ツールです。 大量のログをインタラクティブなタイムラインビューなどで可視化し、Kubernetesクラスタ内の複数のコンポーネントにまたがる複雑な問題のトラブルシューティングを強力にサポートします。

機能と特徴

  • 事前設定不要: クラスタ内のエージェントなどの事前導入を必要とせず、既存のログから可視化を提供します。さらに、ログがログバックエンド上に保持されている限り、過去の問題のトラブルシューティングにも活用できます。

  • 圧倒的に簡単なログ収集: KHIは、Kubernetes関連ログの収集を大幅に簡素化します。複雑なログフィルタを記述せず、インタラクティブなGUIを利用してクエリを生成・実行できます。

機能: ログ収集のための迅速かつ簡単なステップ

  • インタラクティブなタイムラインによる包括的なクラスタの可視化: さまざまなログを用いて、クラスタ上で発生した事象を包括的に可視化します。
    • リソース履歴の可視化: リソースの状態をタイムライン上に表示します。また、監査ログを解析し変更履歴を確認できます。
    • 複数のリソースタイプにわたる複数のログタイプの可視化: 関連リソース間のさまざまな種類のログを関連付け、全体像を提供します。
    • リソース間のログのタイムライン比較: タイムラインビューでは、リソース間のログを時間軸で比較できるため、関係性と依存関係を容易に特定できます。
    • 強力なインタラクティブフィルター: ログの処理をインメモリで処理することで、対話的にログをフィルタリングし、大規模なデータセット内から必要な情報を迅速に特定できます。

機能: タイムラインビュー

  • リソースの関連性の可視化 (アルファ機能): 特定の時点での Kubernetes クラスタのリソースの状態とそれらの関係を示す図を生成できます。これにより、インシデント発生時のクラスタにおけるリソース同士の関連性を把握できます。

機能: リソース図

システム要件

Kubernetesクラスタ

ログバックエンド

  • Google Cloud

    • Cloud Logging（Google Cloud上のすべてのクラスタ）

  • その他環境

    • （近日公開予定）ファイルによるログアップロード

実行方法

Dockerイメージから実行

動作環境

  • Google Chrome（最新版）

Important

動作環境以外でのご利用、または動作環境下でもブラウザの設定によっては正しく動作しない場合がございます。

KHIの実行

  1. Cloud Shell を開きます。
  2. docker run -p 8080:8080 asia.gcr.io/kubernetes-history-inspector/release:latest を実行します。
  3. ターミナル上のリンク http://localhost:8080 をクリックして、KHI の使用を開始してください！

Tip

メタデータサーバーが利用できない他の環境でKHIを実行する場合は、プログラム引数でアクセストークンを渡します。

$ docker run -p 8080:8080 asia.gcr.io/kubernetes-history-inspector/release:latest -access-token=`gcloud auth print-access-token`

Note

コンテナイメージの配信元は近いうちに変更される可能性があります。 #21

詳細は Getting Started を参照してください。

ソースから実行

動かしてみる (ソースから実行)

動作環境

  • Go 1.23.*
  • Node.js環境 18.19.*
  • gcloud CLI
  • Google Chrome (最新版)

環境構築

  1. このリポジトリをダウンロードまたはクローンします。
    例: git clone https://github.com/GoogleCloudPlatform/khi.git
  2. プロジェクトルートに移動します。
    例: cd khi
  3. プロジェクトルートから cd ./web && npm install を実行します。

KHIの実行

  1. gcloud で認証します。
    例: ユーザーアカウントの認証情報を使用する場合は、gcloud auth login を実行します。
  2. プロジェクトルートから make build-web && KHI_FRONTEND_ASSET_FOLDER=./dist go run cmd/kubernetes-history-inspector/main.go を実行します。
    localhost:8080 を開き、KHIの使用を開始してください！

権限設定

Google Cloud

以下の権限が設定されている必要があります:

必須

  • logging.logEntries.list

Optional

こちらの権限はログフィルタを生成するダイアログで入力候補の補完を出すために使われます。 ない場合でも補完が出ないだけで、KHIのメインの機能の利用に影響はありません。

  • 対象のクラスタのタイプに対するリスト権限 (e.g 例えばGKEの場合 container.clusters.list)

ユーザーガイド

ユーザーガイド をご確認ください。

貢献

プロジェクトへの貢献をご希望の場合は、コントリビューティングガイド をお読みください。

免責事項

KHIはGoogle Cloudの公式製品ではございません。不具合のご報告や機能に関するご要望がございましたら、お手数ですが当リポジトリのGithub issuesにご登録ください。可能な範囲で対応させていただきます。