管理対象ノードおよび自己管理ノードでのアプリケーション・ログの表示
Kubernetes Engine (OKE)を使用して作成したKubernetesクラスタ内の管理対象ノードおよび自己管理ノードで実行されているアプリケーションのログを表示する方法を確認します。
Kubernetes Engineを使用してクラスタを作成した後、Oracle Cloud Infrastructure Loggingを使用して、クラスタ内の管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスで実行されているアプリケーションのログを表示および検索できます。
Oracle Cloud Infrastructure Loggingを使用してアプリケーション・ログを収集および解析する前に:
- すでに次のようにしてある必要があります:
- 管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスのモニタリングが有効です(コンピュート・インスタンスのモニタリングの有効化を参照)。
- 管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスにOracle Cloud Agentソフトウェアをインストールしました。エージェントを使用すると、収集するログとその解析方法を指定できます。エージェントは、管理対象ノードのコンピュート・インスタンスにデフォルトでインストールされます。エージェントがすでにインストールされていることを確認するには、エージェントのインストールの検証を参照してください。
- すでに次のようにしてある必要があります:
- 管理対象ノードおよび自己管理ノードをターゲット・ホストとしてホストするコンピュート・インスタンスを含むルールを使用して動的グループを作成しました(動的グループについておよび動的グループを使用したターゲット・ホストの選択を参照)。例:
instance.compartment.id = 'ocid1.tenancy.oc1..<unique-id>' - 動的グループ内のターゲット・ホストがログをOracle Cloud Infrastructure Loggingにプッシュできるようにするポリシー・ステートメントを使用して、動的グループのポリシーを作成しました(動的グループを使用したターゲット・ホストの選択を参照)。例:
allow dynamic-group <dynamic-group-name> to use log-content in tenancy動的グループがデフォルトのアイデンティティ・ドメインにない場合は、
dynamic-group '<identity-domain-name>'/'<dynamic-group-name>'の形式で、動的グループ名の前にアイデンティティ・ドメイン名を追加します。dynamic-group id <dynamic-group-ocid>の形式で、そのOCIDを使用して動的グループを指定することもできます。
- 管理対象ノードおよび自己管理ノードをターゲット・ホストとしてホストするコンピュート・インスタンスを含むルールを使用して動的グループを作成しました(動的グループについておよび動的グループを使用したターゲット・ホストの選択を参照)。例:
前述の前提条件を満たしたら、カスタム・ログおよび関連するエージェント構成を定義して、管理対象ノードおよび自己管理ノードをホストしているコンピュート・インスタンスのアプリケーション・ログを表示できます。アプリケーション・ログは、エージェント構成の作成時に指定するファイル・パス(通常は/var/logs/containers)に出力する必要があります。カスタム・ログおよびエージェント構成の詳細は、カスタム・ログを参照してください。
管理対象ノードおよび自己管理ノードをホストしているコンピュート・インスタンスでのアプリケーション・ログの表示に加えて、次のこともできます:
- クラスタ自体、ノード・プールおよびノードの全体的なステータスをモニターします。クラスタのモニタリングを参照してください。
- クラスタのコントロール・プレーンで実行されているKubernetesプロセス(kube-scheduler、kube-controller-manager、cloud-controller-manager、kube-apiserverなど)のログを表示および検索します。Kubernetes Engine (OKE)サービス・ログの表示を参照してください。
- メトリック、アラームおよび通知を使用して、クラスタ、ノード・プールおよびノードのヘルス、容量およびパフォーマンスをより詳細なレベルでモニターします。Kubernetes Engine (OKE)メトリックを参照してください。
コンソールの使用
新しいカスタム・ログ・オブジェクトおよび関連するエージェント構成を定義して、クラスタ内の管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスで実行されているアプリケーションのログを表示および検索できるようにするには:
- ナビゲーション・メニューを開き、「監視および管理」を選択します。「ロギング」で、「ログ」を選択します。
- 作業する権限があるコンパートメントを選択します。
- 「カスタム・ログの作成」をクリックして、新しいカスタム・ログを作成します。
-
「カスタム・ログの作成」ページで、次を指定します:
- カスタム・ログ名: 新しいカスタム・ログに選択した名前。機密情報の入力は避けてください。
- コンパートメント: 新しいカスタム・ログを作成するコンパートメント。
- ログ・グループ: カスタム・ログを配置するログ・グループ。オプションで、「新規グループの作成」をクリックして、新しいログ・グループを作成します(ログおよびログ・グループを参照)。
- オプションで、「追加オプションの表示」をクリックし、次を指定します:
- ログの保持:カスタム・ログを保持する時間(月)。事前定義済オプションのいずれかを選択するか、「カスタム時間」を選択して、選択した月数(最大60)を指定します。
- タグ付けオプション: リソースの作成権限がある場合は、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済のタグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に連絡してください。タグは後で適用できます。
-
「カスタム・ログの作成」をクリックします。
新しいカスタム・ログが作成され、「エージェント構成の作成」ページが表示されます。
便宜上、これらの手順では、新しいカスタム・ログに関連付けられた新しいエージェント構成を作成する方法について説明します(ただし、後で必要に応じて新しいエージェント構成を作成できます)。
-
「エージェント構成の作成」ページで、「新規構成の作成」を選択し、次を指定します:
- 構成名: 新しいエージェント構成に選択した名前。機密情報の入力は避けてください。
- 説明:新しいエージェント構成の説明。
- コンパートメント: 新しいエージェント構成を作成するコンパートメント。
- 「エージェント構成の作成」ページの「ホスト・グループ」パネルで、次のように指定します:
- グループ・タイプ: 「動的グループ」を選択します。
- グループ:クラスタの管理対象ノード・プール内の管理対象ノードがターゲット・ホストとして含まれる既存の動的グループ。選択する動的グループには、エージェント構成に指定したコンパートメントへのアクセス権限が必要です。また、ターゲット・ホストがログをOracle Cloud Infrastructure Loggingにプッシュできるようにする必要もあります。
-
「エージェント構成の作成」ページの「エージェント構成」パネルで、次の指定をします:
- ログ入力の構成: 次のように、カスタム・ログへの入力としてアプリケーション・ログを取得する1つ以上の場所:
- 入力タイプ: 「ログ・パス」を選択します。
- 入力名: 新しいログ入力用に選択した名前。
- ファイル・パス:管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンス上のアプリケーション・ログへのパス。たとえば、通常(必ずしもそうではない)
/var/logs/containers/*
- ログの宛先の選択:オプションには、以前に指定したカスタム・ログの詳細が事前移入されています。
- ログ入力の構成: 次のように、カスタム・ログへの入力としてアプリケーション・ログを取得する1つ以上の場所:
- オプションで、「追加オプションの表示」をクリックし、次を指定します:
- タグ付けオプション: リソースの作成権限がある場合は、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済のタグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に連絡してください。タグは後で適用できます。
- 「エージェント構成の作成」をクリックして、カスタム・ログに関連付けられたエージェント構成を作成します。
クラスタ内の管理対象ノードおよび自己管理ノードをホストするコンピュート・インスタンスで実行されているアプリケーションに対して作成されたカスタム・ログの内容を表示および検索するには:
- ナビゲーション・メニューを開き、「監視および管理」を選択します。「ロギング」で、「ログ」を選択します。
- 表示するカスタム・ログの名前をクリックします。ログ・エントリを経過時間でソートし、時間でフィルタできます。
- (オプション)「アクション」をクリックし、「ログ検索で探索」を選択して、集中ロギングの「検索」ページを開きます。フィルタを適用し、様々な方法でログ・データを探索およびビジュアル化できます(コンピュート・インスタンスのカスタム・ログの表示を参照)。