Agent configuration options

You can configure multiple options in your agent's config.cfg file. Common options are detailed below.

sd_account

Required. This is your Server Density account name and is required for agent operation. This is also used in your URL to login, so if you login at https://example.serverdensity.io then you need to set sd_account to example. 

agent_key

Required. This is the agent key used to identify the device when payloads are processed. You can find this in the top left corner when you view a device page in your UI.

proxy_host

If a proxy server is needed to gain external network access then you can define the proxy host here. 

proxy_port

If a proxy server is needed to gain external network access then you can define the proxy port here. 

proxy_user

If a proxy is defined and it requires authentication, enter the user here.

proxy_password

If a proxy is defined and it requires authentication, enter the password here. 

proxy_forbid_method_switch

If your proxy will return a 302 that will make curl switch from a POST to a GET request then you should enable this option and set it to yes. 

hostname

Use this option to force the hostname to your desired text

plugin_directory

If you require custom plugins use this option to tell the agent where your plugins are stored. Leave blank to ignore

log_level

Allows you to define the log level you wish the agent to log with, more info can be found here

collector_log_file

This option can be used to define the collector log file location. By default this is commented out but is set to '/var/log/sd-agent/collector.log' which is the default log location and will be used if no location is set or this option remains commented out.

forwarder_log_file

This option can be used to define the forwarder log file location. By default this is commented out but is set to '/var/log/sd-agent/forwarder.log' which is the default log location and will be used if no location is set or this option remains commented out.

log_to_syslog

Used to define if the agent also logs to the syslog. By default this is yes. Set to no if you do not wish to log to the syslog. If syslog is enabled but a host and port are not set, a local domain socket connection will be attempted.

syslog_host

If syslog is enabled you can define a remote syslog host here.

syslog_port

If syslog is enabled you can define a remote syslog port here.

listen_port

Used to define a port for the forwarder. Useful if you already have a service listening on port 17124 (The port used by default).

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Monday  —  Friday.

10am  —  6pm UK.

Dedicated Support.