このページでは、データベースエージェントの設定方法について説明します。

関連ページ：

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

エージェントのプロパティは、次の場所で構成できます。

  • <db_agent_home>/conf ディレクトリの controller-info.xml ファイル

  • JVM の起動コマンドのシステムプロパティ（-D options)セクション。システムプロパティは、controller-info.xml ファイルの設定を上書きします。システムプロパティは大文字と小文字が区別されます。  

    java -XX:+HeapDumpOnOutOfMemoryError -XX:OnOutOfMemoryError=“kill -9 %p” -jar db-agent.jar
    CODE

    Java 15 より後を使用している場合は、次のコマンドを使用します。

    java -XX:+HeapDumpOnOutOfMemoryError -XX:OnOutOfMemoryError=“kill -9 %p” -jar db-agent.jar --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.security=ALL-UNNAMED
    CODE

    または、スクリプトを使用してエージェントを起動することもできます。

    Windowsstart-dbagent.bat -Xms<min_heap_size> -Xmx<max_heap_size>
    Linux

    ./start-dbagent -Xms<min_heap_size> -Xmx<max_heap_size> &

データベースエージェント controller-info.xml ファイルの例

	<?xml version="1.0" encoding="UTF-8"?>
<controller-info>

	<controller-host>192.10.10.10</controller-host>
	<controller-port>8090</controller-port>
    <account-access-key>165e65645-95c1-40e3-9576-6a1424de9625</account-access-key>
	<!-- The following attribute enables or disables SSL communications between the agent and the Controller.-->
	<controller-ssl-enabled>false</controller-ssl-enabled>
 
	<!-- The following account-related parameters are necessary only for SaaS installations-->
	<!--account-name></account-name-->

</controller-info>

システムプロパティを使用したスタートアップ コンフィギュレーションの例

Bash の例です。システムプロパティでは大文字と小文字が区別されることに注意してください。

-Dappdynamics.controller.hostName=192.168.1.20 -Dappdynamics.controller.port=8090

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

この項では、Database Agentの設定プロパティについて説明します。これには、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 ライブラリへのパス 

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: これは Cisco AppDynamics コントローラのホスト名または IP アドレスです（例：192.168.1.22、myhost、または myhost.abc.com）。これは Cisco AppDynamics コントローラ UI のアクセスに使用するホストと同じです。

Element in controller-info.xml:  <controller-host>

System Property: -Dappdynamics.controller.hostName

Environment Variable： APPDYNAMICS_CONTROLLER_HOST_NAME

Type: ストリング

Default: なし

Required: はい

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

Description: これは、Cisco AppDynamics コントローラの HTTP(S) ポートです。これは Cisco 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：コントローラにレポートするデータベースエージェントが複数ある場合は必要です。

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

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

Example：-Ddbagent.name="Scarborough Network Database Agent"

一意のホスト ID

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

System Property: -Dappdynamics.agent.uniqueHostId

Type: ストリング

Default:なし

Environment Variable：APPDYNAMICS_AGENT_UNIQUE_HOST_ID

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

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

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

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

Description:これは、コントローラの認証に使用されるアカウント名です。
Cisco AppDynamics SaaS コントローラを使用する場合、アカウント名は Cisco AppDynamics から送信されたウェルカムメールで通知されます。

Element in controller-info.xml:  <account-name>

System Property: -Dappdynamics.agent.accountName

Environment Variable： APPDYNAMICS_AGENT_ACCOUNT_NAME

Type: ストリング

Default: なし

Required: 

Cisco 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ポートに設定します。詳細については、Controller Port Propertyを参照してください。

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

System Property: -Dappdynamics.controller.ssl.enabled

Environment Variable： APPDYNAMICS_CONTROLLER_SSL_ENABLED

Type：ブール型

Default: False

Required: なし