(オプション) EPAgent 監視のインストールおよび設定

EPAgent 監視は、CA APM で CA Analysis サーバを監視するためのツールです。CA Analysis Server が Windows で実行されている場合は、これらの手順を使用します。
apmdevops97jp
注:
2015 年 12 月以降に APM をダウンロードした場合、ABA は使用できません。このドキュメントは、以前のダウンロードに含まれています。
EPAgent 監視は、CA APM で CA Analysis サーバを監視するためのツールです。CA Analysis Server が Windows で実行されている場合は、これらの手順を使用します。
注:
詳細については、「
EP エージェント実装ガイド
」を参照してください。
EPAgent 監視要件
 
要件
サポートされている環境
CA Analysis Server
Microsoft Windows 2008 R2
RedHat CentOS 5.8
EPAgent
Microsoft Windows 2008 R2
Java 1.6 以降
JRE (CA Analysis Server にバンドルされています)
Perl (推奨)またはその他のスクリプト言語
注:
Perl モジュール Win32::PerfLib がネイティブの Perl ディストリビューションに含まれていない場合は、インストールしてください。
EPAgent のインストール
CA APM Introscope の一部である EPAgent をインストールします。
以下の手順に従います
  1. EPAgent
    .tar/.
    zi
    p
    をダウンロードして、ディレクトリに解凍します。
  2. サポートされているバージョンの Perl をインストールし、%PATH% 環境変数に追加します。
    注:
    Perl の他にも言語を使用する場合は、その言語のスクリプト インタープリタが監視対象のシステムにインストールされていることを確認します。また、EPAgent がインストールされている場所からそのスクリプト インタープリタを呼び出せることを確認します。
EPAgent の設定
CA Analysis Server を監視してメトリックを WebView に表示するために、EPAgent を設定します。EPAgent にはメトリックのデフォルト プラグインが付属しています。カスタム プラグインを作成することもできます。EPAgent は実行可能スクリプトを使用してメトリックをバンドルし、それらのメトリックを Enterprise Manager のエージェント リスニング ポートに送信します。
以下の手順に従います。
  1. IntroscopeEPAgent.properties を開き、以下の行でエンタープライズ管理サーバを指定します。
    introscope.agent.enterprisemanager.transport.tcp.host.default=<hostname or IP address of EM server or collector>
  2. デフォルトまたはカスタムのプラグインを使用して EPAgent を設定します。
    例: プラグイン
    introscope.epagent.plugins.stateless.names=DISK,POSTGRES,MATCHEDPROCS,HTTP introscope.epagent.stateless.DISK.command=perl ./epaplugins/windows/diskStats.pl introscope.epagent.stateless.DISK.delayInSeconds=900 introscope.epagent.stateless.POSTGRES.command=perl ./epaplugins/windows/processAvailability.pl -match postgres introscope.epagent.stateless.POSTGRES.delayInSeconds=900 introscope.epagent.stateless.MATCHEDPROCS.command=perl ./epaplugins/windows/processAvailability.pl -match ^prelert_ -distinctmatch introscope.epagent.stateless.MATCHEDPROCS.delayInSeconds=900 introscope.epagent.stateless.MATCHEDPROCS.metricNotReportedAction=stop introscope.epagent.stateless.HTTP.command=perl ./epaplugins/windows/httpSvcAvailability.pl -url http://localhost:8080/prelertApi/prelert.svc introscope.epagent.stateless.HTTP.delayInSeconds=900
    例: ログ記録
    log4j.logger.epagent=INFO, logfile log4j.appender.logfile.File=<Relative or absolute path to desired logfile>
  3. IntroscopeEPAgent.properties の変更を保存します。
EPAgent の開始
EPAgent の開始は手動のプロセスです。EPAgent は、Windows でサービスとして直接実行することはできません。Java サービス ラッパーまたは同様の方法を使用します。
以下の手順に従います。
  1. コマンド シェルで、EPAgentを開始します。
    cd <EPAgent root directory> java -jar .\lib\epagent.jar -Dcom.wily.introscope.epagent.properties=".\IntroscopeEPAgent.properties"
    注:
    必要な Perl がパスの先頭にあることを確認してください。
  2. 出力およびログ ファイルにエラーが表示されていないことを確認します。
    EPAgent のログで、エージェントが Perl および正しいプラグイン ファイルのパスを検出したことを確認します。
  3. Webview で、superdomain |<
    分析サーバのホスト名または IP
    > |EPAgentProcess|EPAgent (* SuperDomain *) に移動して、メトリックが表示されることを確認します。
    注: EPAgent サブフォルダには設定情報のみが含まれています。メトリックは、Disk、Remote Machines、および Running Processes サブフォルダにあります。