インフラストラクチャ エージェントのインストール

インストール前に、 をダウンロードします。 このダウンロードには、インフラストラクチャ エージェントと、インフラストラクチャ コンポーネントに関するデータを提供するために展開できる拡張機能が含まれています。
apmdevops106
インストール前に、インフラストラクチャ エージェントをダウンロードします。 このダウンロードには、インフラストラクチャ エージェントと、インフラストラクチャ コンポーネントに関するデータを提供するために展開できる拡張機能が含まれています。
インフラストラクチャのインストールには、Java Runtime Environment (JRE)のローカル インストールが含まれており、これが使用されます。
以下の高レベル手順に従います。
2
2
インフラストラクチャ エージェント ソフトウェアのダウンロード
インフラストラクチャ エージェント ソフトウェアは、CA サポートで入手可能です。
以下の手順に従います。
  1. CA Support Download Center に移動します。
  2. お使いのオペレーティング システムに適したインフラストラクチャ エージェントのダウンロード ファイルを見つけてダウンロードします。
    • UNIX:
      Infrastructure-Agent-<version>-unix.tar.gz
    • Windows:
      Infrastructure-Agent-<version>-windows.zip
    • Mac:
      Infrastructure-Agent-<version>-mac.tar.gz
インフラストラクチャ エージェントは、「Compatibility Guide」に記載されている特定の Windows および Linux 製品に対してのみサポートされます。
エージェントおよび拡張機能は、UNIX、Windows、および Mac のオペレーティング システムで使用できます。
拡張機能名
ディレクトリ名
UNIX
Windows
Mac
Docker 監視
DockerMonitor
×
×
Environment Performance Agent プラグイン
適用不可
F5 LTM モニタリング
f5ltmExtension
×
ホスト モニタリング
HostMonitor
×
Node.js エージェント
NodeExtension
PHP エージェント
PhpExtension
×
×
Web サーバの監視
Webserver-monitor
×
インフラストラクチャ エージェントのインストールおよび開始
  1. Infrastructure-Agent-<version>-<OS> パッケージ ファイルのコンテンツをインストール先の場所に抽出します。 オペレーティング システム コマンドを使用して、ファイルを抽出します。
    • UNIX
      : tar xf Infrastructure-Agent-<version>-unix.tar.gz
    • Windows
      : Unzip Infrastructure-Agent-<version>-windows.zip
    • Mac
      : tar xf Infrastructure-Agent-<version>-mac.tar.gz
  2. インフラストラクチャ エージェントをインストールおよび開始します。
    • UNIX
      : ./apmia-ca-installer.sh install
    • Windows
      : apmia-ca-installer.bat install
    • Mac
      : ./apmia-ca-installer.sh install
    Enterprise Manager は、インフラストラクチャ エージェントの接続に関する詳細をログにレポートします。
    UNIX システムでは、root、スーパー ユーザ、または通常のユーザとしてインフラストラクチャ エージェントをインストールできます。 インストール スクリプトによって、スクリプトを実行するユーザの crontab にエントリが生成されます。 スクリプトを実行する前に、ユーザに適切な crontab 権限があることを確認します。 crontab 権限を設定する方法については、オペレーティング システムのマニュアルを参照してください。
  3. (オプション)その他のインフラストラクチャ エージェント関連のコマンドを使用します。
    • インフラストラクチャ エージェントのステータスの確認
      • UNIX
        : ./apmia-ca-installer.sh status
      • Windows
        : apmia-ca-installer.bat status
      • Mac
        : ./apmia-ca-installer.sh status
    • インフラストラクチャ エージェントの停止
      • UNIX
        : ./apmia-ca-installer.sh stop
      • Windows
        : apmia-ca-installer.bat stop
      • Mac
        : ./apmia-ca-installer.sh stop
    • インフラストラクチャ エージェントの開始
      • UNIX
        : ./apmia-ca-installer.sh start
      • Windows
        : apmia-ca-installer.bat start
      • Mac
        : ./apmia-ca-installer.sh start
    • インフラストラクチャ エージェントを再起動します。
      • UNIX
        : ./apmia-ca-installer.sh restart
      • Windows
        : apmia-ca-installer.bat restart
      • Mac
        : ./apmia-ca-installer.sh restart
    • インフラストラクチャ エージェントと SystemEdge のアンインストール
      • UNIX
        : ./apmia-ca-installer.sh uninstall
      • Windows
        : apmia-ca-installer.bat uninstall
      • Mac
        : ./apmia-ca-installer.sh uninstall
    • インフラストラクチャ エージェントのクリーン アンインストールの実行
      このコマンドは、インフラストラクチャ エージェントと SystemEDGE をアンインストールし、ディレクトリ名が
      apmia
      の場合はインフラストラクチャ エージェントのディレクトリを削除します。
      • UNIX
        : ./apmia-ca-installer.sh clean_uninstall
      • Windows
        : apmia-ca-installer.bat clean_uninstall
      • Mac
        : ./apmia-ca-installer.sh clean_uninstall
    • インフラストラクチャ エージェントを強制的に開始
      force_start
      コマンドは、エージェントをインストールせずに、非サービス ベースの方法でインフラストラクチャ エージェントを実行します。Windows では、
      force_start
      コマンドを使用すると、インフラストラクチャ エージェントでホスト モニタリングが開始されません。UNIX では、
      force_start
      でホスト モニタリングが開始されます。
      • UNIX
        : ./apmia-ca-installer.sh force_start
      • Windows
        : apmia-ca-installer.bat force_start
      • Mac
        : ./apmia-ca-installer.sh force_start
    • インフラストラクチャ エージェントを強制的に停止
      Windows では、
      force_stop
      コマンドで、
      force_start
      によって開始されたインフラストラクチャ エージェント インスタンスを停止します。
      UNIX および Mac では、
      stop
      コマンドを使用して、
      force_start
      によって開始されたインフラストラクチャ エージェント インスタンスを停止します。
      • UNIX
        : ./apmia-ca-installer.sh stop
      • Windows
        : apmia-ca-installer.bat force_stop
      • Mac
        : ./apmia-ca-installer.sh stop
    • インストーラ スクリプトの使用法に関する情報の取得
      このコマンドは、インフラストラクチャ エージェントのインストーラ スクリプトの使用法を表示します。
      • UNIX
        : ./apmia-ca-installer.sh -help
      • Windows
        : ./apmia-ca-installer.bat help
      • Mac
        : ./apmia-ca-installer.sh -help
  4. (オンプレミスの CA Application Performance Management)インフラストラクチャ エージェントが提供するエージェントまたは拡張機能を展開するには、Extensions.profile ファイルを設定します。
    デフォルトでは、これらのエージェントと拡張機能は無効です。 インフラストラクチャ エージェントを開始する前に、Extensions.profile ファイルの
    introscope.agent.extensions.bundles.load
    プロパティを設定して、それらを有効にします。
    1. extensions
      ディレクトリに移動します。
    2. テキスト エディタを使用して Extensions.profile ファイルを開きます。
    3. introscope.agent.extensions.bundles.load
      プロパティに拡張機能名を追加します。
      apmia/extensions
      ディレクトリ内の拡張機能ディレクトリの名前を使用します。 例:
      introscope.agent.extensions.bundles.load=HostMonitor
      複数の拡張機能エントリを指定する場合は、カンマで区切ります。 例:
      introscope.agent.extensions.bundles.load=HostMonitor, Webserver-monitor, ContainerFlow, DockerMonitor, f5ltmExtension, NodeExtension, PhpExtension
    4. ファイルを保存します。
    5. インフラストラクチャ エージェントを再起動します。
