Analytics エージェントを使用しない分析の展開

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

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

エージェントレス分析

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

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

警告: Java エージェントをバージョン 4.5.15 以降にアップグレードし、トランザクション分析を使用している場合、エージェントレス分析が自動的に有効になります。.NET エージェントをバージョン 20.10 以降にアップグレードし、トランザクション分析を使用している場合、エージェントレス分析が自動的に無効になります。この機能は、コントローラから、またはノードプロパティを使用して有効にできます。「エージェントレス分析の有効化」を参照してください。次の 2 つの既知の問題に関連して異常な動作（分析データのずれなど）が発生する場合があります。高い CPU 使用率（Java エージェントバージョン 4.5.19 以前の場合）、ブロックされたファイアウォール要求。「分析の問題のトラブルシューティング」を参照してください。

要件

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

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

コントローラの最小バージョン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 エージェントで設定されたライセンスルールのサポート。

Connect App Agents to the Events Service

Java
For most deployments, communication between the Java Agent and the Events Service automatically occurs as long as you have the correct agent version.
.NET
Communication between the .NET Agent and the Events Service is disabled by default; to re-enable, see Enable Agentless Analytics.

See the following sections to ensure that your deployment can connect to the Events Service:

Identify Internal Events Service Endpoints

The Controller uses the connection URL configured in Admin.jsp .

SaaS
In a SaaS environment, the internal URLs to connect to the Controller/app agents to the Events Service have already been deployed.
On-prem

In an on-premises environment, the agent requires access to the internal Events Service URL normally used by the Controller. The internal Events Service URL must be exposed to the agents and then set as the analytics.agentless.event.service.url:

  1. Log in to the Administration Console: http:<controller-hostname>:8080/controller/admin.jsp or https:<controller-hostname>:45/controller/admin.jsp .
  2. In Controller Settings, set analytics.agentless.event.service.url to the Events Service endpoint that is accessible from agents.
  3. Click Save.

Connection Ports

SaaS
The connection between the Java Agent, the .NET Agent, and the Events Service occurs over ports 80 (HTTP) and 443 (HTTPS). If your firewall rules are not configured properly, gaps will appear in your Analytics data.
On-prem
The port on which the Events Service receives data from the Java Agent and the .NET Agent is configured during installation.

If you have network policies that may prevent this connection, such as firewalls, you need to configure the policies to connect with the Events Service. See Troubleshoot Analytics Issues.

Enable SSL

If you use a custom trust store, see Enable SSL for the Java Agent or Enable SSL for the .NET Agent.

Proxy Configuration

Java
To encrypt credentials for proxy authentication, you need Java Agent >= 4.5.17 and Controller >= 4.5.17. See Java Agent Configuration Properties.
.Net

The .NET Agent does not support proxy authentication. Use these environment variables for proxy configuration.

To configure the .NET Agent to communicate with the Events Service with the proxy:

  1. Add/update the following environment variables.
  2. Restart your Windows application.
Agent → Events Service Sending Data For Proxy
appdynamics.http.proxyHost
appdynamics.http.proxyPort

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

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

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

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

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

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

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

Java

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

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

.NET

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

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

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

Java

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

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

.NET

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

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

注: 既存の分析エージェント

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