データベースエージェントのプロパティ

この項では、データベースエージェントの構成プロパティについて説明します。対象には、 要素とシステム プロパティ オプションが含まれます。

必須のシステムプロパティ

エージェント jar ファイルへのパス 

エージェント jar ファイルのパス説明：jar ファイルへの絶対パスを指定します。

システムプロパティ：

 <db_agent_home>db-agent-jar

スペースを含む ASCII 文字列。 にスペースが含まれている場合は、名前全体を二重引用符（" "）で囲む必要があります。

必須：はい

：-jar="D:\AppDynamics\Database Agent\db-agent.jar"

Java ライブラリへのパス 

：sqlijdbc_auth.dll への絶対パスを提供します。

システム プロパティ： -Djava.library.path

値：

  • 64 ビットシステムの場合：<db_agent_home>\auth\x64
  • 32 ビットシステムの場合：<db_agent_home>\auth\x32 

スペースを含む ASCII 文字列。 にスペースが含まれている場合は、名前全体を二重引用符（" "）で囲む必要があります。

必須：推奨。Windows 64 ビットシステムでの SQL Server Windows 認証には必要です。

：-Djava.library.path="D:\AppDynamics\Database Agent\auth\x64"

オプションのシステムプロパティ

認証失敗時の再試行無効化

説明：JDBC 認証が失敗した場合に、JDBC 接続の確立の再試行を停止します。

-Dretry.on.auth.failure=false 

デフォルト：システムプロパティは true に設定されています。

型：文字列

番号の解析にサポートされているロケール

説明：番号の解析に使用するロケールを指定します。有効な値については、「Java 7 でサポートされているロケール」または「 Java 8 でサポートされているロケール」を参照してください。環境で実行している Java バージョンの値を使用します。

システムプロパティ： -Ddbagent. language

システムプロパティは、en-US または en_US に設定されています。

型：文字列

エージェントとコントローラ間のコミュニケーションプロパティ

コントローラ ホスト プロパティ

説明：これは Splunk AppDynamics コントローラのホスト名または IP アドレスです（例：192.168.1.22、myhost、または myhost.abc.com）。これは Splunk AppDynamics コントローラ UI のアクセスに使用するホストと同じです。

controller-info.xml 内の要素：<>

システムプロパティ：-Dappdynamics.controller.hostName

環境変数：APPDYNAMICS_CONTROLLER_HOST_NAME

型：文字列

デフォルト：なし

必須：はい

コントローラ ポート プロパティ

説明：これは、Splunk AppDynamics コントローラの HTTP（S）ポートです。これは Splunk AppDynamics のブラウザベースのユーザーインターフェイスのアクセスに使用するポートと同じです。コントローラ SSL 対応プロパティが true に設定されている場合はコントローラの HTTPS ポートを指定し、それ以外の場合は HTTP ポートを指定します。「コントローラ SSL 対応プロパティ」を参照してください。

controller-info.xml 内の要素：<>

 -Dappdynamics.controller.port

環境変数：APPDYNAMICS_CONTROLLER_PORT

タイプ：正の整数

デフォルト：オンプレミスのインストールの場合、HTTP にはポート 8090、HTTPS にはポート 8181 が、コントローラがリッスンするデフォルトポートです。SaaS コントローラサービスでは、HTTP にはポート 80、HTTPS にはポート 443 がコントローラがリッスンするデフォルトポートです。

必須：はい

アカウント アクセス キー プロパティ

説明：これはコントローラの認証に使用するアカウントアクセスキーです。

controller-info.xml 内の要素：

 -Dappdynamics.agent.accountAccessKey

環境変数：APPDYNAMICS.AGENT.ACCOUNTACCESSKEY

型：文字列

デフォルト：なし

要否：要。4.1 より前のバージョンでは、このプロパティは、SaaS およびマルチテナントコントローラにのみ必要でした。アカウント アクセス キー プロパティは、すべてのエージェントをコントローラ通信に認証するために必要になりました。

例：-Dappdynamics.agent.accountAccessKey=165e65645-95c1-40e3-9576-6a1424de9625

複数のエージェント環境のプロパティ

以下のプロパティは、複数のデータベースエージェントを含めるようにシステムを構成する場合に役立ちます。

データベースエージェント名のプロパティ

データベースエージェント名のプロパティ説明：このプロパティは、コントローラに対してデータベースエージェントを一意に識別します。

システムプロパティ： -Ddbagent.name=<db_agent_name>

スペースを含む ASCII 文字列。 にスペースが含まれている場合は、名前全体を二重引用符（" "）で囲む必要があります。

デフォルト：デフォルト データベース エージェント

デフォルト：デフォルトのデータベースエージェント要否：コントローラにレポートするデータベースエージェントが複数ある場合は必要です。

