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

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

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

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

Description:jar ファイルへの絶対パスを提供します。

System Property-jar

Value<db_agent_home>db-agent-jar

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

Required: はい

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

Java ライブラリへのパス

Descriptionsqlijdbc_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 VariableAPPDYNAMICS_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 VariableAPPDYNAMICS_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 VariableAPPDYNAMICS_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 つ以上のエージェントがプライマリエージェントをバックアップする必要がある場合。バックアップエージェントのデータベースエージェント名は、プライマリエージェントのデータベースエージェント名と一致している必要があります。最後に起動したエージェントがプライマリエージェントになります。
Example-Ddbagent.name="Scarborough Network Database Agent"

一意のホスト ID

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

System Property-Dappdynamics.agent.uniqueHostId

Type:文字列

Default: なし

Environment VariableAPPDYNAMICS_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 VariableAPPDYNAMICS_AGENT_ACCOUNT_NAME

Type:文字列

Default: なし

RequiredSplunk 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

TypeString

Default: なし

Required: なし

他のプロパティ

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

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

Element in controller-info.xml<controller-ssl-enabled>

System Property-Dappdynamics.controller.ssl.enabled

Environment VariableAPPDYNAMICS_CONTROLLER_SSL_ENABLED

Type:ブール型

Default: 誤り

Required: なし