データベースエージェントのプロパティ
この項では、データベースエージェントの構成プロパティについて説明します。対象には、controller-info-xml 要素とシステム プロパティ オプションが含まれます。
必須のシステムプロパティ
エージェント jar ファイルへのパス
Description:jar ファイルへの絶対パスを提供します。
System Property: -jar
Value: <db_agent_home>db-agent-jar
<db_agent_home> にスペースが含まれている場合は、名前全体を二重引用符(" ")で囲む必要があります。 Required: はい
Example:-jar="D:\AppDynamics\Database Agent\db-agent.jar" Java ライブラリへのパス
Description:sqlijdbc_auth.dll への絶対パスを指定します。 System Property: -Djava.library.path
Value:
- 64 ビットシステムの場合:
<db_agent_home>\auth\x64 - 32 ビットシステムの場合:
<db_agent_home>\auth\x32
Type:スペースを含む ASCII 文字列。db_agent_home> にスペースが含まれている場合は、名前全体を二重引用符(" ")で囲む必要があります。
Required:推奨Windows 64 ビットシステムでの SQL Server Windows 認証には必要です。
Example: -Djava.library.path="D:\AppDynamics\Database Agent\auth\x64"
オプションのシステムプロパティ
認証失敗時の再試行無効化
Description:JDBC 認証が失敗した場合に、JDBC 接続の確立の再試行を停止します。
System Property: -Dretry.on.auth.failure=false
Default:システムプロパティは true に設定されています。
Type:文字列
番号の解析にサポートされているロケール
Description:番号の解析に使用するロケールを指定します。有効な値については、「Java 7 でサポートされているロケール」または「 Java 8 でサポートされているロケール」を参照してください。環境で実行している Java バージョンの値を使用します。
System Property: -Ddbagent.language
Default:システムプロパティは en-US または en_US に設定されています。
Type:文字列
エージェントとコントローラ間のコミュニケーションプロパティ
コントローラ ホスト プロパティ
Description:これは Splunk AppDynamics コントローラのホスト名または IP アドレスです(例:192.168.1.22、myhost、または myhost.abc.com)。これは Splunk AppDynamics コントローラ UI のアクセスに使用するホストと同じです。
Element in controller-info.xml: <controller-host>
System Property: -Dappdynamics.controller.hostName
Environment Variable: APPDYNAMICS_CONTROLLER_HOST_NAME
Type:文字列
Default: なし
Required: はい
コントローラ ポート プロパティ
Description:これは、Splunk AppDynamics コントローラの HTTP(S)ポートです。これは Splunk AppDynamics のブラウザベースのユーザーインターフェイスのアクセスに使用するポートと同じです。コントローラ SSL 対応プロパティが true に設定されている場合はコントローラの HTTPS ポートを指定し、それ以外の場合は HTTP ポートを指定します。「Controller SSL Enabled Property」を参照してください。
Element in controller-info.xml: <controller-port>
System Property: -Dappdynamics.controller.port
Environment Variable: APPDYNAMICS_CONTROLLER_PORT
Type:正の整数
Default:オンプレミスのインストールの場合、HTTP にはポート 8090、HTTPS にはポート 8181 が、コントローラがリッスンするデフォルトポートです。SaaS コントローラサービスでは、HTTP にはポート 80、HTTPS にはポート 443 がコントローラがリッスンするデフォルトポートです。
Required: はい
アカウント アクセス キー プロパティ
Description:これはコントローラの認証に使用するアカウントアクセスキーです。
Element in controller-info.xml: <account-access-key>
System Property: -Dappdynamics.agent.accountAccessKey
Environment Variable: APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY
Type:文字列
Default: なし
Required:はい。4.1 より前のバージョンでは、このプロパティは、SaaS およびマルチテナントコントローラにのみ必要でした。アカウント アクセス キー プロパティは、すべてのエージェントをコントローラ通信に認証するために必要になりました。
Example:-Dappdynamics.agent.accountAccessKey=165e65645-95c1-40e3-9576-6a1424de9625
複数のエージェント環境のプロパティ
以下のプロパティは、複数のデータベースエージェントを含めるようにシステムを構成する場合に役立ちます。
データベースエージェント名のプロパティ
Description:このプロパティは、コントローラに対してデータベースエージェントを一意に識別します。
System Property: -Ddbagent.name=<db_agent_name>
Type:スペースを含む ASCII 文字列。<agent_name> にスペースが含まれている場合は、名前全体を二重引用符(" ")で囲む必要があります。
Default:デフォルト データベース エージェント
Required:コントローラにレポートするデータベースエージェントが複数ある場合は必要です。
次の条件下では、複数のデータベースエージェントを実行することができます。
- データベースが複数のネットワークに分散していて、1 台のマシンがすべてのネットワークにあるすべてのデータベースにアクセスできない場合。この場合、各ネットワークに一意の名前が付けられたデータベースエージェントを使用して、そのネットワーク上で表示されるデータベースのみをモニタすることができます。
- 複数の SQL Server インスタンスがあり、それぞれに異なるクレデンシャルが必要であり、Windows 認証を介してそれらに接続する必要がある場合。Windows 認証を使用する場合、データベースエージェントは現在ログインしているユーザのクレデンシャルを使用します。
- 1 つ以上のエージェントがプライマリエージェントをバックアップする必要がある場合。バックアップエージェントのデータベースエージェント名は、プライマリエージェントのデータベースエージェント名と一致している必要があります。最後に起動したエージェントがプライマリエージェントになります。
-Ddbagent.name="Scarborough Network Database Agent"一意のホスト ID
Description:一意のホスト ID で単一の物理ホストまたは仮想マシンを論理的に分割し、アプリケーションが異なるマシンで実行されているコントローラに表示されるようにする。管理しているインフラストラクチャ全体をとおして一意の値を文字列に設定する。文字列に空白文字は使用できません。データベースエージェントと同じホストで実行されているマシンエージェントがある場合、このプロパティ値はマシンエージェントのプロパティ値と異なる値にする必要があります。同じホストから複数のデータベースエージェントを同じ名前で実行している場合、このプロパティ値は各エージェントで異なる必要があります。
System Property: -Dappdynamics.agent.uniqueHostId
Type:文字列
Default: なし
Environment Variable: APPDYNAMICS_AGENT_UNIQUE_HOST_ID
マルチテナントモードのプロパティ
Splunk AppDynamics コントローラがマルチテナントモードで実行している場合、または Splunk AppDynamics SaaS コントローラを使用している場合、このエージェントがコントローラの認証に使用するアカウント名とアカウントアクセスキーを指定します。
コントローラがシングルテナントモード(デフォルト)で実行されている場合は、これらの値を設定する必要はありません。
アカウント名のプロパティ
Description:これは、コントローラの認証に使用されるアカウント名です 。 Splunk AppDynamics SaaS コントローラを使用している場合、アカウント名はお客様に送信されるウェルカムメール Splunk AppDynamics に記載されます。
Element in controller-info.xml: <account-name>
System Property: -Dappdynamics.agent.accountName
Environment Variable: APPDYNAMICS_AGENT_ACCOUNT_NAME
Type:文字列
Default: なし
Required:Splunk AppDynamics SaaS コントローラとマルチテナントユーザーでは必須。シングルテナントモードでは必須ではありません。
コントローラ用プロキシプロパティ
これらのプロパティは、プロキシを介してコントローラにデータをルーティングします。
プロキシホストのプロパティ
Description:これは、プロキシホスト名または IP アドレスです。
Element in controller-info.xml:該当なし
System Property: -Dappdynamics.http.proxyHost
Type:文字列
Default: なし
Required: なし
プロキシポートのプロパティ
Description:これは、プロキシ HTTP(S)ポートです。
Element in controller-info.xml:該当なし
System Property: -Dappdynamics.http.proxyPort
Type:正の整数
Default: なし
Required: なし
プロキシユーザー名
Description:プロキシホストが認証したユーザー名。
Element in controller-info.xml:該当なし
System Property: -Dappdynamics.http.proxyUser
Type:文字列
Default: なし
Required: なし
プロキシパスワード
Description:プロキシホストにより認証されるユーザーのパスワードを含むファイルへの絶対パス。パスワードはファイルの最初の行になければなりません。
[暗号化されたログイン情報の使用(Use Encrypted Credentials)] が false の場合、パスワードをプレーンテキストで入力します。暗号化された認証情報を使用[暗号化されたログイン情報の使用(Use Encrypted Credentials)] が true の場合、パスワードを暗号化します。「エージェントのログイン情報の暗号化」を参照してください。
Element in controller-info.xml:該当なし
System Property: -Dappdynamics.http.proxyPasswordFile
Type: String
Default: なし
Required: なし
他のプロパティ
コントローラ SSL 対応プロパティ
Description:このプロパティは、エージェントが SSL(HTTPS)を使用してコントローラに接続するかどうかを指定します。SSL対応がtrueの場合、コントローラポートのプロパティをコントローラのHTTPSポートに設定します。「コントローラ ポート プロパティ」を参照してください。
Element in controller-info.xml: <controller-ssl-enabled>
System Property: -Dappdynamics.controller.ssl.enabled
Environment Variable: APPDYNAMICS_CONTROLLER_SSL_ENABLED
Type:ブール型
Default: 誤り
Required: なし