インフラストラクチャ エージェントのインストールに関するトラブルシューティング
問題の状況:
破損している既存のインフラストラクチャ エージェントのインストールが存在するため、インフラストラクチャ エージェントのインストールに失敗します。
(UNIX のみ)
解決策:
  1. APMIA のサービスを検索し、以下のコマンドを使用してサービスを強制終了します。
    ps -elf | grep UnifiedMonitoringAgent.jar
  2. 以下のコマンドを実行します。
    crontab -e
  3. APM IA のエントリを削除します。
  4. インフラストラクチャ エージェントを再インストールします。
インストール ログの確認
以下の手順に従います。
  1. Navigate to
    apmia/APMIA_install.log
    に移動します。
  2. ログでエラー メッセージを確認します。
インフラストラクチャ エージェントのディレクトリ構造
インフラストラクチャ エージェントは、インストール、アンインストール、アップグレード、およびロールバック用に固有のディレクトリを使用します。 インフラストラクチャ エージェントをインストールすると、CA APM は extensions、backup、および deploy サブディレクトリを作成します。
インフラストラクチャ エージェントを抽出すると、CA APM は以下のディレクトリを作成します。
<
apmia
>
  • bin
  • CASystemEdge
    - CA APM Hosting Monitoring のコンポーネントである CASystemEdge が含まれています。
  • core/config
    - Infrastructure.Agent.profile ファイルが含まれています。
  • extensions
    – エージェント拡張機能を管理するためのサブディレクトリとファイルが格納されます。
    • backup
      - エージェント拡張機能をアンインストール、アップグレード、およびロールバックするために以前のバージョンの .tar.gz ファイルが格納されます。
    • deploy
      -
      deploy
      ディレクトリに配置されるすべての拡張機能用の展開および tar.gz ファイルが格納されます。
    • Extensions.profile
      - 展開した拡張機能のリストが含まれています。
拡張機能をインストールすると、CA APM は extension ディレクトリおよびサブディレクトリを作成します。
  • <
    apmia
    >
    • bin
    • CASystemEdge
    • core/config
    • 拡張機能
      • バックアップ
      • deploy
      • <
        extension_directory
        >
        - bundle.properties、および
        README.md
        ファイルが含まれます。
        • config
          - 拡張機能固有のプロパティ ファイルを含めることができます。 たとえば、
          F5Monitor.properties
          などです。
        • lib -
          <extension_name>.jar
          ファイルが格納されます。
        • metadata
          - エージェント拡張機能のインポート後に APM Command Center が使用する
          bundle.json
          description.md
          、および
          installinstructions.md
          ファイルが格納されます。
          description.md
          および
          installinstructions.md
          ファイルをテキスト エディタで開き、拡張機能に関する情報を確認できます。
        • bundle.properties
          - 拡張機能固有のエージェント プロパティ ファイルが含まれています。
      • Extensions.profile
