On this page:

Your Rating:
18 rates

You can configure operating settings for the Python Agent using a configuration file or by setting environment variables in the application environment. This topic lists the Python Agent settings. 

See 'Configure the Agent' in Install the Python Agent for information about the configuration file.


DirectiveDescriptionExampleDefaultEnvironment Variable
appApp NameMyAppRequiredAPPD_APP_NAME
tierTier Nameweb-feRequiredAPPD_TIER_NAME
nodeNode Nameweb-fe1RequiredAPPD_NODE_NAME
dirBase directory for files related to the AppDynamics agent/mysite/appd/agent/python//tmp/appd/APPD_DIR


DirectiveDescriptionExampleDefaultEnvironment Variable
scriptPath to WSGI script file/var/www/acme/bookstore.pyn/aAPPD_WSGI_SCRIPT_ALIAS
callableName of WSGI callable in script/moduleappapplicationAPPD_WSGI_CALLABLE_OBJECT
moduleFully-qualified name of app moduleacme.bookstore:appn/aAPPD_WSGI_MODULE

If both the script and module directives are specified, the module directive takes precedence.

The module value may be the fully-qualified name of a module, or it may be the fully-qualified name of a module followed by a colon and the name of the WSGI callable in that module. In the latter form, the module directive overrides the callable directive.

Both the long-form of the module directive and the callable directive may take either the name of a symbol, or the name of a symbol followed by an empty pair of parentheses. In the latter form, the callable is taken to be the result of calling the callable specified by the directive. This latter form can be used with Django; for example:

module = django.core.handlers.wsgi:WSGIHandler()


DirectiveDescriptionExampleDefaultEnvironment Variable
dirThe directory to write proxy and agent logs to/var/log/appdynamics/tmp/appd/logsAPPD_LOGS_DIR
levelThe level to log at one of: warning, info, or debugdebugwarningAPPD_LOGGING_LEVEL
debuggingOn to write DEBUG level logs to stderr and log filesonoffAPPD_DEBUG_LOG


This section specifies configuration for the AppDynamics controller.

DirectiveDescriptionExampleDefaultEnvironment Variable
hostController hostmycontroller.example.orgRequiredAPPD_CONTROLLER_HOST
portController port9000

8090 for HTTP on-prem

443 for HTTPS, in which case SSL must also be set

sslIs SSL set be used to talk to the controller? on or offonoffAPPD_SSL_ENABLED
accountAppDynamics controller accountuser1For a single-tenant controller defaults to customer1.
Otherwise required.
accesskeyAppDynamics controller account access keyXC6v2n8m2$543

Required. To find your account name and access key, click the gear () icon in the upper right corner of the AppDynamics UI, then click License.



If you need to use an HTTP proxy to talk to your controller, use this section to configure the HTTP proxy.

DirectiveDescriptionExampleDefaultEnvironment Variable
hostHTTP proxy hostproxy.example.orgn/aAPPD_HTTP_PROXY_HOST
portHTTP proxy port809080APPD_HTTP_PROXY_PORT
userHTTP proxy userproxyusern/aAPPD_HTTP_PROXY_USER
password-fileHTTP proxy password file/etc/http-proxy.passwdn/aAPPD_HTTP_PROXY_PASSWORD_FILE


DirectiveDescriptionExampleDefaultEnvironment Variable
disable-cookieIf set, the agent does not add EUM correlation data to WSGI response headers.onoffAPPD_EUM_DISABLE_COOKIE
user-agent-whitelistIf specified overwrites the default whitelist for user agent added as EUM correlation data headers
Use this setting to specify alternate user agents as a comma separated list. Use '*' to allow all user agents.
'iPad, Android'

'Mozilla, Opera, WebKit, Nokia'



DirectiveDescriptionExampleDefaultEnvironment Variable
Specifies the number of characters in the details string describing exit calls in transaction snapshots.


DirectiveDescriptionExampleDefaultEnvironment Variable
bt-max-duration-msMaximum duration of a business transaction in milliseconds60000120000BT_MAX_DURATION_MS