Deployment Support

分析エージェントはトランザクション分析データをキャプチャする必要はありません。このページでは、「エージェントレス」の分析の設定を使用するための要件について説明します。

このコンテキストで「エージェントレス」とは、Analytics エージェントを使用しないトランザクション分析の設定を指します。この機能を使用するには、Java や .NET などのアプリケーション サーバ エージェントが引き続き必要です。

エージェントレス分析

Java アプリケーションまたは .NET Windows アプリケーションのトランザクション分析をキャプチャする場合は、専用の Analytics エージェントを使用せずにトランザクション分析を設定できます。

このデプロイモデルでは、Analytics によってアプリケーション エージェントからデータが直接取得されます。データがイベントサービスに報告され、その後コントローラに報告されます。したがって、個別の Analytics エージェントは必要ありません。

Java エージェントをバージョン 4.5.15 以降にアップグレードし、トランザクション分析を使用している場合、エージェントレス分析が自動的に有効になります。.NET エージェントをバージョン 20.10 以降にアップグレードし、トランザクション分析を使用している場合、エージェントレス分析が自動的に無効になります。この機能は、コントローラから、またはノードプロパティを使用して有効にできます。「エージェントレス分析の有効化」を参照してください。

次の 2 つの既知の問題に関連して異常な動作(分析データのずれなど)が発生する場合があります。

  • 高い CPU 使用率(Java エージェントバージョン 4.5.19 以前の場合)
  • ブロックされたファイアウォール要求

Troubleshoot Analytics Issues」を参照してください。

要件

次の最小要件を満たしていることを確認してください。

エージェントレス分析を使用するには、エージェントの導入要件に対応する次の互換性マトリックスを参照してください。

コントローラの最小バージョンJava エージェントの最小バージョンエージェントレス分析のサポート
4.5.164.5.15一般的に入手可能。
4.5.164.5.17暗号化されたログイン情報を使用するプロキシ構成およびプロキシ認証のサポート。
4.5.174.5.18Java エージェントで設定されたライセンスルールのサポート。
コントローラの最小バージョン.NET エージェントの最小バージョンエージェントレス分析のサポート
4.5.1620.10.0プロキシ構成の正式リリースおよびサポート。
4.5.1720.10.0.NET エージェントで設定されたライセンスルールのサポート。

イベントサービスへのアプリケーション エージェントの接続

ほとんどの展開では、適切なバージョンのエージェントがある限り、Java エージェントとイベントサービスの間の通信は自動的に行われます。
.NET エージェントとイベントサービスの間の通信はデフォルトで無効になっています。再度有効にするには、「エージェントレス分析の有効化」を参照してください。

次のセクションを参照して、展開がイベントサービスに接続できることを確認してください。

内部イベント サービス エンドポイントの識別

コントローラでは、Admin.jsp で設定されたイベントサービスへの接続 URL を使用します。また、エージェントレス分析もこの URL を使用します。詳細については、イベントサービスへの接続を参照してください。

SaaS 環境では、コントローラ/アプリケーション エージェントに接続するためのイベントサービスへの内部 URL がすでに展開されています。

オンプレミス環境では、エージェントは、コントローラにより通常使用される内部イベントサービス URL にアクセスする必要があります。内部イベントサービス URL をエージェントに公開してから、analytics.agentless.event.service.url として設定する必要があります。

  1. 管理コンソールにログインします(
    http:<controller-hostname>:8080/controller/admin.jsp  または  https:<controller-hostname>:45/controller/admin.jsp)。
  2. [Controller Settings] で、エージェントからアクセス可能なイベント サービス エンドポイントに analytics.agentless.event.service.url を設定します。
  3. [Save] をクリックします。

接続ポート

Java エージェント、.NET エージェント、およびイベントサービス間の接続は、ポート 80(HTTP)および 443(HTTPS)を介して行われます。ファイアウォールルールが正しく設定されていない場合、分析データにずれが出ます。
イベントサービスが Java エージェントおよび .NET エージェントからデータを受信するポートは、インストール時に設定されます。

