Environment variables

The following environment variables are valid for all agents (both host and containerized).

Environment variable	Required	Default value	Description
JAVA_OPTS	No	None	Additional Java® virtual machine configurations that you might want to pass to the startup of the host agent. For example, you might use-Xms<value> and-Xmx<value> to set the minimum and maximum amount of heap available to the agent, respectively.
ENABLE_AGENT_SOCKET	No	true	The variable to determine the Instana agent's communication direction with JVMs. To allow communication to be directed to the agent, set this variable totrue. To direct communication to the JVM, set this variable tofalse.
INSTANA_AGENT_MAX_MEM	No	None	Sets the maximum amount of memory available to the agent. By default, the memory limit is automatically determined based on container resource limits.INSTANA_AGENT_MAX_MEM is ignored ifINSTANA_AGENT_USE_MEMORY_CALCULATOR is set tofalse.
INSTANA_AGENT_TLS_1_0	No	false	Enable TLS v1.0.
INSTANA_AGENT_TLS_1_1	No	false	Enable TLS v1.1.
INSTANA_AGENT_USE_MEMORY_CALCULATOR	No	true	Controls whether the agent attempts to use its built-in memory calculator to automatically determine memory limits for the agent.
INSTANA_JVM_BYTEBUDDY_ATTACHMENT_ENABLED	No	true	This variable enables or disables JVM attachment by using byte buddy.
INSTANA_JVM_HANDLING_REQUIRE_ATTACH_FILES	No	false	Controls whether the agent attaches only to JVMs with valid attach files. Set totrue to prevent attaching to non-Java processes that the agent might misidentify as JVMs during process transitions. The default value isfalse to maintain existing attachment behavior.
INSTANA_AGENT_OTEL_GRPC	No	false	Enable OTEL GRPC-server.
INSTANA_AGENT_OTEL_HTTP	No	false	Enable OTEL HTTP-server.
INSTANA_AGENT_OTEL_GRPC_PORT	No	4317	Override OTEL GRPC-port number.
INSTANA_AGENT_OTEL_HTTP_PORT	No	4318	Override OTEL HTTP-port number.
INSTANA_AGENT_OTEL_GRPC_LEGACY_PORT_ENABLED	No	true for agent versions earlier than 1.310.0 false for agent versions 1.310.0 and later	Enable or disable the legacy OTLP gRPC port (55680).
INSTANA_APPEND_FQDN_TO_AGENT_ID	No	false	Appends hostname to agent ID to ensure uniqueness across identical hosts. For more information, see Agent ID conflicts due to identical MAC addresses
IN_MEMORY_CLASSLOADER	No	false	Uses thein-memory-classloader for loading JVM Java agents inside containers, instead of file-based JARs. When enabled, the required free storage is reduced to 3.5 MB, but at the cost of additional heap consumption.
INSTANA_GIT_REMOTE_REPOSITORY	No	None	Git remote URL to be used by the agent for Git-based configuration management. The variable must be set ifINSTANA_GIT_REMOTE_BRANCH is set.
INSTANA_GIT_REMOTE_BRANCH	No	None	Git remote branch to be tracked by the agent for Git-based configuration management. The variable must be set ifINSTANA_GIT_REMOTE_REPOSITORY is set.
INSTANA_GIT_REMOTE_USERNAME	No	None	Optional: The username or access token to be used in basic authentication for Git operations.
INSTANA_GIT_REMOTE_PASSWORD	No	None	Optional: The password to be used in basic authentication for Git operations.
INSTANA_AGENT_UPDATES_VERSION	No	None	Pins the sensor versions to a specific SHA. Starting with Agent Bootstrap1.2.49, this environment variable can also be used to set the agent version.

The following environment variables are specific to the containerized agent.

