Javaバックエンド検出

Related pages:

AppDynamics Java エージェントは、バックエンドに関連付けられたイグジットポイントに基づいて、バックエンドシステムとして一般的なタイプのリモートサービスを自動的に検出します。お使いの環境で使用されているバックエンドシステムが自動的に検出されない場合は、自動的に検出されるタイプであるかどうかを確認し（以下のリストを参照）、そのタイプのデフォルトのイグジットポイントをお使いのアプリケーション環境で使用されているものと比較します。

自動検出されたバックエンドタイプには、それぞれデフォルトの検出ルールがあります。多くのバックエンドタイプには、一連のバックエンド命名プロパティがあります。個々のプロパティが構成可能な場合、以下のようにプロパティを構成できます。

プロパティをそのまま使用。
プロパティのセグメントを使用。
プロパティで正規表現を実行。詳細については、正規表現の使用を参照してください。
プロパティでメソッドを実行。「Getterチェーンの使用」を参照してください。

バックエンド検出ルールの変更方法については、「バックエンド検出ルール」を参照してください。

Amazon Simple Notification Serviceのバックエンド

AppDynamics では、Amazon SNS クライアント AmazonSNSClient.publish を使用する Amazon SNS メッセージングサービスに対する終了コールが検出されます。

Amazon SNSの命名プロパティ

Amazon S3 のバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのAmazon SNSバックエンド自動検出/命名
ベンダー	あり
トピックARN	あり

Amazon Simple Queue Serviceのバックエンド

AppDynamicsでは、以下のタイプのAmazon Web Services SQSメッセージキューアクションを検出することができます。

基本的な送受信
一括送受信
非同期送受信

SQSトラフィックの関連付けを行う場合、SQSメッセージに対して継続エントリポイントを構成する必要があります。

Amazon Simple Storage Serviceのバックエンド

AppDynamicsでは、Amazon Web Services S3バックエンドに対する以下のイグジットポイントを自動的に検出することができます。

AmazonS3Client.deleteObject
AmazonS3Client.getObject
AmazonS3Client.getObjectMetadata
AmazonS3Client.listObjects
AmazonS3Client.putObject

Amazon S3の命名プロパティ

Amazon S3のバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのAmazon S3自動検出/命名
バケット名	あり
ベンダー	あり
オブジェクトキー	なし

Amazon Web Servicesのバックエンド

AppDynamicsでは、以下のAmazon Web Servicesに対する以下の終了コールを検出することができます。

DynamoDB は、Amazon 低レベル DynamoDB API を使用する AmazonDynamoDBClient の作成、読み取り、更新、および削除（CRUD）メソッドを使用してリクエスト。エージェントは、Document APIコールを下層の低レベルAPIコールとして検出。

Amazon Web Serviceの命名プロパティ

Amazon Web Servicesのバックエンド識別に対する以下の命名プロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのAmazon Web Serviceバックエンド自動検出/命名
ベンダー	あり
サービス	あり
エンドポイント	あり

Apache Cassandra CQLのバックエンド

デフォルトで、AppDynamicsでは、ThriftおよびDataStaxドライバを使用するApache Cassandraに対する終了コールが自動的に検出および識別されます。

Cassandraバックエンドから返ってきた例外は、独立した終了コールとして表示されます。DataStax 1.0ドライバの場合、Javaエージェントはエラー詳細を取得するために「不明な」Cassandraバックエンドを検出します。

Cassandraバックエンドの命名プロパティ

Cassandraのバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

Cassandraバックエンドの命名を構成する場合は、以下を考慮してください。

DataStaxクライアントの場合、AppDynamicsではキースペースプロパティの使用は推奨されません。ドライバの制限により、キースペースプロパティは Statement.setKeyspace が Cassandra で明示的に呼び出された時のみ使用できます。これは、複数のバックエンドの検出につながる可能性があります。
Thriftクライアントはクラスタ名、ラックまたはデータセンタプロパティをサポートしていません。このため、これらのプロパティはThriftに対してnullを返します。

構成可能なプロパティ	デフォルトのCassandra CQLバックエンド自動検出/命名
クラスタ名	あり
キースペース	なし
ホスト（Host）	必須
ポート	あり
データセンタ	なし
ラック	なし

Apache Kafkaのバックエンド

デフォルトでは、Java エージェントは、Java ノードからのイグジットポイントとして Apache Kafka へのパブリッシュアクティビティを検出します。Kafka コンシューマアクティビティをエントリポイントとして検出するように Java エージェントを構成する場合は、「Apache Kafkaコンシューマバックエンド」を参照してください。

