Configure ActiveGate

Whenever you need to configure an ActiveGate setting (for example, proxy, port, or memory dumps), do this in the custom.properties file and then restart ActiveGate. Where can I find ActiveGate files?

Only if you use the custom.properties file will your settings be preserved when upgrading to a new version of ActiveGate. If you want, for example, to disable AWS monitoring on a given ActiveGate, you need to add the following content to the custom.properties file of this ActiveGate.

[collector]
ActiveGate version 1.159 or earlier AWSAgentEnabled=false
ActiveGate version 1.161 or later aws_monitoring_enabled = false

The ActiveGate properties that you can configure are described in the following tables. These properties are applicable for both Environment ActiveGates and Cluster ActiveGates.

Section: [connectivity]

Property	Default value	Description
dnsEntryPoint	unset	Define the entry point for the ActiveGate (for example, http://sg1.mydomain.com:9999). Via this URL, the ActiveGate is accessed by Dynatrace OneAgent. If not set, an auto-detected endpoint will be used. This entry can be used if the ActiveGate is accessed via, for example, an external IP address or load balancer.

Section: [com.compuware.apm.webserver]

Property	Default value	Description
port-ssl	9999	The port where the ActiveGate listens for traffic from OneAgent—used for HTTPS connection.
port	unset	The port where the ActiveGate listens for traffic from OneAgent—used for HTTP connection. It is disabled by default. On Linux, a value > 1024 is recommended, to ensure no root privileges are required.
ssl-protocols	TLSv1.2	Supported SSL protocols. Can be one or a list of the following values: TLSv1, TLSv1.1, TLSv1.2
excluded-ciphers	unset	List of additionally excluded ciphers (ciphers are defined by a substring matching at least a part of the cipher name, for example _DHE_)

Section: [http.client]

For details on proper use of [http.client] properties, see Setting up proxy for ActiveGate.

Property	Default value	Description
proxy-server	unset	Proxy server address
proxy-port	unset	Proxy port (numeric)
proxy-scheme	unset	Proxy scheme (http or https)
proxy-user	unset	Proxy user name (optional)
proxy-password	unset	Proxy password (optional). The password provided in the proxy-password property is obfuscated following ActiveGate restart and the obfuscated password is stored in the proxy-password-encr property.

Section: [collector]

Property	Default value	Description
MSGrouter	true	ActiveGate enables routing of OneAgent and other ActiveGate traffic through Dynatrace.
VMwareAgentEnabled	Environment ActiveGate: true; Cluster ActiveGate: true	ActiveGate can be used to monitor VMware. The value of this property isn't respected by Environment ActiveGate, which can be used to monitor VMware.
ActiveGate version 1.159 or earlier AWSAgentEnabled ActiveGate version 1.161 or later aws_monitoring_enabled	Environment ActiveGate: false; Cluster ActiveGate: true	Forces this ActiveGate to ignore dynatrace agent traffic. This setting is required to retrieve CloudTrail logs that are stored in AWS S3 buckets.
LogDiskBufferPath	/tmp/diskbuffer	Local path for log buffer. The property default may be different depending on the operating system.
restInterface	true	ActiveGate can be used to access the Dynatrace REST API. To use your ActiveGate to make API calls with this feature, the URL must follow this pattern: https://<GATEWAY>/e/<ENVIRONMENT>/api/v1/time
ActiveGate version 1.149 or earlier enableHttpChecks	false	HTTP Monitors in ActiveGate. For later releases, see ActiveGate configuration for HTTP monitors
DumpSupported	false	ActiveGate allows you to temporarily store memory dumps from OneAgent. Additional configuration in section [dump] is required.

Section: [dump]

Property	Default value	Description
dumpDir	dump	Valid path of the storage directory used for dump storage
maxSizeGb	100	Storage quota in GBs. If full, the oldest dumps are overwritten until enough space is available to store a new dump.
maxAgeDays	7	Maximum age of a memory dump in days until the dump is automatically overwritten
maxConcurrentUploads	5	Maximum number of concurrent dump uploads from OneAgents
downloadUrl	unset	A custom download URL (for example, if ActiveGate is behind a load balancer or if ActiveGate only detected an IP address but the customer wishes to have a FQDN). The URL must contain the correct schema and port.