Set up a proxy for private synthetic monitoring

ActiveGate version 1.177

  • To set a proxy for communication with the tested resource, edit the custom.properties file and set properties in the [synthetic] section.
  • To set a proxy only for internal communication with Dynatrace server, see Setting up proxy for ActiveGate.
  • To set the same proxy for both a tested resource and Dynatrace server, set properties in the [http.client] section.

You can use the following properties when configuring a proxy for your synthetic-enabled ActiveGate.

Property Default value Description [synthetic] [http.client]
proxy-server unset Proxy server address yes yes
proxy-port unset Proxy port (numeric). Opional. If left empty, the default 8080 port is used yes yes
proxy-user unset Proxy user name (optional) yes yes
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.
yes yes
proxy-off unset Disable proxy communication between ACtiveGate and tested resource yes no
proxy-non-proxy-hosts unset Do not use proxy when communicating with these hosts. To include a number hosts, separate them with the | characters. You can also use an asterisk * to replace any string. For example: proxy-non-proxy-hosts=*gdansk.dynatrace.com|my.corp.org yes no

Have a look at the possible scenarios for your proxy configuration.

I only want to proxy communication to Dynatrace server

See Setting up proxy for ActiveGate.

I want to proxy communication to both, Dynatrace server and the tested resource

[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password

I want to use different proxies for Dynatrace server and the tested resources

To Dynatrace server, see Setting up proxy for ActiveGate.

To the tested resource:

[synthetic]
proxy-server=<proxy between AG and tested resource>
proxy-port=9090
proxy-user=username_two
proxy-password=password_two

I want to proxy communication to the tested resource and/or to Amazon S3

The synthetic-enabled ActiveGate needs an access to the Amazon S3 service to upload and access private browser monitor screenshots.

[synthetic]
proxy-server=<proxy between AG and tested resource>
proxy-port=8080
proxy-user=username
proxy-password=password

I only want to proxy communication for synthetic but connect directly to some other resources

[synthetic]
proxy-server=<proxy between AG and tested resource>
proxy-port=8080
proxy-user=username
proxy-password=password
proxy-non-proxy-hosts=my.corp.org|*.gdansk.dynatrace.com