Download PDF
Download page Pythonエージェント設定.
Pythonエージェント設定
Python エージェントの動作設定は、構成ファイルを使用するか、アプリケーション環境内に環境変数を設定して構成します。このトピックでは、Python エージェントの設定を示します。
構成ファイルについては、「Pythonエージェントのインストール」の「エージェントの構成」を参照してください。
環境変数の古いバージョンは下位互換性があり、廃止されていますが、将来のリリースで最終的に削除されます。環境変数を最新バージョンに更新する必要があります。
新しい環境変数は、両方が環境に設定されている場合に、廃止された変数よりも優先されます(たとえば両方が設定されている場合、APPDYNAMICS_AGENT_APPLICATION_NAME
は廃止された APPD_APP_NAME
よりも優先されます)。
[agent]
ディレクティブ | 説明 | 例 | デフォルト | 環境変数 |
---|---|---|---|---|
app | アプリケーション名 | MyApp | 必須 | APPDYNAMICS_AGENT_APPLICATION_NAME |
tier | ティア名 | web-fe | 必須 | APPDYNAMICS_AGENT_TIER_NAME |
node | ノード名 | web-fe1 | 必須 | APPDYNAMICS_AGENT_NODE_NAME |
dir | AppDynamicsエージェントに関するファイルのベースディレクトリ | /mysite/appd/agent/python/ | /tmp/appd/ | APPDYNAMICS_AGENT_BASE_DIR |
nodereuse | ノード名を再利用 | true または false | オプション | APPDYNAMICS_AGENT_REUSE_NODE_NAME |
nodereuseprefix | ノード名プレフィックスを再利用 | My Node Name | オプション | APPDYNAMICS_AGENT_REUSE_NODE_NAME_PREFIX |
uniquehostid | アプリケーション エージェントの一意のホスト ID | オプション | APPDYNAMICS_AGENT_UNIQUE_HOST_ID |
[wsgi]
ディレクティブ | 説明 | 例 | デフォルト | 環境変数 |
---|---|---|---|---|
script | WSGIスクリプトファイルへのパス | /var/www/acme/bookstore.py | 適用対象外 | APPDYNAMICS_WSGI_SCRIPT_ALIAS |
callable | スクリプト/モジュールで呼出可能なWSGIの名前 | app | application | APPDYNAMICS_WSGI_CALLABLE_OBJECT |
module | アプリケーションモジュールの完全修飾名 | acme.bookstore:app | 適用対象外 | APPDYNAMICS_WSGI_MODULE |
script
および module
ディレクティブが両方とも指定されている場合は、module
ディレクティブが優先されます。
module
値は、モジュールの完全修飾名や、その後にモジュールで呼び出しできる WSGI の名前をコロンでつなげたものにすることが可能です。後者の形式では、module
ディレクティブが callable
ディレクティブよりも優先されます。
module
ディレクティブの詳細形式と callable
ディレクティブでは両方ともシンボル名またはシンボル名の後に空の括弧ペアを付けたものを指定できます。後者の形式では、callable はディレクティブで指定した callable をコールした結果と解釈されます。この後者の形式は、Django で使用できます。例:
module = django.core.handlers.wsgi:WSGIHandler()
[log]
ディレクティブ | 説明 | 例 | デフォルト | 環境変数 |
---|---|---|---|---|
dir | プロキシとエージェントのログを書き込むディレクトリ | /var/log/appdynamics | /tmp/appd/logs | APPDYNAMICS_LOGS_DIR |
level | ログを記録するレベル(warning、info、または debug のいずれか) | debug | warning | APPDYNAMICS_LOGGING_LEVEL |
debugging | Onの場合にDEBUGレベルのログをstderrとログファイルに書き込む | on | off | APPDYNAMICS_DEBUG_LOG |
[controller]
このセクションでは、AppDynamicsコントローラの構成について説明します。
ディレクティブ | 説明(Description) | 例 | Default | 環境変数 |
---|---|---|---|---|
host | コントローラホスト | mycontroller.example.org | 必須 | APPDYNAMICS_CONTROLLER_HOST_NAME |
port | コントローラポート | 9000 | 8090(HTTP オンプレミス) HTTPS では 443、この場合 SSL の設定が必要 | APPDYNAMICS_CONTROLLER_PORT |
ssl | コントローラと通信する場合に SSL を使用するかどうか、on または off | on | off | APPDYNAMICS_CONTROLLER_SSL_ENABLED |
account | AppDynamicsコントローラアカウント | user1 | シングルテナント コントローラのデフォルトは customer1 。その他の場合必須。 | APPDYNAMICS_AGENT_ACCOUNT_NAME |
accesskey | AppDynamicsコントローラアカウントアクセスキー | XC6v2n8m2$543 | 必須。 アカウント名とアクセスキーを調べるには、AppDynamics UI の右上にある歯車()アイコンをクリックして、[License] をクリックします。 | APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY |
certfile | コントローラ証明書 この証明書はデフォルトのエージェントキーストア(site-packages/appdynamics_proxysupport/lib/security/cacerts の下にあります)であり、必要に応じて pem/.crt 証明書を keytool を使用して組み込みます。 | /tmp/ssl/cacerts | オプション | APPDYNAMICS_CONTROLLER_SSL_CERTFILE |
[controller:http-proxy]
HTTPプロキシを使用してコントローラと通信する必要がある場合は、このセクションを使用してHTTPプロキシを設定します。
ディレクティブ | 説明 | 例 | デフォルト | 環境変数 |
---|---|---|---|---|
host | HTTPプロキシホスト | proxy.example.org | 適用対象外 | APPDYNAMICS_HTTP_PROXY_HOST |
port | HTTPプロキシポート | 8090 | 80 | APPDYNAMICS_HTTP_PROXY_PORT |
user | HTTPプロキシユーザー | proxyuser | 適用対象外 | APPDYNAMICS_HTTP_PROXY_USER |
password-file | HTTPプロキシパスワードファイル | /etc/http-proxy.passwd | 適用対象外 | APPDYNAMICS_HTTP_PROXY_PASSWORD_FILE |
[proxy]
ディレクティブ | 説明 | 例 | デフォルト | 環境変数 |
---|---|---|---|---|
max-heap-size | プロキシの最大ヒープサイズ | 450 m | 300 m | APPDYNAMICS_MAX_HEAP_SIZE |
min-heap-size | プロキシの最小ヒープサイズ | 100 m | 50 m | APPDYNAMICS_MIN_HEAP_SIZE |
max-perm-size | 最大永続世代サイズ | 150 m | 120 m | APPDYNAMICS_MAX_PERM_SIZE |
proxy-debug-port | Java デバッガを接続するポート番号 | 8092 | [なし(None)] | APPDYNAMICS_PROXY_DEBUG_PORT |
start-suspended | Java デバッガでプロキシの起動をデバッグするかどうかを指定します。 | on | off | APPDYNAMICS_START_SUSPENDED |
debug-opt | デバッグのデバッグオプションを指定します。 | -agentlib:jdwp = transport = dt_ソケット、サーバ= y、suspend = n、 address = 8090 | [なし(None)] | APPDYNAMICS_DEBUG_OPT |
agent | エージェントタイプを指定します(PYTHON_APP_AGENT、NODEJS_APP_AGENT など)。 | NODEJS_APP_AGENT | PYTHON_AGENT | APPDYNAMICS_AGENT_TYPE |
PROXY_DEBUG_PORT
が定義されている場合、-agentlib:jdwp=transport=dt_socket,server=y,suspend=${START_SUSPENDED},address=${PROXY_DEBUG_PORT}
はデバッグオプションとして使用されます。両方が指定されている場合は、PROXY_DEBUG_PORT
が DEBUG_OPT
よりも 優先されます。また、自己定義 DEBUG_OPT
を使用する場合は、PROXY_DEBUG_PORT
が設定されていないことを確認します。
[eum]
ディレクティブ | 説明 | 例 | デフォルト | 環境変数 |
---|---|---|---|---|
disable-cookie | 設定すると、エージェントがUEM相関データをWSGI応答ヘッダーに追加しません。 | on | off | APPDYNAMICS_EUM_DISABLE_COOKIE |
user-agent-whitelist | 指定すると、EUM 相関データヘッダーとして追加されたユーザエージェントのデフォルトホワイトリストを上書きします。 代替ユーザエージェントをカンマ区切りリストとして指定するには、この設定を使用します。すべてのユーザエージェントを許可するには、「*」を使用します。 | 'iPad, Android' |
| APPDYNAMICS_EUM_USER_AGENT_WHITELIST |
[services:snapshot]
ディレクティブ | 説明 | 例 | デフォルト | 環境変数 |
---|---|---|---|---|
exit-call-details-length | トランザクションスナップショットの終了コールを記述する詳細文字列の文字数を指定。 | 200 | 100 | APPDYNAMICS_EXIT_CALL_DETAILS_LENGTH |
[services:transaction-monitor]
ディレクティブ | 説明 | 例 | デフォルト | 環境変数 |
---|---|---|---|---|
bt-max-duration-ms | ビジネストランザクションの最長時間(ミリ秒単位) | 60000 | 120000 | APPDYNAMICS_BT_MAX_DURATION_MS |