Environment variable	Required	Default value	Description
INSTANA_AGENT_BACKCHANNEL_ENABLED	No	None	Allows the agent to process the commands from the Instana UI, such as rebooting the agent or downloading logs from the agent.
INSTANA_AGENT_HTTP_LISTEN	No	None	Sets the network interface IP addresses on which the agent listens for incoming traffic from monitored applications. For more information, seeNetwork reference.
INSTANA_AGENT_HTTP_THREADS	No	None	Sets the number of threads that handle incoming HTTP traffic with data from monitored applications.
INSTANA_LOG_LEVEL	Yes	INFO	Controls the log level of com.instana packages. Possible values:INFO,DEBUG,TRACE,WARN,ERROR, orOFF.
INSTANA_ROOT_LOGGER_LOG_LEVEL	No	INFO	Controls the log level of all other packages that are not covered byINSTANA_LOG_LEVEL. Possible values:INFO,DEBUG,TRACE,WARN,ERROR, orOFF.
INSTANA_ROOT_LOGGER_CONSOLE_APPENDER_LOG_LEVEL	No	INFO	Defines the log level that is printed to the console (stdout) and collected by the container logging. Possible values:INFO,DEBUG,TRACE,WARN,ERROR, orOFF.
INSTANA_AGENT_KEY	Yes	None	Your Instanaagent key.
INSTANA_AGENT_ENDPOINT	No	None	The host agent endpoint.
INSTANA_AGENT_ENDPOINT_PORT	No	None	The host agent endpointport.
INSTANA_AGENT_ZONE	No	None	The zone to place the host agent.
INSTANA_AGENT_TAGS	No	None	Comma-separated list of tags that are associated with the host that runs the agent, such asmy_tag=myvalue,my_other_tag.
INSTANA_AGENT_MAX_MEM	No	None	Sets the maximum amount of memory available to the agent. By default, the memory limit is automatically determined based on container resource limits.INSTANA_AGENT_MAX_MEM is ignored ifINSTANA_AGENT_USE_MEMORY_CALCULATOR is set tofalse.
INSTANA_AGENT_MODE	No	APM	The agent mode. Available values areAPM,INFRASTRUCTURE,AWS, orOFF.
INSTANA_DOWNLOAD_KEY	No	None	YourInstana download key.
INSTANA_AGENT_MODE_WEB_OVERRIDE_ALLOWED	No	None	Allows you to change the agent mode from the Instana UI.
INSTANA_AGENT_SCHEDULER_THREADS	No	None	Sets the number of threads that are available for various scheduled or asynchronous tasks performed by the agent.
INSTANA_AGENT_SOURCE_DOWNLOAD_ENABLED	No	None	Allows the agent to upload the source code of monitored processes to Instana so that the source code can be associated with tracing data.
INSTANA_AGENT_UNIQUE_AGENT_ID	No	None	Sets a static agent ID. For more information, seeAgent ID conflicts due to identical MAC addresses.
INSTANA_AGENT_USE_CLOUD_PROVIDER_ID	No	None	Instructs the agent to use the cloud provider ID as the agent ID.
INSTANA_AGENT_USE_MEMORY_CALCULATOR	No	None	Controls whether the agent attempts to use its built-in memory calculator to automatically determine memory limits for the agent.
INSTANA_AGENT_UPDATES_FREQUENCY	No	DAY	Controls the frequency at which sensor updates are fetched. For more information, see Updates and version pinning.
INSTANA_AGENT_UPDATES_TIME	No	04:30	Controls the time at which sensor updates are fetched. For more information, see Updates and version pinning.
INSTANA_AGENT_PROXY_HOST	No	None	The hostname/address of a proxy.
INSTANA_AGENT_PROXY_PORT	No	None	The port of a proxy.
INSTANA_AGENT_PROXY_PROTOCOL	No	None	The proxy protocol, such ashttp.
INSTANA_AGENT_PROXY_USER	No	None	The username of the proxy auth.
INSTANA_AGENT_PROXY_PASSWORD	No	None	The password of the proxy auth.
INSTANA_AGENT_PROXY_USE_DNS	No	false	Boolean if the proxy also uses DNS.
INSTANA_REPOSITORY_PROXY_ENABLED	No	None	Enables overriding proxy settings specifically for sensor updates.
INSTANA_REPOSITORY_PROXY_HOST	No	None	The hostname/address of a proxy for the Maven sensors repository.
INSTANA_REPOSITORY_PROXY_PORT	No	None	The port of a proxy for the Maven sensors repository.
INSTANA_REPOSITORY_PROXY_PROTOCOL	No	None	The proxy protocol for the Maven sensors repository.
INSTANA_REPOSITORY_PROXY_USER	No	None	The username of the proxy auth for the Maven sensors repository.
INSTANA_REPOSITORY_PROXY_PASSWORD	No	None	The password of the proxy auth for the Maven sensors repository.
INSTANA_MVN_REPOSITORY_URL	No	None	The host name of the Maven repository for dynamic agent and sensor bundle downloads. For more information, see Configuring agent repository mirror.
INSTANA_MVN_REPOSITORY_FEATURES_PATH	No	None	The Maven repository path for feature updates. This is a legacy feature. For more information, see Configuring agent repository mirror.
INSTANA_MVN_REPOSITORY_SHARED_PATH	No	None	The Maven repository path for dynamic agent and sensor bundle updates. For more information, see Configuring agent repository mirror.
AGENT_RELEASE_REPOSITORY_MIRROR_URL	No	None	The URL of the agent release repository mirror. This is a legacy feature. For more information, see Configuring the agent repository as the mirror.
AGENT_RELEASE_REPOSITORY_MIRROR_USERNAME	No	None	The username to access the agent release repository mirror. This is a legacy feature. For more information, see Configuring the agent repository as the mirror.
AGENT_RELEASE_REPOSITORY_MIRROR_PASSWORD	No	None	The password to access the agent release repository mirror. This is a legacy feature. For more information, see Configuring the agent repository as the mirror.
INSTANA_SHARED_REPOSITORY_MIRROR_URL	No	None	The URL of the shared repository mirror. For more information, see Configuring the agent repository as the mirror.
INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME	No	None	The username to access the shared repository mirror. For more information, see Configuring the agent repository as the mirror.
INSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD	No	None	The password to access the shared repository mirror. For more information, see Configuring the agent repository as the mirror.

