AppDynamics Application Analytics のすべてのデプロイシナリオで、Analytics エージェント側のコンポーネントを有効にする必要があります。Analytics エージェントは、オペレーティング システムベースのバンドルまたはスタンドアロンのバンドルとして配布され、AppDynamics ダウンロードからダウンロードできます。ここでは、Application Analytics の各コンポーネントを設定して、ビジネス トランザクション データを収集するさまざまなシナリオについて説明します。 

エージェントを有効にするための準備

「Analytics エージェントを使用しない分析の展開」でデプロイオプションとエージェント側コンポーネントのアーキテクチャを確認して、インストールする必要があるコンポーネントを確認します。

Analytics エージェント

Analytics エージェントは、AppDynamics アプリケーション エージェント（アプリケーション サーバ エージェント）とログファイルからデータを収集し、そのデータをイベントサービスに送信します。Analytics エージェントは、デフォルトでは有効になっていません。Analytics エージェントを使用するには、このトピックの説明に従い、選択した方法を使用して、目的のバンドルをダウンロードして有効にする必要があります。Application Analytics を使用するには、次のことを行う必要があります。

  1. 個別の Application Analytics ライセンスを取得する。次を参照してください。Application Analytics のライセンス
  2. Analytics エージェントを有効にする。
  3. イベントサービスをポイントする。
    「Analytics エージェントのプロパティファイルの変更
    」を参照してください。「イベントサービスのデプロイ」を参照してください。
  4. コントローラで分析を有効にする。

AppDynamics アプリケーション エージェント

すべての環境で、アプリケーションからトランザクションデータを収集するには、サポートされているアプリケーション サーバ エージェントをデプロイする必要があります。すでに AppDynamics APM を使用している場合は、エージェントが環境にすでにインストールされている可能性があります。分析機能にアクセスするには、アプリケーション サーバ エージェントがバージョン 4.0 以降である必要があります。Analytics エージェントには、JRE 1.8 以降が必要です。 

アプリケーション サーバ エージェントのインストールについて詳しくは、次のトピックを参照してください。

Windows での Analytics エージェントのインストール

「Analytics エージェントを使用しない分析の展開」で説明したように、Analytics エージェントは、使用ケースに応じて、アプリケーション サーバ エージェントと同じホストまたは別のホストで実行できます。AppDynamics ダウンロードには、次の配布アーカイブが用意されています。

  • スタンドアロン Analytics エージェント（JRE なし）
  • 32 ビットと 64 ビットの両方の Windows マシン用の Analytics エージェント（JRE 1.8 付属）

ローカル アプリケーション サーバ エージェント用の Analytics エージェントの有効化

このセクションは、アプリケーション サーバ エージェントと同じホストに Analytics エージェントをインストールしていることを前提としています。このデプロイでは、Analytics エージェントはローカルマシンからログファイルのログデータを読み取り、送信します。アプリケーション サーバ エージェントは、監視対象アプリケーションから Analytics エージェントにデータを送信します。 

<analytics-agent-home>/bin ディレクトリにある .exe ファイルの analytics-agent.exe を使用して Analytics エージェントをインストールします。Analytics エージェントは Java で作成されているため、JVM で実行します。Windows マシンでは、Analytics エージェントは Windows サービスとして実行されます。

Analytics エージェントのインストール

  1. Analytics エージェントの配布アーカイブを各ターゲットホストのインストールディレクトリに解凍します。
    このアーカイブを解凍すると、次の 3 つのディレクトリが作成されます。
    • bin：Windows のバイナリファイル（.exe）が含まれています。
    • lib：クラスパスに存在する必要があるすべての jar ファイルが含まれています。
    • conf：プロパティファイルや vmoptions ファイルなど、すべての設定ファイルが含まれています。

  2. analytics-agent.properties ファイルを変更して Analytics エージェントを設定します。

    <analytics-agent-home>\conf\analytics-agent.properties

    設定手順について詳しくは、「Analytics エージェントのプロパティファイルの変更」を参照してください。

  3. このホストでログ情報を収集する場合は、次のことを行う必要があります。

  4. ファイルを保存して閉じます。

  5. 次のコマンドを実行して、Analytics エージェントをサービスとしてインストールします。

    bin\analytics-agent.exe service-install

    これで、他の Windows サービスと同様に analytics-agent を管理できます。 

  6. 「Analytics エージェントの起動と停止」の説明に従い、選択した方法を使用してサービスを開始します。

