This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

This is the complete list of settings and directives for the AppDynamics Python Agent, settable in the AppDynamics configuration file.

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


DirectiveDescriptionExampleDefaultEnvironment Variable
appApp NameMy AppRequiredAPPD_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 debug)debugwarningAPPD_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

8080 for http

443 for https, in which case ssl must also be set

sslIs SSL set be used to talk to the controller? (one of: on, off)onoffAPPD_SSL_ENABLED
accountAppDynamics controller accountuser1For a single-tenant controller defaults to customer1.
Otherwise required.
accesskeyAppDynamics controller account access keyXC6v2n8m2$543Required. To find your account name and access key, click the settings (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 port808080APPD_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.
'Mozilla, Opera, WebKit, Nokia'.'iPad, Android'APPD_EUM_USER_AGENT_WHITELIST


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