Synthetics Settings

On the Synthetics settings page, you can adjust the following settings:

Global Variables
Private Locations
Default settings
- Default Locations
- APM integration for Browser Tests

Only Admin and Standard users can access Synthetics Settings page.

Global Variables

Variables are global and can be used by multiple API tests and browser tests. To create a new global variable, go to the Global Variables tab of your Settings page, and click New Global Variable in the upper right corner of your page. Choose the type of variable you want to create:

Dropdown

Enter a Variable Name. Your variable name can only use uppercase letters, numbers, and underscores.
Enter the given Value.
Decide whether to make your variable secure. Securing your variable obfuscates its value for all users on your test results.
Optional: select Tags to associate to your variable.
Optional: enter a Description for your variable.

You can create variables from your existing HTTP tests by parsing its response headers or body. Variables are updated with the same frequency as the test it’s coming from:

Enter a Variable Name. Your variable name can only use uppercase letters, numbers, and underscores.
Pick the test you want to extract your variable from.
Decide whether to make your variable secure. Securing your variable obfuscates its value for all users on your test results.
Optional: select Tags to associate to your variable.
Optional: enter a Description for your variable.
Decide whether to extract your variable from the response headers, or from the response body.
- Extract the value from response header: use the full response header for your variable, or parse it with a regex.
- Extract the value from response body: parse the response body of the request with a regex, or use the full response body.

Default Settings

Default Locations

Choose the default locations for your browser and API tests details. Options include all of the available managed locations Datadog offers and the private locations that you set up for your account.

APM integration for Browser Tests

Whitelist URLs to add APM integration headers to that URL. Datadog’s APM integration headers allow Datadog to link browser tests with APM. Define which endpoints should be sent the APM headers by adding a URL into this section.

Use * to whitelist wider domain names. For example, adding https://*.datadoghq.com/* whitelists everything on https://datadoghq.com/.

If the endpoint is being traced and whitelisted, your browser test results are then automatically tied to its corresponding trace.