Analytics エージェントのプロパティファイルの変更

Analytics エージェントのプロパティファイルにより、Analytics エージェントが他のコンポーネントと通信する方法、監視対象アプリケーションから収集するデータのタイプ、および Application Analytics デプロイのコンポーネントとコントローラが相互に認証する方法が決まります。Analytics エージェントのプロパティファイルを使用して、デフォルト設定を変更し、エージェントプロパティに必要な値を設定します。実際のデプロイシナリオによっては、このファイルの場所は異なるので注意してください。 

  1. テキストエディタを使用して <analytics-agent-home>/conf/analytics-agent.properties ファイルを開きます。 

  2. デフォルトの URL を変更し、必要に応じて、http.event.endpoint 値を変更することでイベントサービスへの接続のポート番号を変更します。次に例を示します。

    http.event.endpoint=http://<events_service_host:events_service_port>

    SaaS ベースのインストールでは、ホストとポートの組み合わせは次のいずれかになります。

    • https://analytics.api.appdynamics.com:443（北米）

    • https://fra-ana-api.saas.appdynamics.com:443（欧州）

    • https://syd-ana-api.saas.appdynamics.com/:443 (APAC)

      ファイアウォールルールで IP アドレスが使用されている場合は、「ファイアウォールの考慮事項」を参照してください。

      オンプレミスインストールの場合、ユーザが設定したホストとポートを使用します。クラスタ環境では、多くの場合、これはロードバランサです。 

  3. ad.controller.url プロパティを変更して、コントローラをポイントするようにデフォルトの URL とポート番号を変更します。例：

    ad.controller.url=<controller_host_name>:<http-listener-port>

    これは、Appdynamics ブラウザベースのユーザインターフェイスにアクセスするために使用する URL とポート番号です。 

  4. [Global Account Name] と [Access Key] の値をメモします。これは、コントローラの [View License] UI に表示されます。

  5. エージェントがビジネス トランザクション データをパブリッシュするアカウントとアカウントキーを設定します。前に収集した Global Account Name 値と Access Key 値を使用します。次に例を示します。

    # The global_account_name in the Controller for this analytics data, similar to the following:
http.event.accountName=<customer1_74678b04-8a71-40ef-acaf-xxxxxxxxxxxx>
# Replace this value with the access key of the account name configured above.
http.event.accessKey=<3d58aba2-xxx-xxx>

    http.event.accountName プロパティは、アカウントの Global Account Name を指定します。http.event.accessKey プロパティは Access Key を指定します。これは、コントローラと Application Analytics デプロイのコンポーネント間の認証メカニズムを提供します。コントローラのインストールプロセスによって Access Key 値が生成されます。
    SAAS ベースのインストールの場合、http.event.name プロパティをアカウントの Name に設定します。デフォルト値は customer1 です。このプロパティが正しく設定されていない場合、Analytics エージェントは認証できません。発生したエラーは analytics-agent.log ファイルに保存されます。 

  6. Analytics エージェントを Windows サービスとして実行するために必要な次のプロパティを変更します。

    • ad.dw.log.path=<analytics-agent-home>\\logs

    • conf.dir=<analytics-agent-home>\\conf

    • ad.jvm.options.name=analytics-agent.vmoptions

    • ad.jvm.heap.min=512m

    • ad.jvm.heap.max=1g

      Windows の Analytics エージェントでは、パスに対して二重のバックスラッシュが必要です。次に例を示します。

      conf.dir=C:\\AppD\\analytics-agent\\conf
