Download PDF
Download page 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 |
[agent:proxy]
ディレクティブ | 説明 | 例 | デフォルト |
---|---|---|---|
| APPDYNAMICS_CURVE_ENABLED |
| off |
| APPDYNAMICS_CURVE_ZAP_ENABLED |
| off |
| APPDYNAMICS_CURVE_PUBLIC_KEY_DIR |
|
|
| APPDYNAMICS_CURVE_SECRET_KEY_DIR |
|
|
| APPDYNAMICS_CURVE_AGENT_PUBLIC_KEY_FILE |
|
|
| APPDYNAMICS_CURVE_AGENT_SECRET_KEY_FILE |
|
|
| APPDYNAMICS_CURVE_PROXY_PUBLIC_KEY_FILE |
|
|
| APPDYNAMICS_CURVE_PROXY_SECRET_KEY_FILE |
|
|
[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 コントローラの構成について説明します。
ディレクティブ | 説明 | 例 | 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 | コントローラ証明書 この証明書はデフォルトのエージェントキーストア( | /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 |
tcp-comm-host | エージェントとプロキシの TCP 通信が行われるホスト | 127.0.0.1 | Default |
|
tcp-comm-port | エージェントとプロキシ間の最初の通信要求が発生するポート | 8080 | なし(None) |
|
tcp-reporting-port | レポートの転送用ポート(エージェント専用プロパティ) | 10010 | なし(None) |
|
tcp-request-port | 要求および設定の転送用ポート(エージェント専用プロパティ) | 10011 | なし(None) |
|
tcp-port-range | エージェントに要求およびレポートポートを割り当てるポート範囲(プロキシ専用プロパティ) | 10000 〜 10100 | なし(None) | APPDYNAMICS_TCP_PORT_RANGE |
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 |
[services:analytics]
ディレクティブ | 説明 | 例 | Default | 環境変数 |
---|---|---|---|---|
host | 分析エージェントのホスト |
|
| |
port | 分析エージェントのポート | 9000 | 9090 | APPDYNAMICS_ANALYTICS_PORT |
ssl | 分析エージェントとの SSL 通信を有効にするには、on に設定します | on | off | APPDYNAMICS_ANALYTICS_SSL_ENABLED |
ca-file | 分析エージェントの証明書に署名した CA の証明書。 証明書は 中間認証局がある場合は、ルート認証局の代わりに信頼チェーンのパスを指定します。 | /tmp/certs/ca-cert.pem | optional |
|