Oracle Cloud Infrastructureドキュメント

エージェント設定の構成

このアクション・ボタンを使用して、フリートに対して次の管理エージェント設定を変更します:
  • フリートの管理エージェントがJavaランタイムのインストールを検出するためにスキャンするホスト上のファイル・システム・パス
  • フリートの管理エージェントが使用状況およびJavaランタイム・インストール状況をJMSフリートにレポートする頻度

前提条件: フリート・ダッシュボードからフリートを選択しました。

  1. 「エージェント設定の構成」をクリックします。一般設定および管理エージェントがスキャンするファイル・システム・パスを変更するように求められます。フリート内のすべての管理エージェントによって、これらの設定が使用されます。
  2. 「一般設定」を変更します:
    1. JMSプラグイン・メトリックのレポート: 管理対象インスタンスにデプロイされたJMSプラグインのリソース使用率(CPU、メモリー、ディスク、ネットワーク)メトリックをレポートします。データは、管理対象インスタンスの詳細ページで使用できます。デフォルト値は「いいえ」です。
    2. アプリケーション起動ユーザー名の記録: 管理対象インスタンスのアプリケーション使用状況に関連付けられたユーザー名を収集します。データは、「管理対象インスタンスの詳細」ページの「アプリケーション」表で使用できます。デフォルト値は「はい」です。
      ノート

      この値がtrueに設定されている場合、管理エージェントのインストールおよびJMSプラグインのデプロイ中に管理対象インスタンスがこのJMSフリートに登録されると、Java Management ServiceプラグインによってJava使用状況トラッカが生成され、インスタンスの追加機能が提供されます。これにより、JMSは<user.name>プロパティを収集し、WebLogicやTomcatなどのアプリケーション・サーバーで実行されているアプリケーションをより適切に識別できます。この値がfalseに設定されている場合、使用状況トラッカには標準機能があります。

    3. Javaランタイム使用状況(分): 管理エージェントがJava使用状況をJMSフリートにレポートする必要がある頻度を指定します。値は5分から90分の間にする必要があります。デフォルト値は60分です。
    4. エージェントのポーリング間隔: 管理エージェントが作業リクエストをチェックする頻度を指定します。ポーリング間隔の単位(分または時間)を選択します。たとえば、指定された値が10分の場合、エージェントは作業リクエストを10分ごとにチェックして実行します。値は10分から12時間の間にする必要があります。デフォルト値は10分です。
    5. 作業リクエストの有効性: JMSフリートが作業リクエストを格納する期間を指定します。必要な単位(日数または週数)を選択します。値は7から30日の間にする必要があります。デフォルト値は2週間です。
  3. ファイル・スキャン設定を変更します:
    1. Javaランタイム検出: 管理エージェントがホストをスキャンしてJavaランタイム・インストールを行う頻度を指定します。「単位」、「分」または「時間」を選択します。値は3時間から24時間である必要があります。デフォルト値は24時間です。
      管理エージェントによるJavaランタイム・インストールのスキャンを停止するには、「Javaランタイム検出の有効化」の選択を解除します。
    2. 管理エージェントがJavaランタイム・インストールを見つけるためにLinuxおよびWindowsホストでスキャンするファイル・システム・パスを変更します。
      ディレクトリをカスタマイズする理由は次のとおりです:
      • カスタマイズ: /etc/javaなどの独自のJavaランタイム・インストールを含めます。
      • パフォーマンス: パスを除外して、管理エージェントがスキャンに要する時間を短縮し、プロセッサの負荷を引き下げ、メモリー使用量を減らします。
      • プライバシ: パスを除外することで、非公開にしておくコンテンツを含むディレクトリを省きます。
    3. 各オペレーティング・システムの「除外するパス」セクションに、スキャンから除外するファイル・システム・パスのリストを指定します。デフォルトではサブディレクトリも除外されます。
      さらにパスを除外するには、「+パスの追加」をクリックしてから、その他のパスの詳細を指定します。パスを削除するには、右側の「X」をクリックします。
    4. 各オペレーティング・システムの「含めるパス」セクションに、スキャンするファイル・システム・パスのリストを指定します。デフォルトではサブディレクトリも含められます。
      管理エージェントには、デフォルトで次のパスが含まれます:
      • Linux
        • /usr/java
        • /usr/lib/jvm
        • /usr/lib64/graalvm
        • /opt
      • Windows
        • c:\\Program Files\\Java

      さらにパスを含めるには、「+パスの追加」をクリックしてから、その他のパスの詳細を指定します。パスを削除するには、右側の「X」をクリックします。

      ノート

      • 含めるパスまたは除外パスは、Javaランタイム・インストールおよびアプリケーションに適用されます。
      • ファイル・スキャンでは、物理ディレクトリ内のJavaインストールが検索されます。Javaインストールのシンボリックリンク(シンボリック・リンクまたはソフト・リンク)は、ファイル・スキャンでは検出されません。
    ファイル・システム・パスを記述する構文の詳細は、含める/除外パス・パターンを参照してください。

    「親ディレクトリが含まれない」警告は、除外パスのリストに追加したパスが、現在含まれていないパスであることを示します。(追加のパスは、フリートの管理エージェントがJavaランタイムのインストールを検出するためにスキャンするホスト上のファイル・システム・パスの選択には影響しません。)

    含めるパスと除外パスに重複するワイルドカード・パターンが含まれる場合、「親ディレクトリが含まれない」という警告が無効になることがあります。(ワイルドカード・パターンの使用の詳細は、含める/除外パス・パターンを参照してください。)

    たとえば、次のワイルドカード・パターンでは警告が無効になります:
    • 含めるパス:/usr/**/java
    • 除外パス: /usr/**/lib32/java

    この問題の回避策は、ワイルドカード・パターンを明示的なパスに置き換えることです。

  4. 「変更の保存」をクリックします。
    ノート

    管理エージェントの設定への変更は、有効になるまでに時間がかかる場合があります。