ad.dw.log.path=C:\\AppD\\analytics-agent\\logs

  7. このホストでログ情報を収集する場合は、次のことを行う必要があります。

Analytics エージェントの起動と停止

ネイティブの Windows サービスメニューを使用して、サービスを開始および停止できます。また、コマンドラインから次のコマンドを使用して、これらを直接行うこともできます。

  1. エージェントサービスを開始する。

    bin\analytics-agent.exe service-start

  2. エージェントサービスを停止する。

    bin\analytics-agent.exe service-stop

Analytics エージェントのアンインストール

コマンドラインで、次のように uninstall コマンドを使用して .exe ファイルを実行します。

bin\analytics-agent.exe service-uninstall

リモート Analytics エージェントのアプリケーション サーバ エージェントの有効化

アプリケーション サーバ エージェントのデフォルト設定では、通常、Analytics エージェントが同じホスト上にあり、デフォルトポートを使用していると想定されます。次の図に示すように、アプリケーション サーバ エージェントとは別のホストに Analytics エージェントが存在する場合、またはデフォルトポートを変更した場合は、アプリケーション サーバ エージェントの新しいホストとポートの値を指定する必要があります。 


Windows では、次のように appdynamics.analytics.agent.url という名前の環境変数を使用してリモート Analytics エージェントの場所を指定します。

  1. Windows マシンで、[System Properties > Advanced system settings > Environment Variables] に進みます。

  2. [System variables] で、[New] をクリックします。
    ユーザ環境変数も使用できますが、環境変数の設定元のユーザは、用意されているすべてのアプリケーションの実行元のユーザと同じ権限を持っている必要があります。この問題を回避するために、システム環境変数のアプローチを使用することを推奨します。
  3. appdynamics.analytics.agent.url システム変数の値を http://<analytics-agent-ip>:9090/v2/sinks/bt に設定します。
    <analytics-agent-ip> を、ご使用の環境の Analytics エージェントのホスト名に置き換えます。 
  4. 新しい環境変数を有効にする該当アプリケーションまたはプロセスを再起動します。
    Windows の w3wp の場合、環境変数に変更を加えた後、iisreset を実行して IIS を再起動します。
    マシンを再起動する必要はありませんが、モニタ対象プロセスを呼び出す親プロセスは再起動する必要があります。 

Linux での Analytics エージェントのインストール

.Deploy Analytics Without the Analytics Agent v21.1で説明したように、Analytics エージェントは、使用ケースに応じて、アプリケーション サーバ エージェントと同じホストまたは別のホストで実行できます。AppDynamics ダウンロードには、次の配布アーカイブが用意されています。

  • スタンドアロン Analytics エージェント（JRE なし）
  • マシンエージェントバンドル：64 ビット osx（zip）
  • マシンエージェントバンドル：32 ビットと 64 ビットの両方の Linux マシン用（rpm）
  • マシンエージェントバンドル：32 ビットと 64 ビットの両方の Linux マシン用（zip）
  • マシンエージェントバンドル：64 ビット solaris 用（zip）
  • マシンエージェントバンドル：64 ビット solaris-sparcv9 用（zip）
  • マシンエージェントバンドル：64 ビット solaris-x64 用（zip）

スタンドアロン マシン エージェントの拡張としての Analytics エージェントの有効化

マシンエージェントとアプリケーション サーバ エージェントが同じマシンで実行されている場合は、スタンドアロン Analytics エージェントをインストールする必要はありません。スタンドアロン マシン エージェントがすでに実行されている環境では、Analytics エージェントを拡張機能として有効にして実行します。ここでは、Analytics エージェントをスタンドアロン マシン エージェントの拡張として設定し、マシンエージェントモニタとして実行する方法について説明します。 

  1. スタンドアロン マシン エージェントを実行しているホストに JRE 8 以降がインストールされていることを確認します。
    必要なバージョンの JRE がホストで使用できない場合、Analytics エージェントを有効にすることはできません。

  2. スタンドアロン マシン エージェントを実行しているホストで、テキストエディタを使用して <machine-agent-home>/monitors/analytics-agent/monitor.xml を開きます。

  3. 次のように enabled タグを true に設定し、完了したらファイルを保存します。

    <monitor>
    <name>AppDynamics Analytics Agent</name>
    <type>managed</type>
    <!-- Enabling this requires JRE 8 or higher  -->
    <enabled>true</enabled>