Kafkaバックエンドの命名プロパティ

Kafkaのバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのIBM MQバックエンド自動検出/命名
ベンダー	あり
トピック名	あり
ブローカーのURL	なし

デフォルトのKafka JMXメトリック

Kafka ProducerおよびConsumerで公開されるJMXメトリックは多数あります。ユーザの役に立つと思われるメトリックをいくつか選択し、それらの OOTB ルールを作成しました。ProducerとConsumerでサポートされているメトリックはそれぞれ以下のリストを検索してください。OOTBルールを利用できないその他のメトリックが必要な場合は、MBeanブラウザに移動してメトリックを選択し、そこからルールを作成できます。

Couchbase バックエンド

デフォルトでは、AppDynamics は Couchbase クラスタノードに対する exit コールを自動的に検出して識別します。

Couchbase バックエンドの命名プロパティ

Couchbase イグジットのバックエンド識別では、次のプロパティの使用を有効または無効にできます。

構成可能なプロパティ	デフォルトの Couchbase バックエンド自動検出/命名
サーバプール	あり
ベンダー	あり
バケット名	あり

HTTPバックエンド

HTTP イグジットポイントアクティビティには、Web サービスコールの外部で実行されたすべての HTTP コールが含まれます。Web サービスコールは、HTTP イグジットポイントとは見なされません。デフォルトでは、Java エージェントは、ホストおよびポートのプロパティに基づいて HTTP バックエンドを命名します。たとえば、「myHTTPHost:5000」というようになります。

HTTPバックエンドの命名プロパティ

HTTPのバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのHTTPバックエンド自動検出/命名
ホスト（Host）	必須
ポート	あり
URL	なし
クエリ文字列	いいえ

一般的な HTTP バックエンド構成の例については、「HTTPバックエンド検出」を参照してください。

JDBC バックエンド構成の例については、「JDBCバックエンド構成の例」を参照してください。

IBM Websphere Message Queueのバックエンド

IBM WebSphere MQやIBM MQSeriesとしても知られる、IBM MQは、JMSに似たIBMのメッセージ指向のミドルウェアです。ホストやポートなど、複数の追加プロパティが構成可能です。これは、多くのキューがあり、プロパティのサブセットに基づいてこれらのキューをモニタリングしたい場合に役立ちます。

IBM MQバックエンドの命名プロパティ

IBM MQのバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのIBM MQバックエンド自動検出/命名
宛先	はい
宛先タイプ	あり
ホスト（Host）	必須
ポート	あり
メジャーバージョン	あり
ベンダー	あり

一般的なメッセージキュー構成シナリオの例については、「メッセージキューバックエンド構成の例」を参照してください。

Java Message Serviceのバックエンド

JMSバックエンドアクティビティには、全てのJMSメッセージの送信およびパブリッシュアクティビティが含まれます。デフォルトで、AppDynamics では、ベンダー、宛先名、宛先タイプなどの JMS サーバのプロパティを使用して JMS バックエンドが識別されます。デフォルト構成では、JMS キューの 3 つのプロパティがすべて使用されます。

JMSバックエンドの命名プロパティ

JMSのバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのJMSバックエンド自動検出/命名
宛先	はい
宛先タイプ	あり
ベンダー	あり

トランザクション名は有効なプロパティから取得され、例えば「ActiveMQ-OrderQueue」となります。

一般的なメッセージキュー構成シナリオの例については、「メッセージキューバックエンド構成の例」を参照してください。

JDBCバックエンド

JDBC バックエンドアクティビティは、挿入、クエリ、更新、接続プールからの接続の取得など、すべての JDBC コールで構成されます。

クラス	メソッド
`oracle.jdbc.driver.PhysicalConnection`	`prepareStatement` `prepareCall` `commit` `rollback`
`oracle.jdbc.driver.OracleStatement`	`executeQuery` `executeUpdate` `execute`
`oracle.jdbc.driver.OracleDataSource`	`getConnection`
`oracle.jdbc.driver.OraclePreparedStatement`	`executeQuery` `addBatch` `execute` `executeUpdate`
`oracle.jdbc.driver.OraclePreparedStatementWrapper`	`execute` `executeQuery` `executeUpdate`

