Agent configuration file settings

Edit online

Configure the Instana host agent behavior by modifying settings in the com.instana.agent.main.config.Agent.cfg file.

The agent configuration file controls core agent functionality including network settings, operational modes, and integration capabilities. You can customize these settings to match your monitoring requirements and infrastructure environment.

File location: <instana-agent-dir>/etc/instana/com.instana.agent.main.config.Agent.cfg

Configuration parameters

backchannel.enabled


Type	Default	Required
Boolean	`true`	No

Allows the agent to react to commands from the Instana UI, such as rebooting the agent or downloading logs from the agent.

http.listen


Type	Default	Required
String	None	No

Sets the network interface IP addresses on which the agent listens for incoming traffic from monitored applications. For more information, see Network reference.

http.threads


Type	Default	Required
Integer	`4`	No

Sets the number of threads that handle incoming HTTP traffic with data from monitored applications.

mode


Type	Default	Required
String	`APM`	No

Sets the agent mode. Possible values are APM, INFRASTRUCTURE, AWS, and OFF.

mode.web-override.allowed


Type	Default	Required
Boolean	`true`	No

Allows the agent mode to be changed from the Instana UI.

scheduler.threads


Type	Default	Required
Integer	`4`	No

Sets the number of threads that are available for various scheduled or asynchronous tasks performed by the agent.

source.download.enabled


Type	Default	Required
Boolean	`true`	No

Allows the agent to upload the source code of monitored processes to the Instana UI so that the source code can be associated with tracing data.

uniqueAgentId


Type	Default	Required
String	None	No

Sets a static agent ID. For more information, see Agent ID conflicts due to identical MAC addresses.

use-cloud-provider-id


Type	Default	Required
Boolean	`false`	No

Instructs the agent to use an ID provided by the cloud provider as the agent ID.

Note:

There are known inconsistencies regarding the default value of use-cloud-provider-id:

If use-cloud-provider-id is not specified, the agent defaults to use-cloud-provider-id = false.
During agent installation, the agent installer creates a default com.instana.agent.main.config.Agent.cfg file with use-cloud-provider-id = true.
The containerized dynamic agent runs with use-cloud-provider-id = true by default, but the containerized static agent runs with use-cloud-provider-id = false by default.