...

  4. Analytics エージェントからイベントサービスへの接続を設定するために、次のファイルを開きます。

    <machine-agent-home>/monitors/analytics-agent/conf/analytics-agent.properties

  5. analytics-agent.properties ファイルで、次の手順を実行します。

    • デフォルトの URL を変更し、必要に応じて、http.event.endpoint 値を変更することでイベントサービスに接続するためのポート番号を変更します。次に例を示します。

      http.event.endpoint=http://<events_service_host:events_service_port>

      SaaS ベースのインストールでは、ホストとポートは次のとおりです。

      • https://analytics.api.appdynamics.com:443（北米）

      • https://fra-ana-api.saas.appdynamics.com:443（欧州）

      • https://syd-ana-api.saas.appdynamics.com:443 (APAC)

        ファイアウォールルールで IP アドレスが使用されている場合は、「ファイアウォールの考慮事項
        」を参照してください。

        オンプレミスインストールの場合、ユーザが設定したホストとポートを使用します。クラスタ環境では、多くの場合、これはロードバランサです。 

    • ad.controller.url プロパティを変更して、コントローラをポイントするようにデフォルトの URL とポート番号を変更します。例：

      ad.controller.url=http://<application_server_host_name>:<http-listener-port>

      これは、Appdynamics ブラウザベースのユーザインターフェイスにアクセスするために使用する URL とポート番号です。 

  6. コントローラの View License UI に表示される Global Account Name 値と Access Key 値をメモします。

  7. エージェントがビジネス トランザクション データをパブリッシュするアカウントとアカウントキーを設定します。前に収集した Global Account Name 値と Access Key 値を使用します。次に例を示します。

    # The global_account_name in the Controller for this analytics data, similar to the following:
http.event.accountName=<customer1_74678b04-8a71-40ef-acaf-xxxxxxxxxxxx>
# Replace this value with the access key of the account name configured above.
http.event.accessKey=<3d58aba2-xxx-xxx>

    http.event.accountName プロパティは、アカウントの Global Account Name を指定します。http.event.accessKey プロパティは Access Key を指定します。これは、コントローラと Application Analytics デプロイのコンポーネント間の認証メカニズムを提供します。コントローラのインストールプロセスによって Access Key 値が生成されます。
    SAAS ベースのインストールの場合、http.event.name プロパティをアカウントの Name に設定します。デフォルト値は customer1 です。このプロパティが正しく設定されていない場合、Analytics エージェントは認証できません。発生したエラーは analytics-agent.log ファイルに保存されます。 

  8. このホストでログ情報を収集する場合は、次のことを行う必要があります。

  9. ファイルを保存して閉じます。  

  10. この時点でマシンエージェントがすでに実行されている場合は、再起動して設定の変更を適用します。

プロキシサーバを介してイベントサービスに接続するには、「プロキシ経由でエージェントをイベントサービスに接続する」を参照してください。

スタンドアロン Analytics エージェントの有効化

このデプロイでは、Analytics エージェントとアプリケーション サーバ エージェントが同じマシン上で実行されます。Analytics エージェントは、ホストマシン上のログファイルからログデータを読み取り、送信します。アプリケーション サーバ エージェントは、監視対象アプリケーションから Analytics エージェントにデータを送信します。