Javaエージェントは、データベースコールの応答時間をJDBCコールが戻ってくるまでにかかる往復時間として測定します。データベースコールの応答時間には、ネットワーク往復時間 + データベース接続時間 + SQL クエリ時間またはデータベースで費やされたその他の時間が含まれます。

デフォルトで、エージェントはデータベースの以下の論理プロパティを使ってJDBCバックエンドを識別します。

URL
ホスト名
ポート番号
データベーススキーマ
バージョン
ベンダー

データベースバックエンドが、データベースコレクタですでに構成されているデータベースサーバと同じホスト名、ポート番号、およびデータベースタイプを持つ場合、データベースバックエンドはコレクタと自動的に照合されます。そして、アプリケーションフローマップ、ティアフローマップまたはノードフローマップからデータベースモニタリングへのドリルダウンが有効になります。

JDBCバックエンドの命名プロパティ

JDBCのバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのJDBCバックエンド自動検出/命名	説明
URL	あり	ドライバに提供されるJDBC URL
ホスト（Host）	必須	データベースホスト
ポート	あり	データベースポート
データベース	あり	データベーススキーマ
バージョン	はい	JDBCドライバがレポートするデータベースバージョン
ベンダー	あり	JDBCドライバがレポートするデータベースベンダー

Joltバックエンド

AppDynamicsでは、JoltクラスライブラリのJoltRemoteServiceクラスからTuxedoサービスに対する終了コールが検出されます。

Joltの命名プロパティ

Joltのバックエンド識別に対する以下の命名プロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのJoltバックエンド自動検出/命名
ホスト（Host）	必須
ポート	あり
サービス	あり

MongoDBバックエンド

デフォルトで、Java エージェントは、MongoDB Wire プロトコル経由で Mongo Java Driver を使用する MongoDB に対する終了コールを検出します。エージェントはWireプロトコルメソッドのイグジットポイントを検出し、外部APIとWireプロトコル間のメソッドを除外します。

MongoDBバックエンドの命名プロパティ

構成可能なプロパティ	デフォルトのMongoDBバックエンド自動検出/命名
ホスト（Host）	必須
ポート	あり
データベース	あり

RabbitMQバックエンド

RabbitMQ は、さまざまなオペレーティングシステムで実行されるオープンソースであり、市販のメッセージングミドルウェアです。Java エージェントは、ほとんどのディストリビューションで RabbitMQ Java API（amqp-client.jar）を使用してイグジットポイントを検出します。デフォルトでは、RabbitMQ バックエンドは、ホスト、ポート、ルーティングキー、および交換によって識別されます。例："amqp://guest@127.0.0.1:5672/exchange/task_queue"。

RabbitMQバックエンドの命名プロパティ

RabbitMQのバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのRabbitMQバックエンド自動検出/命名
ホスト（Host）	必須
ポート	あり
ルーティングキー	対応
Exchange	あり

一般的なメッセージキュー構成シナリオの例については、「メッセージキューバックエンド構成の例」を参照してください。

RMIバックエンド

Javaエージェントは、標準のJava RMI APIを使用して呼び出されたバックエンドを自動的に検出します。サポートされる RMI フレームワークのリストについては、「Java対応環境」の「RPC/Web サービス API/HTTP クライアントサポート」を参照してください。

RMIバックエンドの命名プロパティ

JAVAエージェントは、URLに対してRMIバックエンドに名前を付けます。エージェントがどのようにURLを使用してRMIバックエンドに名前を付けるかを構成することができます。

Thriftバックエンド

デフォルトで、AppDynamicsではApache Thriftイグジットポイント（バックエンド）が自動的に検出および識別されます。
詳細は「Apache Thrift」を参照してください。

Thriftバックエンドの命名プロパティ

Thriftイグジットのバックエンド識別に対する以下のプロパティの使用を有効または無効にすることができます。

構成可能なプロパティ	デフォルトのThriftバックエンド自動検出/命名
ホスト（Host）	必須
ポート	あり
トランスポート	あり

Webサービスのバックエンド

Webサービスのバックエンドアクティビティには、全てのWebサービス呼び出しが含まれます。Webサービスのバックエンドは、Webサービス名を使って識別されます。

Webサービスバックエンドの命名プロパティ

構成可能なプロパティ	デフォルトのWebサービスバックエンド自動検出/命名
サービス	あり
URL	なし
オペレーション	なし
Soapアクション	なし
ベンダー	なし

デフォルトでは、gRPC バックエンドは ServiceName-gRPC として識別されます。これは、Web サービスバックエンドでも設定できます。