このページでは、失敗したポッドのログを収集するクラスタエージェント機能を有効にして使用する方法について説明します。この機能は、SaaS コントローラでは自動的に有効になります。このページで説明するように、オンプレミスコントローラを有効にする必要があります。

有効にすると、クラスタエージェントは再起動または失敗したポッドのログを自動的に収集します。ポッド障害ログは、「Back-off restarting failed container」というメッセージを表示する CrashLoopBackoff イベントのステータスをキャプチャします。このメッセージは通常、Kubernetes がコンテナを開始後すぐに終了したことを示します。この場合、Kubernetes ではコンテナの再起動を試行します。これらのログメッセージを使用すると、ポッドが終了する理由（稼働状況プローブ、またはその他の問題が原因かどうか）を判断できます。

最小要件

クラスタエージェントのログ収集機能では、次の要件を満たす必要があります。

  • クラスタエージェント 20.7 以降
  • コントローラ 20.10.0 以降

オンプレミスコントローラを有効にするための要件

  • クラスタエージェント構成設定 sim.cluster.logs.capture.enabled を使用して、ロギングを有効にします。

  • コントローラ設定 sim.cluster.logs.root.file.path を使用して、ファイルのフルパスを更新し、ログを保存します。ログは指定されたファイルの場所に保存されます。

  • ファイルシステムに 50 GB のハードディスク容量があることを確認します。
  • ファイルパスを更新する場合は、以前に収集したログを古いパスから新しいパスに移動して、コントローラ UI に表示されるようにしてください。

コントローラの設定

次の表に、オンプレミス環境に必要なログ設定を示します。

SaaS の場合、テクニカルサポートチームが構成プロパティを更新します。したがって、SaaS のログを構成するには、AppDynamics サポートチケットを作成してサポートチームに連絡してください。

設定定義[ロケーション（Location）]デフォルト

sim.cluster.logs.bucket.name

ポッドログを保存するフォルダ名。

ルートユーザ権限を持つコントローラ管理コンソール（Controller Settings）

kubernetes-log-snippets

sim.cluster.logs.capture.enabled

ログキャプチャを有効または無効にするオプション。

このオプションは、デフォルトで無効です。

ルートユーザ権限を持つコントローラ管理コンソール

この設定は、アカウントレベル（Account Settings）とコントローラレベル（Controller Settings）の両方で設定できます。

true

sim.cluster.logs.expiration.in.days

ログがストレージからクリアされるまでの日数。ルートユーザ権限を持つコントローラ管理コンソール（Controller Settings）10

sim.cluster.logs.root.file.path

ログを保存する完全なルートファイルパス。
パスを変更すると、ログは新しいパスに保存されますが、古いログは前の場所に残ります。		ルートユーザ権限を持つコントローラ管理コンソール（Controller Settings）/opt/appdynamics
sim.cluster.failed.pod.limit履歴ポッドの数が、この値を超えると消去されます。ルートユーザ権限を持つコントローラ管理コンソール（Controller Settings）1000

クラスタエージェントログ収集の使用

[Pod Details] ページと [Cluster Event] ページでログを表示できます。

[Pod Details] ページ

  1. [Servers > Clusters > Cluster Name] を選択します。
  2. クラスタエージェントを選択し、ダブルクリックします。クラスタインターフェイスに、[Dashboard]、[Pods]、[Inventory]、[Events] の各タブが表示されます。
  3. [Pods] をクリックします。
  4. 任意のポッドをダブルクリックして、[Pod Details ] パネルを表示します。. 
  5. 次を確認してください。Error Log.
    Error Log on Pod Details page includes timestamp and status of log trigger
  6.  ログを表示するには、Actionsアイコンをクリックします。
    The details of the error log is displayed along with timestamp and the log trigger status

[Cluster Events] ページ

  1. [Servers] タブをクリックします。
  2. 左側のナビゲーションバーで、[Events ] を選択して、サーバとクラスタの両方から報告されたイベントのリストを表示します。
    または
    [Clusters > <Clustername> > Details > Events] を選択します。
  3. クラスタイベントをダブルクリックすると、[Logs] タブの下にログが表示されます。
    Cluster Event Logs tab includes the log details