アプリケーション監視エージェントでサポートされるコンポーネントとフレームワーク - Application Real-Time Monitoring Service

本トピックでは、Application Real-Time Monitoring Service (ARMS) でサポートされているサードパーティの Java コンポーネントとフレームワークについて説明します。

サポートされる JDK バージョン

バージョン	説明
JDK 25	ARMS エージェントは、バージョン 4.7.x 以降で JDK 25 をサポートします。
JDK 21	アプリケーション監視エージェントは、バージョン 3.1.4 以降で JDK 21 をサポートします。ご利用の JDK バージョンが 21 の場合は、エージェントをバージョン 3.1.4 以降にアップグレードしてください。詳細については、「ARMS エージェントのアップグレード」をご参照ください。
JDK 17	継続的プロファイリングなどの ARMS の高度な機能の JDK バージョン要件を満たすには、JDK 17.0.9 以降を使用してください。詳細については、「継続的プロファイリング機能の有効化」をご参照ください。
JDK 11	継続的プロファイリングなどの ARMS の高度な機能の JDK バージョン要件を満たすには、JDK 11.0.17 以降を使用してください。詳細については、「継続的プロファイリング機能の有効化」をご参照ください。
JDK 1.8	Kubernetes クラスターにデプロイされたアプリケーションには、JDK 8u212 以降を使用してください。継続的プロファイリングなどの ARMS の高度な機能の JDK バージョン要件を満たすには、JDK 8u352 以降を使用してください。詳細については、「継続的プロファイリング機能の有効化」をご参照ください。
JDK 1.7	アプリケーション監視は、エージェントバージョン 3.0.x で Java 7 のサポートを終了します。現在も Java 7 を使用している場合は、できるだけ早く Java のバージョンをアップグレードしてください。詳細については、「[製品変更] アプリケーション監視における Java 7 のサポート終了」をご参照ください。

サポートされる JDK ディストリビューション

OpenJDK (推奨)
Alibaba Dragonwell (推奨)
Temurin
AdoptOpenJDK
Amazon Corretto
Azul
Java HotSpot VM

説明

Eclipse OpenJ9 はアプリケーション監視との互換性の問題があるため、推奨されません。

ARMS エージェント V4.x でサポートされるフレームワークとコンポーネント

説明

以下のフレームワークとコンポーネントは、ARMS エージェントの最新の 4.x バージョンでサポートされています。

コンポーネントタイプ	コンポーネント	サポートされるバージョン	機能
LLM クライアント/フレームワーク	OpenAI Java SDK	1.1.0+、2.X+、および 3.X+	ChatCompletion 呼び出しのメトリックとスパンを収集します。 Completion 呼び出しのメトリックとスパンを収集します。 Embedding 呼び出しのメトリックとスパンを収集します。
	Spring AI	1.X+	OpenAI ChatModel 呼び出しのメトリックとスパンを収集します。 Default ChatClient 呼び出しのメトリックとスパンを収集します。 Default ToolManager 呼び出しのメトリックとスパンを収集します。
	Spring AI Alibaba	1.0.0.3+	DashScope ChatModel 呼び出しのメトリックとスパンを収集します。
Web コンテナー	cxf	3.0+	cxf 関連の RED メトリックとスパンを収集します。
	restlet	1.1.0+	restlet 関連の RED メトリックとスパンを収集します。
	Tomcat	7.X～10.X	HTTP 関連の RED メトリックとスパンを収集します。 Tomcat スレッドプールのメトリックを収集します。
	Jetty	8.X～11.X	HTTP 関連の RED メトリックとスパンを収集します。 Jetty スレッドプールのメトリックを収集します。
	Play Framework	2.4+	HTTP 関連の RED メトリックとスパンを収集します。
	WebLogic	10.3.0～12.2.X	HTTP 関連の RED メトリックとスパンを収集します。
	Undertow	1.4.0+	HTTP 関連の RED メトリックとスパンを収集します。 Undertow スレッドプールのメトリックを収集します。
	Vert.x	3.0.0+	HTTP 関連の RED メトリックとスパンを収集します。
	Webflux	5.0.0.RELEASE+	HTTP 関連の RED メトリックとスパンを収集します。
	Spring Cloud Gateway	2.0.0.RELEASE+	HTTP 関連の RED メトリックとスパンを収集します。
	jFinal	3.6+	HTTP 関連の RED メトリックとスパンを収集します。
	WebSphere	9.0+	HTTP 関連の RED メトリックとスパンを収集します。
HTTP クライアント	Apache HTTP Client	2.0～5.3.1	HTTP 関連の RED メトリックとスパンを収集します。
	Google HTTP Client	1.19.0+	HTTP 関連の RED メトリックとスパンを収集します。
	Java HTTP Client	JDK 11+	HTTP 関連の RED メトリックとスパンを収集します。
	OkHttp	2.2+	HTTP 関連の RED メトリックとスパンを収集します。
	Async HTTP Client	1.8～2.12.3	HTTP 関連の RED メトリックとスパンを収集します。