次の条件下では、複数のを実行することができます。

  • データベースが複数のネットワークに分散していて、1 台のマシンがすべてのネットワークにあるすべてのデータベースにアクセスできない場合。この場合、各ネットワークに一意の名前が付けられたデータベースエージェントを使用して、そのネットワーク上で表示されるデータベースのみをモニタすることができます。
  • 複数の SQL Server インスタンスがあり、それぞれに異なるクレデンシャルが必要であり、Windows 認証を介してそれらに接続する必要がある場合。Windows 認証を使用する場合、データベースエージェントは現在ログインしているユーザのクレデンシャルを使用します。
  • 1 つ以上のエージェントがプライマリエージェントをバックアップする必要がある場合。バックアップエージェントのデータベースエージェント名は、プライマリエージェントのデータベースエージェント名と一致している必要があります。最後に起動したエージェントがプライマリエージェントになります。
 ：-Ddbagent.name="Scarborough Network Database Agent"

一意のホスト ID

説明：一意のホスト ID で単一の物理ホストまたは仮想マシンを論理的に分割し、アプリケーションが異なるマシンで実行されているコントローラに表示されるようにする。管理しているインフラストラクチャ全体をとおして一意の値を文字列に設定する。文字列に空白文字は使用できません。データベースエージェントと同じホストで実行されているマシンエージェントがある場合、このプロパティ値はマシンエージェントのプロパティ値と異なる値にする必要があります。同じホストから複数のデータベースエージェントを同じ名前で実行している場合、このプロパティ値は各エージェントで異なる必要があります。

 -Dappdynamics.agent.uniqueHostId

型：文字列

デフォルト：なし

環境変数：APPDYNAMICS_AGENT_UNIQUE_HOST_ID

マルチテナントモードのプロパティ

Splunk AppDynamics コントローラがマルチテナントモードで実行している場合、または Splunk AppDynamics SaaS コントローラを使用している場合、このエージェントがコントローラの認証に使用するアカウント名とアカウントアクセスキーを指定します。

コントローラがシングルテナントモード（デフォルト）で実行されている場合は、これらの値を設定する必要はありません。

アカウント名のプロパティ

説明：これは、コントローラの認証に使用されるアカウント名です 。Splunk AppDynamics SaaS コントローラを使用している場合、アカウント名はお客様に送信されるウェルカムメール Splunk AppDynamics に記載されます。

controller-info.xml 内の要素：<>

 -Dappdynamics.agent.accountName

環境変数：APPDYNAMICS.AGENT.ACCOUNTNAME

型：文字列

デフォルト：なし

要否：SaaS Splunk AppDynamics SaaS コントローラとマルチテナントユーザーでは必須。シングルテナントモードでは必須ではありません。

コントローラ用プロキシプロパティ

これらのプロパティは、プロキシを介してコントローラにデータをルーティングします。

プロキシホストのプロパティ

説明：これは、プロキシホスト名または IP アドレスです。

controller-info.xml 内の要素：該当なし

システムプロパティ：-Dappdynamics.http.proxyHost

型：文字列

デフォルト：なし

必須：いいえ

プロキシポートのプロパティ

説明：これは、プロキシ HTTP（S）ポートです。

controller-info.xml 内の要素：該当なし

システムプロパティ：-Dappdynamics.http.proxyPort

タイプ：正の整数

デフォルト：なし

必須：いいえ

プロキシユーザー名

説明：プロキシホストが認証したユーザー名

controller-info.xml 内の要素：該当なし

システムプロパティ：-Dappdynamics.http.proxyUser

型：文字列

デフォルト：なし

必須：いいえ

プロキシパスワード

説明：プロキシホストにより認証されるユーザーのパスワードを含むファイルへの絶対パス。パスワードはファイルの最初の行になければなりません。

[暗号化されたログイン情報の使用（Use Encrypted Credentials）] が false の場合、パスワードをプレーンテキストで入力します。暗号化された認証情報を使用[暗号化されたログイン情報の使用（Use Encrypted Credentials）] が true の場合、パスワードを暗号化します。「エージェントのログイン情報の暗号化」を参照してください。

controller-info.xml 内の要素：該当なし

システムプロパティ：-Dappdynamics.http.proxyPasswordFile

型：文字列

デフォルト：なし

必須：いいえ

他のプロパティ

コントローラ SSL 対応プロパティ

説明：このプロパティは、エージェントが SSL（HTTPS）を使用してコントローラに接続するかどうかを指定します。SSL対応がtrueの場合、コントローラポートのプロパティをコントローラのHTTPSポートに設定します。「コントローラ ポート プロパティ」を参照してください。

controller-info.xml 内の要素：<>

 -Dappdynamics.controller.ssl.enabled

環境変数：APPDYNAMICS_CONTROLLER_SSL_ENABLED

型：boolean

デフォルト：False

必須：いいえ