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
dirAppDynamicsエージェントに関するファイルのベースディレクトリ/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]

ディレクティブ説明デフォルト

curve-enabled

APPDYNAMICS_CURVE_ENABLED

on

off

curve-zap-enabled

APPDYNAMICS_CURVE_ZAP_ENABLED

on

off

curve-public-dir

APPDYNAMICS_CURVE_PUBLIC_KEY_DIR

/tmp/certificates

/tmp/appd/certs/public

curve-secret-dir

APPDYNAMICS_CURVE_SECRET_KEY_DIR

/tmp/secret-certificates

/tmp/appd/certs/secret

curve-agent-public-file

APPDYNAMICS_CURVE_AGENT_PUBLIC_KEY_FILE

/tmp/certs/agent.key

/tmp/appd/certs/public/<node_name>.key

curve-agent-secret-file

APPDYNAMICS_CURVE_AGENT_SECRET_KEY_FILE

/tmp/certs/agent.key_secret

/tmp/appd/certs/secret/<node_name>.key_secret

curve-proxy-public-file

APPDYNAMICS_CURVE_PROXY_PUBLIC_KEY_FILE

/tmp/certs/proxy.key

/tmp/appd/certs/public/proxy.key

curve-proxy-secret-file

APPDYNAMICS_CURVE_PROXY_SECRET_KEY_FILE

/tmp/certs/proxy.key_secret

/tmp/appd/certs/secret/proxy.key_secret

[wsgi]

ディレクティブ説明デフォルト環境変数
scriptWSGIスクリプトファイルへのパス/var/www/acme/bookstore.py適用対象外APPDYNAMICS_WSGI_SCRIPT_ALIAS
callableスクリプト/モジュールで呼出可能なWSGIの名前appapplicationAPPDYNAMICS_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/logsAPPDYNAMICS_LOGS_DIR
levelログを記録するレベル(warning、info、または debug のいずれか)debugwarningAPPDYNAMICS_LOGGING_LEVEL
debuggingOnの場合にDEBUGレベルのログをstderrとログファイルに書き込むonoffAPPDYNAMICS_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 または offonoffAPPDYNAMICS_CONTROLLER_SSL_ENABLED
accountAppDynamics コントローラのアカウントuser1シングルテナント コントローラのデフォルトは customer1
その他の場合必須。
APPDYNAMICS_AGENT_ACCOUNT_NAME
accesskeyAppDynamics コントローラ アカウント アクセス キー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 プロキシを設定します。

ディレクティブ説明デフォルト環境変数
hostHTTPプロキシホストproxy.example.org適用対象外APPDYNAMICS_HTTP_PROXY_HOST
portHTTPプロキシポート809080APPDYNAMICS_HTTP_PROXY_PORT
userHTTPプロキシユーザーproxyuser適用対象外APPDYNAMICS_HTTP_PROXY_USER
password-fileHTTPプロキシパスワードファイル/etc/http-proxy.passwd適用対象外APPDYNAMICS_HTTP_PROXY_PASSWORD_FILE

[proxy]

ディレクティブ

説明

デフォルト

環境変数

max-heap-sizeプロキシの最大ヒープサイズ 450 m300 mAPPDYNAMICS_MAX_HEAP_SIZE
min-heap-sizeプロキシの最小ヒープサイズ 100 m50 mAPPDYNAMICS_MIN_HEAP_SIZE
max-perm-size最大永続世代サイズ 150 m120 mAPPDYNAMICS_MAX_PERM_SIZE
proxy-debug-portJava デバッガを接続するポート番号8092[なし(None)]APPDYNAMICS_PROXY_DEBUG_PORT
start-suspendedJava デバッガでプロキシの起動をデバッグするかどうかを指定します。onoffAPPDYNAMICS_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_AGENTPYTHON_AGENTAPPDYNAMICS_AGENT_TYPE
tcp-comm-hostエージェントとプロキシの TCP 通信が行われるホスト127.0.0.1Default

APPDYNAMICS_TCP_COMM_HOST

tcp-comm-portエージェントとプロキシ間の最初の通信要求が発生するポート8080なし(None)

APPDYNAMICS_TCP_COMM_PORT

tcp-reporting-portレポートの転送用ポート(エージェント専用プロパティ)10010なし(None)

APPDYNAMICS_TCP_REPORTING_PORT

tcp-request-port要求および設定の転送用ポート(エージェント専用プロパティ)10011なし(None)

APPDYNAMICS_TCP_REQUEST_PORT

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_PORTDEBUG_OPT よりも 優先されます。また、自己定義 DEBUG_OPT を使用する場合は、PROXY_DEBUG_PORT が設定されていないことを確認します。 

[eum]

ディレクティブ説明デフォルト環境変数
disable-cookie設定すると、エージェントがUEM相関データをWSGI応答ヘッダーに追加しません。onoffAPPDYNAMICS_EUM_DISABLE_COOKIE
user-agent-whitelist指定すると、EUM 相関データヘッダーとして追加されたユーザエージェントのデフォルトホワイトリストを上書きします。
代替ユーザエージェントをカンマ区切りリストとして指定するには、この設定を使用します。すべてのユーザエージェントを許可するには、「*」を使用します。
'iPad, Android'

'Mozilla, Opera, WebKit, Nokia'

APPDYNAMICS_EUM_USER_AGENT_WHITELIST

[services:snapshot]

ディレクティブ説明デフォルト環境変数
exit-call-details-length
トランザクションスナップショットの終了コールを記述する詳細文字列の文字数を指定。
200100APPDYNAMICS_EXIT_CALL_DETAILS_LENGTH

[services:transaction-monitor]

ディレクティブ説明デフォルト環境変数
bt-max-duration-msビジネストランザクションの最長時間(ミリ秒単位)60000120000APPDYNAMICS_BT_MAX_DURATION_MS

[services:analytics]

ディレクティブ

説明

Default

環境変数

host分析エージェントのホスト

analytics-agent.example.org

localhost

APPDYNAMICS_ANALYTICS_HOSTNAME

port分析エージェントのポート90009090APPDYNAMICS_ANALYTICS_PORT
ssl分析エージェントとの SSL 通信を有効にするには、on に設定しますonoffAPPDYNAMICS_ANALYTICS_SSL_ENABLED
ca-file

分析エージェントの証明書に署名した CA の証明書。

証明書は .pem 形式である必要があります

中間認証局がある場合は、ルート認証局の代わりに信頼チェーンのパスを指定します。

/tmp/certs/ca-cert.pemoptional

APPDYNAMICS_ANALYTICS_CAFILE