RPC フレームワーク	Alibaba Dubbo	2.5.10～2.6.12	Dubbo 関連の RED メトリックとスパンを収集します。
	Apache Dubbo	2.7.0+	Dubbo 関連の RED メトリックとスパンを収集します。
	HSF	2.2～3.0	HSF 関連の RED メトリックとスパンを収集します。
	gRPC	1.6.0+	gRPC 関連の RED メトリックとスパンを収集します。
	Motan	0.3.0+	Motan 関連の RED メトリックとスパンを収集します。
JDBC 説明右側のコンポーネントの一部は、複数のメソッドでデータベースにアクセスできます。ARMS は、Java Database Connectivity (JDBC) 仕様に基づいて実行される CRUD (作成・読取・更新・削除) 操作のみを監視できます。	OceanBase	2.4.0+	データベース呼び出し関連のメトリックとスパンを収集します。
	MySQL	5.1.1+	データベース呼び出し関連のメトリックとスパンを収集します。
	PostgreSQL	42.0.0+	データベース呼び出し関連のメトリックとスパンを収集します。
	SQL Server	6.2.0.jre7+	データベース呼び出し関連のメトリックとスパンを収集します。
	MariaDB	1.5.2+	データベース呼び出し関連のメトリックとスパンを収集します。
	Oracle	12.2.0.1+	データベース呼び出し関連のメトリックとスパンを収集します。
	PolarDB	1.0.0+	データベース呼び出し関連のメトリックとスパンを収集します。
	ClickHouse	0.1.28+	データベース呼び出し関連のメトリックとスパンを収集します。
NoSQL	HBase	2.0～3.0	NoSQL 呼び出し関連のメトリックとスパンを収集します。
	Jedis	1.4+	NoSQL 呼び出し関連のメトリックとスパンを収集します。
	Lettuce	4.0.Final+	NoSQL 呼び出し関連のメトリックとスパンを収集します。 Lettuce 接続プールのメトリックを収集します。 NoSQL 応答サイズのメトリックを収集します。
	Redisson	3.0～3.25.2	NoSQL 呼び出し関連のメトリックとスパンを収集します。
	Memcached	2.12.0～2.12.3	NoSQL 呼び出し関連のメトリックとスパンを収集します。
	MongoDB	3.1+	NoSQL 呼び出し関連のメトリックとスパンを収集します。
	Elasticsearch	5.0+	NoSQL 呼び出し関連のメトリックとスパンを収集します。説明データ収集は、HTTP 経由で Elasticsearch サーバーにアクセスする場合にのみサポートされます。TCP 経由で Elasticsearch サーバーにアクセスする場合、データ収集はサポートされません。
	InfluxDB	2.7～2.23	NoSQL 呼び出し関連のメトリックとスパンを収集します。
	Cassandra	3.0+	NoSQL 呼び出し関連のメトリックとスパンを収集します。
メッセージ	Eclipse Paho Client MQTTv3	1.0.2+	コンシューマーの呼び出しに関連する RED メトリックとスパンを収集します。
	RocketMQ Java Client	4.4.0、4.5.1+、および 5.X+	コンシューマーおよびプロデューサーの呼び出しに関連する RED メトリックとスパンを収集します。メッセージレイテンシーのメトリックを収集します。
	RocketMQ Java Client V5	5.0.0+	コンシューマーおよびプロデューサーの呼び出しに関連する RED メトリックとスパンを収集します。メッセージレイテンシーのメトリックを収集します。
	Aliyun MNS SDK	1.3.0+	プロデューサーおよびコンシューマーの呼び出しに関連する RED メトリックとスパンを収集します。
	Aliyun ONS	1.7.0.Final+ および 2.0.0.Final+	コンシューマーおよびプロデューサーの呼び出しに関連する RED メトリックとスパンを収集します。メッセージレイテンシーのメトリックを収集します。
	Qpid JMS Client	0.49.0+	コンシューマーの呼び出しに関連する RED メトリックとスパンを収集します。
	RabbitMQ	4.X+	コンシューマーおよびプロデューサーの呼び出しに関連する RED メトリックとスパンを収集します。すべての Channel および Command 操作のスパンを収集します。
	Kafka	0.11.0.0+、1.X+、2.X+、および 3.X+	コンシューマーおよびプロデューサーの呼び出しに関連する RED メトリックとスパンを収集します。
	Spring-Kafka	2.7.0+	コンシューマー (Message Listener) の呼び出しに関連する RED メトリックとスパンを収集します。重複を防ぐため、Spring-Kafka がトレースでカウントされた後、基盤となる Kafka の拡張は有効になりません。
定期タスク	XXLJob	2.0.2+	定期タスクの呼び出しに関連する RED メトリックとスパンを収集します。
	SchedulerX	1.2.1～1.11.6	定期タスクの呼び出しに関連する RED メトリックとスパンを収集します。
	Spring Scheduled	3.1.0.RELEASE+	定期タスクの呼び出しに関連する RED メトリックとスパンを収集します。
	ElasticJob	3.0.0～3.0.4	定期タスクの呼び出しに関連する RED メトリックとスパンを収集します。
