This page describes required and optional environment variables, including HTTP proxy support, and how to input the variables in the AWS Management Console.
The Java Serverless Tracer supports Java 8.
The Node.js Serverless Tracer supports Node.js 10.x, 12.x, 14.x, 16.x, and 18.x.
The Python Serverless Tracer supports Python 3.7, 3.8, and 3.9.
To instrument Serverless APM for AWS Lambda, you must configure the environment variables listed in the table below. Enter all applicable information as key-value environment variables in the AWS Management Console.
When you change an environment variable, any existing instances complete execution using the previous value. All new requests execute with the updated value. |
Environment Variable | Description | Default | Required | Example Value |
|---|---|---|---|---|
APPDYNAMICS_ACCOUNT_NAME | Account name associated with the Controller used by your AWS Lambda function. |
| Yes | customer1 |
APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY | Access key for your Controller. See Agent-to-Controller Connections. | <AppDynamics_account_key> | Yes | AB1a2b3c4$123 |
APPDYNAMICS_APPLICATION_NAME | Name of the application where the tracer is instrumented. | <Your_app_name> | Yes | testApp |
APPDYNAMICS_CONTROLLER_HOST | Host associated with the Controller used by your AWS Lambda function. Do not include http:// or https:// | <Controller_host_name> | Yes | <accountname>.saas.appdynamics.com |
APPDYNAMICS_CONTROLLER_PORT | Port associated with your Controller. | 443 | No | 8080 |
APPDYNAMICS_DISABLE_AGENT | Disables the Serverless Tracer and stops all serverless application monitoring. Accepted values are | false | No | true |
APPDYNAMICS_ENABLE_EUM | Used by the Node.js Serverless Tracer to enable End User Monitoring for AWS Lambda functions. Set to See Integrate the Node.js Serverless Tracer with End User Monitoring for details. | false | No | true |
APPDYNAMICS_EUM_AJAX | When set to true ensures EUM data is always returned in Ajax form. For example, ADRUM_0, ADRUM_1, and so on. | false | No | true |
APPDYNAMICS_HTTP_TIMEOUT_MS | HTTP timeout in milliseconds for the tracer to send data downstream. | 2000 | No | 3000 |
APPDYNAMICS_LOG_LEVEL | Log level for the tracer. Accepted values are | INFO | No | INFO
|
APPDYNAMICS_SERVERLESS_API_ENDPOINT |
| <https://your-endpoint-name-api.saas.appdynamics.com/> | Yes |
|
APPDYNAMICS_TIER_NAME | The name of your AWS Lambda function. |
Defaults to the name of your AWS Lambda function. | No | serverlessTestTier |
To enable HTTP Proxy Support, define the following variables in the AWS Management Console:
| Environment Variable | Description | Example Value |
|---|---|---|
APPDYNAMICS_HTTP_PROXY_HOST | Publicly-accessible hostname of the proxy. | myproxy.example.com |
APPDYNAMICS_HTTP_PROXY_PORT | Port on which the proxy is running. | 8080 |
APPDYNAMICS_HTTP_PROXY_SERVER_CERTIFICATE | Relative path to the proxy server's certificate. Required if your proxy server runs on a self-signed certificate for your AWS Lambda function to trust the proxy. If you have configured your runtime environment to trust your proxy server, you do not need this variable. | resources/proxy-cert.pem |
Additionally, you can add credentials for your proxy server's basic authentication. Add the following variables in the AWS Management Console:
| Environment Variable | Description | Example Value |
|---|---|---|
| Username associated with your basic authentication. | user1 |
| Relative path to the proxy server's basic authentication password. Required for your proxy server's password to trust your AWS Lambda function. | password123 |
| Plaintext file to the proxy server's basic authentication password file. Update your deployment package to contain the proxy server's password file. Required for your proxy server's password to trust your AWS Lambda function. | resources/proxy-password.txt |
When you add basic credentials, you are required to include either |
To add environmental variables through the AWS Management Console:
Amazon Web Services, the AWS logo, AWS, and any other AWS Marks used in these materials are trademarks of Amazon.com, Inc. or its affiliates in the United States and/or other countries.