インフラストラクチャ エージェントの設定
インフラストラクチャ エージェントの IntroscopeAgent.profile を使用して、インフラストラクチャ エージェントを設定します。 インフラストラクチャ エージェントのプロファイルには、EPAgent プラグイン プロパティも含まれています。
以下の手順に従います。
  1. <apmia>/Infrastructure_Agent-<version>/core/config
    ディレクトリに移動します。
  2. IntroscopeAgent.profile
    ファイルをテキスト エディタで開きます。
  3. agentManager.url.1=<URL> を設定します。
  4. ファイルを保存して閉じます。
インフラストラクチャ エージェントのヒープ サイズの設定
インフラストラクチャ エージェントを実行する JVM の
xms
および
xmx
パラメータは、コマンド ライン パラメータまたは環境変数を使用して設定できます。
コマンド ライン パラメータを使用したヒープ サイズの設定
min_heap および max_heap パラメータを含む APMIA インストール スクリプトを実行します。
  • UNIX
    : ./apmia-ca-installer.sh install min_heap=<value> max_heap=<value>
  • Windows
    : apmia-ca-installer.bat install min_heap <value> max_heap <value>
  • Mac
    : ./apmia-ca-installer.sh install min_heap=<value> max_heap=<value>
デフォルトでは、min_heap は 256、max_heap は 512 です。 このインストーラ スクリプトを使用して、起動時および再起動時に java ヒープの値を更新できます。
環境変数を使用したヒープ サイズの設定
以下の環境変数を使用してヒープ サイズの値を設定することもできます。 一度設定すると、これらの値はインストール スクリプトの実行時にスクリプトによって取得されます。
  • MIN_HEAP_VAL_IN_MB
  • MAX_HEAP_VAL_IN_MB
たとえば、Linux では以下のようになります。
$ export MIN_HEAP_VAL_IN_MB=256
$ export MAX_HEAP_VAL_IN_MB=512
コマンド ラインで指定されたヒープ サイズの値は、環境変数よりも優先されます。
(Linux)ストレージ フィルタの設定
UNIX または Linux システムでは、ストレージ フィルタを有効化して、
StorageName
メトリックに対して考慮および表示されるマウント ポイントを設定できます。 環境変数またはホスト モニタのバンドル プロパティのいずれかを使用して、ストレージ フィルタを設定します。
環境変数を使用したストレージ フィルタの設定
ストレージ フィルタを設定するには、以下の環境変数を使用できます。
  • storage_mount_filter
    StorageName
    メトリックの考慮対象から削除するマウント ポイントを指定するための変数。 1 行に 1 つのマウント ポイント、または 1 行に複数のマウント ポイントをカンマで区切って指定することができます。 例:
    $ export storage_mount_filter=/dev $ export storage_mount_filter=/run
    または
    $ export storage_mount_filter=/dev,/run
  • storage_outofbox_filter_enabled
    有効にされている場合、以下のマウントを除外する標準装備のフィルタ。
    • devicemapper/mnt
    • docker/containers
    • docker/devicemapper
    • docker/
    • kubelet/pods
    • openshift.local.volumes
    このフィルタはデフォルトで有効です。 無効にするには、その値を「no」に設定します。
    $ export storage_outofbox_filter_enabled=no
ホスト モニタリングのバンドル プロパティを使用したストレージ フィルタの設定
ホスト モニタリングのバンドル プロパティを使用してストレージ フィルタを設定することもできます。 以下の手順に従います。
  1. apmia/extensions/HostMonitor/bundle.properties
    ファイルをテキスト エディタで開きます。
  2. 以下のプロパティを追加します。
    • storage.mount.filter
    • storage.outofbox.filter.enabled
    これらのプロパティは、前のセクションで説明した環境変数と同じように機能します。
  3. プロパティの値を設定して、StorageName メトリックから削除するマウント ポイントを設定します。 これらのポイントは、
    メトリック ビュー
    には表示されません。 例:
    storage.mount.filter=/dev storage.outofbox.filter.enabled=no
    環境変数とバンドル プロパティの両方が設定されている場合、環境変数がバンドル プロパティよりも優先されます。
    : ホスト モニタリングが Docker、OpenShift、または Kubernetes 環境に展開されている場合は、対応する .yml インストール ファイルに環境変数を渡します。 詳細については、以下を参照してください。
  4. ホスト モニタの
    boundle.properties
    を更新した後、インフラストラクチャ エージェントを再起動する必要があります。
拡張機能の設定およびトラブルシューティング
<apmia>/extensions/<extension_name>
ディレクトリにあるそれぞれの bundle.properties ファイルを使用して、個々の拡張機能のプロパティを設定します。
特定の設定およびトラブルシューティングの手順については、個々のエージェントと拡張機能を参照してください。
詳細: