非常に便利な Kubernetes リアルタイムログ表示ツール 2 つ

[[358056]]

通常、Kubernetes 環境のアプリケーションログは、Filebeat + ElasticSearch + Kibana の組み合わせなどのログシステムを通じて収集する必要があります。この組み合わせは非常に強力ですが、比較的単純なテストクラスターや、ブラウザーのない自動化/コンソール環境では、複数の Pod からのログを自動的にマージして集中的に表示することは、問題の処理や障害のデバッグに非常に役立ちます。

本日は、非常に便利なマルチコンテナのリアルタイムログ表示ツールである Stern と Kubetail を 2 つ紹介します。

スターン

Kubectl 自体の Log コマンドは、複数の Pod コンテナ内のログを同時に表示することをサポートしていません。スターンはこの問題を非常にうまく解決します。複数のコンテナのログを同時に追跡できることに加えて、次の強力な機能もサポートしています。

正規表現を使用して、末尾に付ける必要がある PodName を選択できるようにします。
異なるポッドのログ出力の色をカスタマイズする
ルールを満たす新しく作成されたポッドを自動的に追加して追跡する
....

プロジェクトアドレス: https://github.com/wercker/stern

スターンのインストール

Stern は Go 言語で開発されており、インストールが非常に簡単で、すぐに使用できます。対応するプラットフォームに関連するバイナリのプリコンパイル済みインストールパッケージをダウンロードするだけで使用できます。

Linux プラットフォームを例に挙げてみましょう。

 https://github.com/wercker/stern/releases/download/1.11.0/stern_linux_amd64 をダウンロードしてください
$ chmod +x stern_linux_amd64
 $ mv stern_linux_amd64 /usr/ローカル/bin

macOS を使用している場合は、Homebrew を使用して直接インストールできます。

 $ brew install stern

スターンの使用

Stern は多くの機能をサポートしており、使い方も豊富です。いくつかの一般的な例を見てみましょう。

現在の名前空間内のすべてのポッド内のすべてのコンテナのログをリアルタイムで表示する

$ スターン。

ポッド内の指定されたコンテナのログをリアルタイムで表示する

$ stern envvars --コンテナゲートウェイ

指定したコンテナを除く、指定した名前空間内のすべてのコンテナのログをリアルタイムで表示します。

ステージングコンテナを除外するには、 istio-proxy を実行します。

指定された時間範囲内のコンテナのログをリアルタイムで表示します。次の例では、15 分以内のログを示しています。

 $ stern auth -t --since 15m

指定した名前空間内のコンテナのログをリアルタイムで表示する

$ stern kubernetes-dashboard --namespace kube-system

すべての名前空間内の指定されたラベルを持つコンテナのログをリアルタイムで表示します。

 $ stern --all-namespaces -l run=nginx

詳しい使い方については、「公式ドキュメント」を参照してください。

クベテイル

Kubetail は、複数の Pod からのログをマージし、カラー出力をサポートするシェルスクリプトです。

プロジェクトアドレス: https://github.com/johanhaleby/kubetail

Kubetailをインストールする

Kubetail は単なるシェルスクリプトなので、ダウンロード後すぐに使用できます。

 $ wget https://raw.githubusercontent.com/johanhaleby/kubetail/master/kubetail
 $ chmod +x kubetail
 $ cp kubetail /usr/ local /bin

macOS を使用している場合は、Homebrew を使用して直接インストールすることもできます。

 $ brew Tap johanhaleby/kubetail && brew install kubetail

Kubetail は、Oh-my-zsh、Antigen などのさまざまな SHELL 管理フレームワークもサポートしています。具体的なインストール方法については、「公式インストールドキュメント」を参照してください。

Kubetailの使用

Kubetail の使い方も非常に簡単です。基本的な構文は次のとおりです。

 $ kubetail <検索語> [-h] [-c] [-n] [-t] [-l] [-d] [-p] [-s] [-b] [-k] [-v] [-r] [-i]

いくつかの一般的なパラメータの説明:

 -c: マルチコンテナポッド内のコンテナ名を指定します
-t: Kubeconfigファイルでコンテキストを指定する
-l: ラベル フィルター。 -l パラメータを使用した後、Pod 名は無視されます。
 -n: 名前空間を指定する
-s: 5 秒、2 分、3 時間などの相対時間後にログを返すように指定します。デフォルトは 10 秒です。
 -b: ラインバッファを使用するかどうか。デフォルトはfalse  
 -k: 出力内容の特定の色付け部分を指定、pod: ポッド名のみを色付け、line: 行全体を色付け（デフォルト）、 false : 色付けなし

いくつかの使用例:

 $ kubetail my-pod-v1
 $ kubetail my-pod-v1 -c 私のコンテナ
$ kubetail my-pod-v1 -t int1-context -c my-container
 $ kubetail '(サービス|コンシューマー|もの)' -e 正規表現
$ kubetail -l サービス=私のサービス
$ kubetail --selector service=my-service --since 10m  
 $ kubetail --tail 1