マシンエージェントがインストールされていない環境の場合、Analytics エージェントを次の個別のバイナリとしてインストールします。analytics-agent.sh:

  1. Analytics エージェントの配布アーカイブを各ターゲットホストのインストールディレクトリに解凍します。
    このアーカイブを解凍すると、次の 3 つのディレクトリが作成されます。
    • bin：Linux、Solaris、および OSX 用のバイナリファイルが含まれています。
    • lib：クラスパスに存在する必要があるすべての jar ファイルが含まれています。
    • conf：プロパティファイルや vmoptions ファイルなど、すべての設定ファイルが含まれています。

  2. Analytics エージェントからイベントサービスへの接続を設定するために、次のファイルを開きます。

     

    <analytics-agent-home>/conf/analytics-agent.properties

  3. analytics-agent.properties ファイルで、次の手順を実行します。

    • デフォルトの URL を変更し、必要に応じて、http.event.endpoint 値を変更することでイベントサービスに接続するためのポート番号を変更します。次に例を示します。

      http.event.endpoint=http://<events_service_host:events_service_port>

      SaaS ベースのインストールでは、ホストとポートは次のとおりです。

      • https://analytics.api.appdynamics.com:443（北米）

      • https://fra-ana-api.saas.appdynamics.com:443（欧州）

      • https://syd-ana-api.saas.appdynamics.com:443 (APAC)

        ファイアウォールルールで IP アドレスが使用されている場合は、「ファイアウォールの考慮事項
        」を参照してください。

        オンプレミスインストールの場合、ユーザが設定したホストとポートを使用します。クラスタ環境では、多くの場合、これはロードバランサです。 

    • ad.controller.url プロパティを変更して、コントローラをポイントするようにデフォルトの URL とポート番号を変更します。例：

      ad.controller.url=http://<application_server_host_name>:<http-listener-port>

      これは、Appdynamics ブラウザベースのユーザインターフェイスにアクセスするために使用する URL とポート番号です。 

  4. コントローラの View License UI に表示される Global Account Name 値と Access Key 値をメモします。

  5. エージェントがビジネス トランザクション データをパブリッシュするアカウントとアカウントキーを設定します。前に収集した Global Account Name 値と Access Key 値を使用します。次に例を示します。

    # The global_account_name in the Controller for this analytics data, similar to the following:
http.event.accountName=<customer1_74678b04-8a71-40ef-acaf-xxxxxxxxxxxx>
# Replace this value with the access key of the account name configured above.
http.event.accessKey=<3d58aba2-xxx-xxx>

    http.event.accountName プロパティは、アカウントの Global Account Name を指定します。http.event.accessKey プロパティは Access Key を指定します。これは、コントローラと Application Analytics デプロイのコンポーネント間の認証メカニズムを提供します。コントローラのインストールプロセスによって Access Key 値が生成されます。
    SAAS ベースのインストールの場合、http.event.name プロパティをアカウントの Name に設定します。デフォルト値は customer1 です。このプロパティが正しく設定されていない場合、Analytics エージェントは認証できません。発生したエラーは analytics-agent.log ファイルに保存されます。 

  6. このホストでログ情報を収集する場合は、次のことを行う必要があります。

  7. ファイルを保存してテキストエディタを終了します。  

  8. 次のコマンドを実行して、Analytics エージェントをインストールします。

    bin\analytics-agent.sh start

リモート Analytics エージェントのアプリケーション サーバ エージェントの設定

アプリケーション サーバ エージェントのデフォルト設定では、通常、Analytics エージェントが同じホスト上にあり、デフォルトポートを使用していると想定されます。次の図に示すように、アプリケーション サーバ エージェントとは別のホストに Analytics エージェントが存在する場合、またはデフォルトポートを変更した場合は、アプリケーション サーバ エージェントの新しいホストとポートの値を指定する必要があります。 


-D パラメータを使用してリモート Analytics エージェントの場所を指定します。この引数は、次のようにモニタ対象アプリケーションに渡します。

-Dappdynamics.analytics.agent.url=http://<analytics-agent-ip>:9090/v2/sinks/bt

<analytics-agent-ip> を、ご使用の環境の Analytics エージェントのホスト名に置き換えます。  

読み取り専用ファイルシステムからの Analytics エージェントの実行

このデプロイでは、Analytics エージェントをインストールし、読み取り専用ファイルシステムから実行します。これを行うには、ログファイルを書き込み可能なパーティションに書き込むように Analytics エージェントに指示する必要があります。