ログフレームワーク	Log4j	1.2+	ログコンテキストに EagleEye-TraceID を追加します。このタイプのログフレームワークによって出力されたログ数のメトリックを収集します。
	Log4j2	2.0+	ログコンテキストに EagleEye-TraceID を追加します。このタイプのログフレームワークによって出力されたログ数のメトリックを収集します。
	Logback	1.0.0～1.2.3	ログコンテキストに EagleEye-TraceID を追加します。このタイプのログフレームワークによって出力されたログ数のメトリックを収集します。
データベース接続プール	Druid	1.0.25+	接続プールのメトリックを収集します。接続取得操作のスパンを収集します。
	HikariCP	3.0.0+	接続プールのメトリックを収集します。
	C3P0	0.9.5+	接続プールのメトリックを収集します。
	MyBatis	3.1.0+	MyBatis 操作のスパンを収集します。
	DBCP	2+	接続プールのメトリックを収集します。
その他	Spring	4.1.0.RELEASE+	Spring のリクエストディスパッチコードをインストルメント化して、HTTP リクエストのルートを取得します。
その他	Spring-Bean	4.1.0.RELEASE+	Spring が管理する Bean の各 public メソッドをインストルメント化し、スパンを生成します。

ARMS エージェント V3.x でサポートされるフレームワークとコンポーネント

説明

以下のフレームワークとコンポーネントは、ARMS エージェントの最新の 3.x バージョンでサポートされています。

コンポーネントタイプ	コンポーネント	サポートされるバージョン
Web コンテナー	Tomcat	7.X～10.X
	Jetty	8.1.X～11.0.X
	Play Framework	2.2.X～2.8.X
	WebLogic	10.3.X～12.2.X
	Undertow	1.4.X～2.2.X
	Vert.x	3.3.X+
	Reactor Netty	0.7.X+
	Webflux	5.0.X+
HTTP クライアント	Apache HttpClient	3.0.X+
	Google HTTP Client	1.19.X+
	OkHttp/OkHttp3	2.1.X～4.11.X
	Spring Web (RestTemplate)
	AsyncHttpClient	2.0.X～2.12.X
Spring 関連	Spring MVC	3.0.5.RELEASE+
Spring 関連	Spring Scheduled	3.1.0.RELEASE+
Spring Cloud 関連	Hystrix	1.0.X～1.5.X
	Feign	9.0.X～12.4.X
	Spring Webflux	5.0.X～6.0.X
	Spring Cloud Gateway	2.1.X～4.0.X
RPC フレームワーク	Dubbo	2.4.X+
	Ali-HSF (High Speed Framework)	2.2.X+
	gRPC	0.7.X～1.56.X
	Thrift	0.1.X～0.18.X
JDBC 関連	PolarDB	1.1.2+ (ARMS エージェント V4.x 以降でサポート)
	MySQL Connector	5.0.X+
	PostgreSQL JDBC Driver	42.1.X+
	Microsoft JDBC Driver for SQL Server	6.4.X～12.2.X
	MariaDB Java Client	1.5.X～3.1.X
	Oracle ojdbc	7、8、10、および 14
	Sharding-JDBC	4.0.X～4.1.X
	Druid	1.0.X+
	Hikari-CP	2.3.X+
	MyBatis	3.1.X～3.5.X
	MyBatisPlus	1.0.X～1.7.X
NoSQL 関連	Jedis	2.X～4.X
	Lettuce	5.2.X+
	Redisson	2.5.X+
	Memcached	2.8.X～2.12.X
	MongoDB Java Driver	3.X
	Spring Data MongoDB	2.0.X～3.4.X
	Elasticsearch Rest Client	5.X～7.X
	Elasticsearch Rest High Level Client	6.X～7.X
	ClickHouse JDBC Driver	0.3.X～0.4.X
	InfluxDB	-
メッセージ関連	RocketMQ Java Client	4.4.0、4.5.1+、および 5.X+
	RocketMQ Java Client V5	5.X+
	Spring for Apache RocketMQ	2.0.2+
	Aliyun ONS	1.7.0.Final+ および 2.0.0.Final+
	RabbitMQ Java Client	4.X+
	Kafka Client	0.11.0.0+、1.X+、2.X+、および 3.X+
定期タスク	XXLJob	2.0.X～2.4.X
	ElasticJob	2.0.X～2.1.X
	SchedulerX	1.2.X～1.5.X
	Spring Scheduled	3.2.X～5.3.X
非同期/レスポンシブプログラミングフレームワーク	SpringAsync	4.0.X～5.3.X
	RxJava	2.0.X～3.1.X
	Reactor	3.0.X～3.5.X
ログフレームワーク	Log4j	1.2.16～1.2.17
	Log4j2	2.0～2.20.0
	Logback	1.0.13～1.4.8

説明

アプリケーション監視は、サポートされているコンポーネントを自動的にインストルメント化できます。上記のリストに含まれていないコンポーネントを使用する場合は、手動でインストルメント化できます。詳細については、「Java 用 OpenTelemetry SDK を使用してトレースにカスタムインストルメンテーションを追加する」をご参照ください。