Set up a proxy for private synthetic monitoring
You can incorporate proxies, load balancers, and reverse proxies in your Dynatrace deployment. In particular, your ActiveGate configuration allows you to define one or more proxies for outgoing connections.
- To set up a proxy for communication with the tested resource, edit the
custom.properties
file and set properties in the[synthetic]
section. - To set up a proxy only for internal communication with the Dynatrace Cluster, see settings for Dynatrace Cluster communication only.
- To set up the same proxy for both a tested resource and the Dynatrace Cluster, set properties in the
[http.client]
section.
Proxy configuration properties
You can use the following properties when configuring a proxy for your Synthetic-enabled ActiveGate.
Property | Description |
---|---|
| Server address (hostname or IP address) |
| Port optional If left empty, the default |
| User name optional |
| User domain in the case of NTLM authentication |
| Password optional The password provided in the If a comma ( |
| If set to |
| A list of hosts for communication with which proxy should not be used by ActiveGate The hosts in the list should be separated by |
| ActiveGate version 1.271+ A list of proxy authentication schemes optional This is a prioritized list of proxy authentication schemes that ActiveGate should use when authenticating with the proxy server.
Supported values: |
Proxy connection scenarios
These are the possible scenarios for your proxy configuration.
Connection to the Dynatrace Cluster
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password
[synthetic]
proxy-off=true
Connection to both the Dynatrace Cluster and tested resource
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password
Different proxies for connection to the Dynatrace Cluster and tested resources
To the Dynatrace Cluster
[http.client]
proxy-server=<proxy>
proxy-port=8080
proxy-user=username
proxy-password=password
To the tested resource
[synthetic]
proxy-server=<proxy between AG and tested resource>
proxy-port=9090
proxy-user=username_two
proxy-password=password_two
Connection to the tested resource and/or Amazon S3
The Synthetic-enabled ActiveGate needs access to the Amazon S3 service to upload and access screenshots for browser monitors on private locations.
For new Dynatrace Managed version 1.216+ installations, screenshots are stored and served locally from the Dynatrace Cluster. For other Managed offline deployments, you will not be able to save screenshots.
[synthetic]
proxy-server=<proxy between AG and tested resource>
proxy-port=8080
proxy-user=username
proxy-password=password
See also Proxy Auto-Configuration (PAC) files.
Only for synthetic monitoring with direct connection to 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
Proxy Auto-Configuration (PAC) files
You can use Proxy Auto-Configuration (PAC) files to handle complex proxy configuration for private browser monitors.
What is a PAC file?
A Proxy Auto-Configuration (PAC) file is a JavaScript function that determines whether web browser requests (HTTP, HTTPS, and FTP) go directly to the destination or are forwarded to a web proxy server (from developer.mozilla.org).
How to provide a PAC file to your browser monitors
Use the script mode for single-URL browser monitors and browser clickpaths.
-
For new monitors, switch from Visual mode to Script mode.
-
For existing monitors, select Edit to open settings and select Recorded clickpath for clickpaths. Then switch to Script mode.
For existing single-URL browser monitors, select Monitor script.
You’ll need to add the following in the configuration
object of the JSON file:
"proxy": {
"pacUrl": "https://www.example.com/test.pac"
}
where pacUrl
points to your hosted PAC file.
For more information on script mode, see Script mode for browser monitor configuration.
Important to know
- PAC file configuration only applies to private Synthetic locations, not public locations.
- PAC file configuration applies only to the monitor you configure—each individual monitor must have the PAC file configured in its script; there is no global setting for all monitors to use a PAC file for proxy services. When you set a PAC file proxy for one synthetic monitor script, it only applies to that monitor.
- If a PAC file is specified, it overrides the proxy settings specified at the ActiveGate level for communication with the tested resource, that is, the properties in the
[synthetic]
section. - The PAC file must be served via HTTP/S.