ドキュメント

リアルタイムログ

約1分で読めます · このページを GitHub で編集

← ShimoDocs Suite デプロイメント文書

機能概要

リアルタイムログは、クラスタ内のサービスの操作ログをオンラインで表示するために使用され、 Kubernetes サービスの異常、リクエストの失敗、および実行遅延を迅速に特定することができます。

主な使用例:

  • リアルタイムでトリガーされたログを迅速にフィルタリング
  • フルログシステムが配置されていない場合の軽量な代替手段

注意: リアルタイムログは以下を通じて取得されます Kubernetes API、ログデータは~の影響を受ける場合があります Kubernetes ロールリング更新。

ページへのアクセス

管理コンソールにログインした後、選択してください リアルタイムログ 左のナビゲーションからページに入る。

リアルタイムログは、次でのみサポートされています Kubernetes 展開モード。このメニューが表示されない場合は、システム管理者に連絡して、展開モードと現在のアカウントのアクセス権限を確認してください。

ログの照会

以下の手順に従うことを推奨します:

  1. 選択 クラスター および NAMESPACE 照会したいクラスターを選択します。
  2. ログ対象を選択します。Deployment、StatefulSet、またはPodをサポートしており、複数の対象を同時に選択できます。
  3. ログ範囲を選択します。最新100行、1000行、5000行、または過去1分から24時間のログを照会できます。
  4. 照会結果を絞り込むために、行レベルのフィルター条件を入力することができます。
  5. クリック 開始 選択した範囲内のログがページに読み込まれ、新しい生成ログが継続的に表示されます。

クリック 停止 リアルタイム取得を終了します。照会を再開すると、現在のページのログはクリアされ、新しい照会結果が読み込まれます。

ログフィルタリング

行レベルのフィルタリングは英字の大文字・小文字を区別しません。条件を入力した後にEnterキーを押すと適用されます。一般的な使い方は以下の通りです:

error
error AND timeout
error OR warning
error NOT health
error AND (timeout OR deadline)
"connection refused"
  • AND: 複数の条件を同時に含めます。
  • OR: 任意の条件を含めます。
  • NOT: 指定した内容を除外します。
  • (): 複数のフィルター条件を組み合わせます。
  • "": 空白を含む完全なフレーズを検索します。

入力ボックスの右側にあるヘルプボタンをクリックすると、完全な構文例を確認できます。また、 よくあるクエリ を使用して、プリセットのログ対象やフィルタ条件を素早く入力することもできます。

ログの閲覧

ログリストには、ログの時間、 POD_NAMEおよびログ内容が表示されます。

  • をクリックすると POD_NAME フルネームをコピーできます。
  • 内容が長い場合は、展開して完全なログを表示できます。
  • 形式のログは、フォーマット済みの内容に展開でき、ワンクリックでコピーに対応しています。 JSON
  • ログが多数ある場合、ページは自動的にページ分割され、リスト上部のボタンを使って上下に素早く移動できます。

ログ量分布

ページ上のログ量分布グラフには、異なる期間のログ数が表示され、フィルタ後の合計ログ行数および一致した行数が表示されます。

分布グラフ上で時間範囲をドラッグして選択すると、ログリストにはその時間範囲内の内容のみが表示され、ログの急増や異常が発生した期間にすばやく注目するのに適しています。

ページ操作

  • 開始: 現在の条件に基づいてログを取得し、新しいログを継続的に受信します。
  • 停止: 新しいログの受信を停止します。既に読み込まれたログはページに残ります。
  • クリア: 現在表示されているログをクリアします。リアルタイム取得が続いている場合、新しいログは引き続き表示されます。

一般的な状況

  • まだログがありません: 対象のサービスが稼働していることを確認し、ログの時間範囲を広げてください。
  • 対象が未選択: 少なくとも1つのDeployment、StatefulSet、またはPodを選択してください。
  • 対象が多すぎます: 1つのクエリでサポートできる実際のPodは最大20個です。選択を減らして再試行してください。
  • 無効なフィルター条件: 以下を確認してください AND, OR, NOT、括弧、または引用符が正しく閉じられているか。
  • ログ取得が中断されました: これはサービスの再起動、ネットワークの変更、または権限不足が原因である可能性があります。再度クリックしてください 開始

このページは最大500,000行のログを保持します。制限を超えると、古いログは自動的に削除されます。

操作インターフェイスの例

下の図は、リアルタイムログのワークロード選択、キーワードフィルタリング、およびログ表示エリアを示しています。

クリック クラスターを選択 & NAMESPACE ターゲットクラスターを切り替えて NAMESPACE、その後表示したいワークロードを選択し続けます。