書き込み可能なファイルシステムで Analytics エージェントのディレクトリを作成し、読み取り専用ファイルシステム内の Analytics エージェントのコンテンツへのシンボリックリンクを作成します。最終的に、Analytics エージェントの書き込み可能な最上位ディレクトリと、その最上位ディレクトリの下にある書き込み可能なログディレクトリを作成します。 

読み取り専用ディレクトリ内のアーティファクトを使用して、別の書き込み可能ディレクトリ内の Analytics エージェントを実行するには、次のようにします。

  1. 読み取り専用 Analytics エージェントディレクトリに対して必要な権限を指定します。

    # analytics-agent-readonly refers to the read-only analytics agent.
chmod -R 555 /tmp/analytics-agent-readonly/

  2. 書き込み可能なファイルシステムで Analytics エージェントのディレクトリを作成します。 

    mkdir /tmp/analytics-agent-writable
chmod 755 analytics-agent-writable/
cd /tmp/analytics-agent-writable

  3. 読み取り専用ファイルシステム内の Analytics エージェントのコンテンツへのシンボリックリンクを作成します。

    ln -s /tmp/analytics-agent-readonly/bin/ bin
ln -s /tmp/analytics-agent-readonly/lib/ lib
ln -s /tmp/analytics-agent-readonly/monitor.xml monitor.xml

  4. その最上位ディレクトリの下に、書き込み可能な conf ディレクトリを作成します。

    cd /tmp/analytics-agent-writable
mkdir conf
chmod 755 conf/
cd conf

  5. conf ディレクトリのコンテンツへのシンボリックリンクを作成します。 

    ln -s /tmp/analytics-agent-readonly/conf/analytics-agent.* .
ln -s /tmp/analytics-agent-readonly/conf/job/ job
ln -s /tmp/analytics-agent-readonly/conf/grok/ grok

cd /tmp/analytics-agent-writable
  6. analytics-agent-writable ディレクトリの下に logs ディレクトリを作成します。

  7. 書き込み可能なディレクトリから Analytics エージェントを実行します。

    cd /tmp/analytics-agent-writable
nohup bin/analytics-agent.sh start &

結果のディレクトリは次のようになります。

/tmp/
dr-xr-xr-x  6 ec2-user ec2-user 4096 Jul 17 20:45 analytics-agent-readonly
drwxr-xr-x  4 ec2-user ec2-user 4096 Jul 26 20:17 analytics-agent-writable

 /tmp/analytics-agent-writable/
total 24
drwxr-xr-x . . . 4096 Jul 27 19:41 .
drwxrwxr-x  . . .  4096 Jul 27 19:37 ..
lrwxrwxrwx 1 . . .   50 Jul 27 19:38 bin -&gt; /tmp/analytics-agent-readonly/bin/
drwxr-xr-x . . .  4096 Jul 27 19:41 conf
lrwxrwxrwx . . .  50 Jul 27 19:38 lib -&gt; /tmp/analytics-agent-readonly/lib/
drwxrwxr-x . . . 4096 Jul 27 19:41 logs
lrwxrwxrwx . . .   57 Jul 27 19:38 monitor.xml -&gt; /tmp/analytics-agent-readonly/monitor.xml


conf/
total 20
drwxr-xr-x . . . 4096 Jul 27 19:41 .
drwxr-xr-x . . . 4096 Jul 27 19:41 ..
lrwxrwxrwx . . .   77 Jul 27 19:39 analytics-agent.properties -&gt; /tmp/analytics-agent-readonly/conf/analytics-agent.properties
lrwxrwxrwx . . .   76 Jul 27 19:39 analytics-agent.vmoptions -&gt; /tmp/analytics-agent-readonly/conf/analytics-agent.vmoptions
lrwxrwxrwx . . .  56 Jul 27 19:40 grok -&gt; /tmp/analytics-agent-readonly/conf/grok/
lrwxrwxrwx . . .  55 Jul 27 19:39 job -&gt; /tmp/analytics-agent-readonly/conf/job/
drwxrwxr-x . . . 4096 Jul 27 21:32 watermark

