Oracle Cloud Infrastructureドキュメント

管理対象ノードおよび自己管理ノードでのアプリケーション・ログの表示

Container Engine for Kubernetes (OKE)を使用して作成したKubernetesクラスタ内の管理対象ノードおよび自己管理ノードで実行されているアプリケーションのログを表示する方法を確認します。

Container Engine for Kubernetesを使用してクラスタを作成した後、Oracle Cloud Infrastructure Loggingを使用して、クラスタ内の管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスで実行されているアプリケーションのログを表示および検索できます。

Oracle Cloud Infrastructure Loggingを使用してアプリケーション・ログを収集および解析する前に:

  • すでに次のようにしてある必要があります:
    • 管理対象ノードおよび自己管理ノードをホストしているコンピュート・インスタンスのモニタリングを有効にします(コンピュート・インスタンスのモニタリングの有効化を参照)。
    • 管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスにOracle Cloud Agentソフトウェアをインストールしました。エージェントを使用すると、収集するログとその解析方法を指定できます。エージェントは、管理対象ノードのコンピュート・インスタンスにデフォルトでインストールされます。エージェントがすでにインストールされていることを確認するには、エージェントのインストールの検証を参照してください。
  • すでに次のようにしてある必要があります:

前述の前提条件を満たしたら、カスタム・ログおよび関連するエージェント構成を定義して、管理対象ノードおよび自己管理ノードをホストしているコンピュート・インスタンスのアプリケーション・ログを表示できます。アプリケーション・ログは、エージェント構成の作成時に指定したファイル・パス(通常は/var/logs/containers)に出力する必要があります。カスタム・ログおよびエージェント構成の詳細は、カスタム・ログを参照してください。

管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンス上のアプリケーション・ログの表示に加えて、次のことも可能です:

  • クラスタ自体、ノード・プールおよびノードの全体的なステータスをモニターします。クラスタのモニタリングを参照してください。
  • Kubernetesプロセスのログ(クラスタのコントロール・プレーンで実行されているkube-scheduler、kube-controller-manager、cloud-controller-manager、kube-apiserverなど)を表示および検索します。Container Engine for Kubernetesサービス・ログの表示を参照してください。
  • メトリック、アラームおよび通知を使用して、クラスタ、ノード・プールおよびノードのヘルス、容量およびパフォーマンスをより詳細なレベルでモニターします。Container Engine for Kubernetesメトリックを参照してください。

コンソールの使用

新しいカスタム・ログ・オブジェクトおよび関連するエージェント構成を定義して、クラスタ内の管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスで実行されているアプリケーションのログを表示および検索できるようにするには:

  1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「ロギング」で、「ログ」をクリックします。
  2. 作業する権限があるコンパートメントを選択します。
  3. 「カスタム・ログの作成」をクリックして、新しいカスタム・ログを作成します。

  4. 「カスタム・ログの作成」ページで、次を指定します:

    • カスタム・ログ名: 新しいカスタム・ログに選択した名前。機密情報の入力は避けてください。
    • コンパートメント: 新しいカスタム・ログを作成するコンパートメント。
    • ログ・グループ: カスタム・ログを配置するログ・グループ。オプションで、「新規グループの作成」をクリックして、新しいログ・グループを作成します(ログおよびログ・グループを参照)。
  5. オプションで、「追加オプションの表示」をクリックし、次を指定します:
    • ログの保持:カスタム・ログを保持する時間(月)。事前定義済オプションのいずれかを選択するか、「カスタム時間」を選択して、選択した月数(最大60)を指定します。
    • タグ付けオプション: リソースの作成権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済のタグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に問い合せてください。タグは後から適用できます。

  6. 「カスタム・ログの作成」をクリックします。

    新しいカスタム・ログが作成され、「エージェント構成の作成」ページが表示されます。

    便宜上、これらの手順では、新しいカスタム・ログに関連付けられた新しいエージェント構成を作成する方法について説明します(ただし、後で必要に応じて新しいエージェント構成を作成できます)。

  7. 「エージェント構成の作成」ページで、「新規構成の作成」を選択し、次を指定します:

    • 構成名: 新しいエージェント構成に選択した名前。機密情報の入力は避けてください。
    • 説明:新しいエージェント構成の説明。
    • コンパートメント: 新しいエージェント構成を作成するコンパートメント。
  8. 「エージェント構成の作成」ページの「ホスト・グループ」パネルで、次を指定します:
    • グループ・タイプ: 「動的グループ」を選択します。
    • グループ:クラスタの管理対象ノード・プール内の管理対象ノードをターゲット・ホストとして含める既存の動的グループ。選択する動的グループには、エージェント構成に指定したコンパートメントへのアクセス権限が必要です。また、ターゲット・ホストがログをOracle Cloud Infrastructure Loggingにプッシュできるようにする必要もあります。

  9. 「エージェント構成の作成」ページの「エージェント構成」パネルで、次の指定をします:

    • ログ入力の構成: 次のように、カスタム・ログへの入力としてアプリケーション・ログを取得する1つ以上の場所:
      • 入力タイプ: 「ログ・パス」を選択します。
      • 入力名: 新しいログ入力用に選択した名前。
      • ファイル・パス:管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンス上のアプリケーション・ログへのパス。たとえば、通常(ただし必ずしもそうではない) /var/logs/containers/*
    • ログの宛先の選択:オプションには、以前に指定したカスタム・ログの詳細が事前移入されています。
  10. オプションで、「追加オプションの表示」をクリックし、次を指定します:
    • タグ付けオプション: リソースの作成権限がある場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済のタグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に問い合せてください。タグは後から適用できます。
  11. 「エージェント構成の作成」をクリックして、カスタム・ログに関連付けられたエージェント構成を作成します。

クラスタ内の管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスで実行されているアプリケーションに対して作成されたカスタム・ログの内容を表示および検索するには:

  1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「ロギング」で、「ログ」をクリックします。
  2. 表示するカスタム・ログの名前をクリックします。ログ・エントリを経過時間でソートし、時間でフィルタできます。
  3. (オプション)「アクション」をクリックし、「ログ検索で探索」を選択して、集中ロギングの「検索」ページを開きます。フィルタを適用し、様々な方法でログ・データを探索およびビジュアル化できます(コンピュート・インスタンスのカスタム・ログの表示を参照)。