Reverse proxy or load balancer for ActiveGate

A reverse proxy or a load balancer can be placed on the path from an ActiveGate to the Dynatrace Cluster. This allows your ActiveGate to connect to any available node of the Cluster, spreading the load between the nodes.
To do this, you need to:

  • Provide the address of the reverse proxy/load balancer.
  • Ensure that ActiveGate will ignore any further target address information sent from the Dynatrace Cluster, and will thus connect only to the address you have specified.

ActiveGate connecting to Dynatrace Cluster via reverse proxy/load balancer

Option to configure during installation

This configuration—to use a reverse proxy or a load balancer—can also be applied during ActiveGate installation, by specifying installation parameters to the ActiveGate installer for Linux or Windows or it can be configured later, after ActiveGate installation, as shown in the following procedure.

A load balancer should not be placed between ActiveGate and OneAgent, as it can disrupt memory dump transmission and processing.

Configure ActiveGate to use reverse proxy or load balancer

Follow the steps below to specify the reverse proxy address and to ignore connectivity information received from the Dynatrace Cluster:

  1. Stop the ActiveGate and edit the custom.properties file in the ActiveGate configuration directory.

  2. To tell the ActiveGate to ignore connectivity information received from the Dynatrace cluster, add or modify the ignoreClusterRuntimeInfo parameter in the [connectivity] section of the custom.properties file:

    [connectivity]
    ignoreClusterRuntimeInfo = true

  3. Specify the address of the reverse proxy: Add the seedServerUrl parameter in the [collector] section of the custom.properties file in the following format:
    seedServerUrl = https://<REVERSE_PROXY>:<REVERSE_PROXY_PORT>/communication
    For example:

    [collector]
    seedServerUrl = https://my.reverse-proxy.com:443/communication

    Specify multiple addresses:
    The parameter can be a single value or it can be a comma-separated list of target addresses to which the ActiveGate connects.
    For example:

    [collector]
    seedServerUrl = https://my.reverse-proxy-1.com:443/communication,https://my.reverse-proxy-2.com:443/communication

  4. Save the custom.properties file and restart the ActiveGate main service.