ファイアウォールなど、この接続を妨げる可能性のあるネットワークポリシーがある場合は、イベントサービスと接続できるようにポリシーを設定する必要があります。「Troubleshoot Analytics Issues」を参照してください。 

SSL の有効化

カスタム信頼ストアを使用する場合は、「Enable SSL for the Java Agent」または「Enable SSL for the .NET Agent」を参照してください。

プロキシ設定

プロキシ認証のログイン情報を暗号化する場合は、Java エージェント 4.5.17 以降とコントローラ 4.5.17 以降が必要です。「Java Agent Configuration Properties」を参照してください。

.NET エージェントはプロキシ認証をサポートしていません。プロキシ設定には、次の環境変数を使用します。

プロキシを使用してイベントサービスと通信するように .NET エージェントを設定するには、次の手順を実行します。

  1. 次の環境変数を追加/更新します。
  2. Windows アプリケーションを再起動します。 
エージェント → プロキシ用のデータを送信するイベントサービス

appdynamics.http.proxyHost

appdynamics.http.proxyPort

エージェントレス分析の有効化

コントローラ、ノード/階層、およびエージェントレベルで、エージェントレス トランザクション分析を有効にできます。 

デフォルトでは、Java エージェントのエージェントレス分析が有効になっています。

デフォルトでは、.NET エージェントのエージェントレス分析は無効になっています。エージェントレス分析を有効にすると、展開がエージェントレス分析モードに変更されます。

階層またはノードレベルでエージェントレス分析を有効にするには、agentless-analytics-disabled プロパティを追加し、false に設定します。false に設定すると、このノードプロパティによって階層またはノードがエージェントレス分析モードに変更されます。ノードプロパティを追加するには、「アプリケーションエージェントのノードプロパティ」を参照してください。 

エージェントレス分析の無効化

コントローラ、ノード/階層、およびエージェントレベルで、エージェントレス トランザクション分析を無効にできます。 

エージェントレス分析を無効にすると、展開が分析エージェントモードに変更されます。

階層またはノードレベルでエージェントレス分析を無効にするには、agentless-analytics-disabled プロパティを追加し、true に設定します。true に設定すると、このノードプロパティによって階層またはノードが Analytics エージェントモードに戻ります。ノードプロパティを追加するには、「アプリケーションエージェントのノードプロパティ」を参照してください。 

デフォルトでは、.NET エージェントのエージェントレス分析は無効になっています。エージェントレス分析を有効にすると、展開がエージェントレス分析モードに変更されます。

エージェントレス分析を無効にするには、agentless-analytics-disabled の値を true に設定します。

イベントサービス URL のオーバーライド

Java エージェントでイベントサービス URL をオーバーライドするには、appdynamics.analytics.agent.agentless.es.url プロパティを使用します。このプロパティが設定されている場合、Java エージェントは、コントローラから受信したイベントサービス URL を無視し、プロパティの URL を使用してイベントをパブリッシュします。

このプロパティは、Java エージェントバージョン 22.3.0 以降でサポートされています。

.NET エージェントでイベントサービス URL をオーバーライドするには、appdynamics.analytics.agent.agentless.es.url を使用します。この環境変数が設定されている場合、.NET エージェントは、コントローラから受信したイベントサービス URL を無視し、環境変数の URL を使用してイベントをパブリッシュします。

この環境変数は、.NET エージェントバージョン 22.5.0 以降でサポートされています。

既存の Analytics エージェント

コントローラとエージェントを最小バージョンへアップグレードすると、既存の Analytics エージェントはデータの報告を停止します。エージェントレス分析では、Analytics エージェントからのデータは重複しません。コントローラに [Transaction Analytics] が表示された場合、ログ分析を使用していない限り、AppDynamics では分析エージェントをアンインストールすることを推奨します。