AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.

    Skip to end of metadata
    Go to start of metadata

    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.


    Controller Certificate

    This certfile must be the default agent keystore (found under site-packages/appdynamics_proxysupport/lib/security/cacerts) with necessary additional .pem/.crt certs embedded within it using keytool.



    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