For more information, see the agent configuration docs and agent git-based configuration docs.

Environment Variable	Value	Description
INSTANA_ENDPOINT_URL	String	The Instana backend endpoint that your serverless agents connect to. It depends on your region and is different from the host agent backend endpoint. It starts withhttps://serverless-.
INSTANA_AGENT_KEY	String	Your InstanaAgent key. The same agent key can be used for host agents and serverless monitoring.
INSTANA_TIMEOUT	Integer	Timeout in milliseconds for the HTTP requests reporting data to the Instana backend.
INSTANA_ENDPOINT_PROXY	URL	Set this variable tohttp://my-proxy.tld orhttp://user:password@my-proxy.tld to route the reporting of data to the Instana backend over an HTTP(S) proxy.
INSTANA_EXTRA_HTTP_HEADERS	String, semicolon-separated	Semicolon-separated list of HTTP headers to be captured.
INSTANA_SERVICE_NAME	String	Custom service name.
INSTANA_LOG_LEVEL	debug,info,warn, orerror	The log level for the Instana package. By default it'sinfo.
INSTANA_LOG_SPANS	true orfalse	Set this variable totrue to have the spans that are generated by the Instana instrumentation, which is dumped to standard out. This setting is useful to debug SDK and automatic instrumentation issues.
INSTANA_DEBUG	String	Set this variable to any value to set the log level todebug.
INSTANA_DISABLE_CA_CHECK	true orfalse	Set this variable totrue to disable verifying the server certificate against the list of CAs baked into the Lambda runtime when it connects to the Instana backend. Enabling this feature makes your lambda vulnerable to MITM attacks for this connection. Use this setting only if you use Instana self-hosted and are unable to operate the Instana backend with a certificate with a known root CA.
INSTANA_SECRETS	String	The value must be structured as follows,<matcher>:<secret>[,<secret>], for example:contains-ignore-case:key,password,secret. See the Secrets documentation for details of the matchers.
INSTANA_TAGS	String, comma-separated	A list of tags, which are comma-separated, and associated with the monitored component, for examplemy_tag=myvalue,my_other_tag.
INSTANA_ZONE	String	The zone to place this monitored component into.
INSTANA_DISABLE_USE_OPENTELEMETRY	true orfalse	Set this variable totrue to disable opentelemetry integration. The default value isfalse.
INSTANA_STACK_TRACE	all,error, ornone	Set this variable toerror to capture stack traces only for erroneous spans or tonone to disable stack trace capturing. The default value isall.
INSTANA_STACK_TRACE_LENGTH	Integer	Set this variable to limit the number of captured stack trace frames in a span.

The Dynamic Language Sensors offered by Instana respect a common set of environment variables. The following table describes this common set.

For more information on Java, Scala, .NET, .NET Core, or PHP, see the corresponding documentation pages.

Environment Variable	Value	Description
INSTANA_AGENT_HOST	IP address or DNS name	Allows users to manually specify location of the Instana host agent.
INSTANA_AGENT_PORT	Port number	Manually specify the port of the Instana host agent.
INSTANA_DISABLE_AUTO_INSTR	true orfalse	Disables automatic instrumentation.
INSTANA_SERVICE_NAME	String	Sets the application-wide service name.
INSTANA_PROCESS_NAME	String	Sets a custom label for the infrastructure entity that represents that runtime. [1]
INSTANA_DEBUG	Any value	Enables debug logging. Use it only for a limited time to avoid overhead and log spamming.
INSTANA_DISABLE_USE_OPENTELEMETRY	true orfalse	Set this variable totrue to disable opentelemetry integration. The default value isfalse.
INSTANA_STACK_TRACE	all,error, ornone	Set this variable toerror to capture stack traces only for erroneous spans or tonone to disable stack trace capturing. The default value isall.
INSTANA_STACK_TRACE_LENGTH	Integer	Set this variable to limit the number of captured stack trace frames in a span.

For information on Java, Scala, .NET, .NET Core, or PHP, see the corresponding documentation pages.

Language	Crystal	Go	Haskell	NGINX	Node.js	PHP	Python	Ruby	.NET Core	.NET
INSTANA_AGENT_HOST	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_AGENT_PORT	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_DISABLE_AUTO_INSTR	N/A	N/A	N/A	N/A	✅	❌	✅	✅	❌	❌
INSTANA_SERVICE_NAME	❌	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_PROCESS_NAME	✅	✅	✅	✅	✅	✅	✅	✅	❌	❌
INSTANA_DEBUG	✅	✅	❌	✅	✅	✅	✅	✅	✅	✅
INSTANA_DISABLE_USE_OPENTELEMETRY	❌	❌	❌	❌	✅	❌	❌	❌	❌	❌
INSTANA_STACK_TRACE	❌	❌	❌	❌	✅	❌	✅	✅	❌	❌
INSTANA_STACK_TRACE_LENGTH	❌	❌	❌	❌	✅	✅	✅	✅	❌	❌