Configure Smart Agent

You require to configure Smart Agents to register with Controller. Edit the configuration file. For example, if you have downloaded the install files at /opt/appdynamics /opt/appdynamics/appdsmartagent/config.ini.

config.ini

This is an example of a config.ini:

ControllerURL    =
ControllerPort   = 443
FMServicePort  = 8030
AgentType        =
AccountAccessKey =
AccountName      =
EnableSSL      = true
[CommonConfig]
ServiceName           =
ServiceNamespace      =
RequestTimeoutSeconds = 0
AgentName             =
PollingIntervalInSec  =
[OAuth]
OAuthID      =
OAuthSecret  =
AuthEndpoint =
TenantID     =
Scopes       =
[HTTPClientSettings]
Timeout = 0
[TLSClientSetting]
Insecure = false
AgentHTTPProxy  =
AgentHTTPSProxy =
AgentNoProxy    =
[TLSSetting]
CAFile     =
CertFile   =
KeyFile    =
MinVersion = TLS 1.2
MaxVersion = TLS 1.3
[AutoDiscovery]
RunAutoDiscovery = false
AutoInstall = false
ExcludeLabels = process.cpu.usage,process.memory.usage
ExcludeProcesses =
ExcludeUsers =
AutoDiscoveryTimeInterval = 4h
[AnsibleConfig]
ExtraVars = create_appdynamics_user=false,add_ansible_install_env_var=false,check_pkg_dependencies=false,download_script=py
EnvVars = ANSIBLE_STDOUT_CALLBACK=appdynamics.agents.smartagent_callback
Verbose =
[Telemetry]
LogLevel=info
LogFile=
Profiling=false

Basic Configuration

The basic configuration is the required configuration to register Smart Agent with Controller. Ensure that you update the following parameters for the basic Smart Agent configuration:

ControllerURL : The URL of the Controller on which you want to establish the connection with the Smart Agent.
FMServicePort: The port to which the Smart Agent connects to the FM service (Agent Management). It is 8030 for an on-premises Controller and 443 for a SaaS Controller.
AccountAccessKey : The account access key on the Controller.
AccountName
EnableSSL : SSL is enabled by default. To turn off SSL, specify the value as false.

Advanced Configuration

You can use the following configurations as per your requirement. These are not mandatory parameters. You can also include these configurations after Smart Agent installation, but ensure to restart Smart Agent to apply the configuration.

Proxy Configuration

If you require to configure the proxy settings, specify the following fields under the TLSClientSetting section of the config.ini file.


Parameter	Description	Example
AgentHTTPProxy	specify the proxy URL for this parameter when you use an HTTP Controller.	localhost:3128
AgentHTTPSProxy	specify the proxy URL for this parameter when you use an HTTPS Controller.	myhost:8443
AgentNoProxy	specify `true` for this parameter when you do not require to use any proxy for the Smart Agent. The value can be `true` or `false`	false

HTTP proxy example

The following example is for using the HTTP proxy for the Smart Agent:

[TLSClientSetting]
Insecure = false
AgentHTTPProxy  = localhost:3128
AgentHTTPSProxy =
AgentNoProxy    =

TLS Configuration

If you require to configure the TLS certificate, specify the following fields under the TLSSetting config.ini.


Parameter	Description	Example
CAFile	specify the path to the root certificate file.	`<cert file path>/ca.crt`
CertFile	specify the path to the client certificate file.	`<client cert file path>/clients .crt`
KeyFile	specify the path to the client private key of the file.	`<private key file path>/private.key`

Log Level Configuration

You can specify the log level details in the Telemetry section. You can use any of the following log levels:

debug
info
warn
error

Telemetry


Parameters	Description
LogLevel	The logging level such as info.
LogFile	The path to the log file.
Profiling	Specify `true` to enable profiling.

Log level example

The following example is for using the info log level:

[Telemetry]
LogLevel=info
LogFile=
Profiling=false

Documentation