Analytics エージェントの調整

ここでは、Analytics エージェントのインストール後の設定について説明します。プロキシサーバを使用してイベントサービスに接続するよう Analytics エージェントを設定する方法、統合ログ管理（CLM）を使用してログファイルを収集する方法、リソース使用量の制限を設定する方法、および Java 仮想マシン（JVM）のオプションを変更する方法について説明します。

プロキシ経由でのイベントサービスへの接続

Analytics エージェントがプロキシサーバを介してイベントサービスに接続する必要がある場合は、次の手順を実行します。

  1. テキストエディタで <analytics-agent-home>\conf\analytics-agent.properties を開きます。

  2. 次の情報を追加します。

    # optional proxy properties
http.event.proxyHost=<your proxy host>
http.event.proxyPort=<your proxy port>
http.event.proxyUsername=<your proxy username, if authentication is required>
http.event.proxyPassword=<your proxy password, if authentication is required>

  3. ファイルを保存して閉じます。

統合ログ管理用の Analytics エージェントの設定

Analytics エージェントが CLM と連携するようにするには、Analytics エージェントのプロパティファイルでいくつかのプロパティを設定する必要があります。analytics-agent.properties ファイルで、コントローラの URL、顧客名、および Analytics エージェントの名前を指定します。顧客名は、コントローラの [View License] UI で確認できます。CLM を使用してソースルールによりログファイルを設定する場合は、これらのプロパティに正しい値を指定する必要があります。

デフォルト値は次のとおりです。

# Format should be http://<host>:<port>
ad.controller.url=http://localhost:8090

# The customer name field from the appdynamics license page.
http.event.name=customer1

# This is the friendly agent name that will show up in the controller when the agent registers and syncs configuration.
ad.agent.name=analytics-agent1

Java 仮想マシンオプションの変更（スタンドアロン Analytics エージェントのみ）

Analytics エージェントをマシンエージェントにバンドルする場合は、JVM オプションを変更する必要はありません。


JVM の起動オプションを変更する必要がある場合は、テキストエディタを使用して <analytics-agent-home>/conf/analytics-agent.vmoptions を変更します。vmoptions ファイルの名前は ad.jvm.options.name=analytics-agent.vmoptions  プロパティファイルから読み取られていることに注意してください。したがって、vmoptions ファイルの名前を変更する場合は、ad.jvm.options.name プロパティも変更する必要があります。 

（Windows のみ）Analytics エージェント Windows サービスがインストールされていて、プロパティファイルまたは vmoptions ファイルを変更する必要がある場合は、変更を有効にするためにサービスをアンインストールして再インストールする必要があります。

リソース使用の制限の設定

リソースの使用を制限するために、単一の Analytics エージェントのジョブ数に対してデフォルトの制限を有効にすることができます。この制限は上書きできますが、CPU 使用率、ディスク、ネットワーク I/O などのリソースの使用に対する潜在的な影響を十分に理解していない場合はお勧めしません。このプロパティは ad.max.runnable.sources で、<analytics-agent-home>/conf/analytics-agent.properties ファイルにあります。デフォルトでは、ad.max.runnable.sources は 20 に設定されています。  

Analytics エージェントのステータスの確認

Analytics エージェントが起動したことを確認するには、アプリケーション エージェントのログファイルで次のエントリを検索します。"Started [Analytics] collector"

プロキシサーバを介してイベントサービスに接続する必要がある場合は、「プロキシ経由でエージェントをイベントサービスに接続する」を参照してください。


トラブルシューティングのヒント

  • analytics-agent.properties でプロパティが正しく設定されていることを確認します。「有効なジョブファイルの制限」を参照してください。
  • JRE バージョンが 1.7 以上であること、および環境で JAVA_HOME 変数が設定されていることを確認します。
  • analytics-agent/conf/analytics-agent.vmoptions のすべてのプロパティは JRE と互換性があります。