Javaエージェントの設定オプション

application.name^*

• Applications Managerでのアプリケーションの表示名を指定してください。
• アプリケーションに複数インスタンスがあって、それらをグループにする場合は、すべてのインストールするAPMインサイト エージェント設定ファイルに同じアプリケーション名を指定する必要があります。

例：myonlineshopping.com

メモ：APMインサイトJavaエージェントでは、アプリケーション名をapminsight.confファイルではなく、JVM引数でも設定できます。次のパラメーターを付加してください。
-Dapminsight.application.name=My Application

My Application

behind.proxy

• エージェントをインストールしたアプリケーション サーバーへの接続に、プロキシを経由するか否かを指定してください。
• trueの場合、エージェントからApplications Managerへのメトリック データ送信に、プロキシ認証情報の指定が必要となります。
• behind.proxyをtrueにセットする場合、次のキーに値を指定してください。
  • proxy.server.host：プロキシ サーバーのホスト名
  • proxy.server.port：プロキシ サーバーのポート
  • proxy.auth.username：プロキシ サーバーのユーザー名
  • proxy.auth.password：プロキシ サーバーのパスワード

false

agent.server.port^*

• アプリケーション サーバーのHTTPリスニング ポートを指定してください。
• 同じホストで、同じアプリケーション サーバーが複数稼働しているとき、インスタンスを区別するのに便利です。例：8080

apminsight.log.dir

• APMインサイト ログの保存先ディレクトリ パスを表します。
• パス区切りにはスラッシュを利用します（/）。
• 例：D:/apminsight/
• 指定が間違っていたり、ディレクトリを作成できなかったりする場合は、エージェントjarファイルのあるディレクトリをデフォルトで選択します。

apminsight.log.level

• APMインサイト エージェントが情報を記録する際のログ レベルを指定します。
• SEVERE、WARNING、INFO、FINEから選択ください。

transaction.skip.listening

• 指定URLパターンのWebトランザクションを、追跡の対象から外します。
• 複数エントリは、カンマ（,）で区切って下さい。
• 例：transaction.skip.listening=*.jpegの指定で、.jpegで終わるトランザクションはスキップします。

*.css、*.js、*.gif、*.jpg、*.jpeg、*.bmp、*.png

データベースSQLクエリの捕捉

• このオプションを有効にすると、実行したクエリすべてをリスニングします。
• 無効の場合、データベース メトリックは収集しません。

true

トランザクション トレースでのSQLのパラメーター化

• このオプションを有効にすると、スロウなトランザクションのトレースにあるSQLクエリは、すべてパラメーター表記となります（sql.capture.enabledとtransaction.trace.enabledをtrueにする必要があります）。
• 無効の場合、実際のクエリ内容が、パラメーターの値とともに取得されます。
• クエリ実行の際、クレジットカード番号やパスワードなど秘密パラメーターを利用している場合は、この機能を有効にするよう推奨します。

true

トランザクション トレースでのSQLのスタック トレースしきい値

• このオプションを有効にすると、実行したSQLクエリが、ここで指定するしきい値を超えた場合に、スタック トレースの収集を行います。

3（秒）

エージェントの自動アップグレード

• 有効にすると、エージェントは自動的に、利用できる最新バージョンのダウンロードとインストールを行います。

false

license.key^*

• Applications Managerに対応するライセンスキーです。
• APMインサイト タブ > ヘルプ カードで見つかります。
• 値をコピーしてこのパラメーターに利用してください。
• このキーはApplications Managerごとに固有であり、ほかの方とは共有しないでください。

apm.host^*

• Applications Managerが稼働しているホストの名前です。
• 入力したホスト名が無効や到達不能の場合、エージェントは「Connection Refused」の例外を投げ、正しいホスト名がapminsight.confに設定されるまでリトライを続けます。
• 指定はホスト名でもIPv4アドレスでも可能です。

例：mymachine.mydomain.com

apm.protocol.https

• Applications ManagerにデータをHTTPSで送る場合は、trueを指定します。
• falseを指定すると、HTTPでの送信となります。

false

apm.port^*

• サービスが指定ポートで実行されていない場合、エージェントは「Connection Refused」例外を投げ、apminsight.confに正しいポートが入力されるまでリトライします。

Apdexしきい値

• Apdexスコア（Application Performance Index）はアプリケーションのパフォーマンスを測定し、0から1の間で示します。
• 詳細情報はwww.apdex.orgを参照ください（英語）。
• トランザクション応答時間のスコアに、Apdexしきい値より低いものがあれば、トランザクションは満足と判定されます（satisfied）。
• トランザクション応答時間のスコアに、Apdexしきい値の4倍を超えるものがあれば、トランザクションは不満と判定されます（frustrated）。
• Apdexしきい値とまったく同じか、満足と不満の間の場合は、容認と判定されます（tolerating）。

0.5（秒）

サンプル係数

• サンプリング係数を指定します。20にすれば、同一種別のリクエストは20個ごとに取得します（1番名、21番目、41番目…）。

1（リクエスト）

トランザクション トレーシングの有効化

• このオプションを有効にすると、スロウなトランザクションでトレース構築を実行します。
• Applications Mangerが収集したトレースは、APMインサイト ページでトレース タブを選択すると、確認できます。

true

トランザクション トレーシングのしきい値

• transaction.trace.enabledをtrueにしてある場合、応答時間が指定のしきい値を超えるトランザクションのトレースを収集します。
• トレースは、動作中のトランザクションの分析・トラブルシュートに利用できます。

2（秒）

webtransaction.trace.input.params.record

• このオプションを有効にすると、GETとPOSTのWebリクエストすべてのパラメーターを取得します。
• 特定パラメーターの取得をスキップする場合は、webtransaction.trace.input.params.ignoreキーをご利用ください。
• 捕捉したパラメーターは、トレース タブでトランザクションを選択すれば確認できます。

false

webtransaction.trace.input.params.ignore

• パスワード、PIN、その他の機密情報にかかわるパラメーター取得をスキップするには、パラメーター名をこのキーに指定します。
• 複数エントリはカンマ（,）で区切って下さい。このキーで指定する値は、大文字・小文字を区別します。
• 値の指定がなければ、すべてのリクエスト パラメーターを記録します。

password、authKey

webtransaction.naming.use.requesturl

• WebトランザクションのURLすべてを表示するには、apminsight.confファイルで webtransaction.naming.use.requesturl=trueを指定してください。これは隠し設定で、デフォルト値はfalseになっています。

webtransaction.encoding.charset

• Webアプリケーションの文字コードを指定するには、apminsight.confでwebtransaction.encoding.charset=Windows-1252のように指定してください（こちらは西ヨーロッパ言語のコードを指定する場合の例です）。デフォルトではUTF-8になっています。