Skip to content

Sematext Synthetics FAQ


What should I do if I can't find the answer to my question in this FAQ?

Check the general FAQ for questions that are not strictly about Sematext Synthetics. If you can't find the answer to your question please email or use our live chat.

When should I use a Browser Monitor and when an HTTP Monitor?

Use a Browser monitor when you want to:

Use an HTTP monitor when you want to:

Can I monitor the endpoints and web pages behind the firewall?

Yes. You can use private agents to monitor the endpoints and web pages behind the firewall.

If you do not want to run private agents yourself, you can also configure the firewall to allow the requests from Synthetics agents running in the cloud. Configure your firewall to allow HTTP requests with specific headers. All requests from HTTP Monitor will contain x-sematext-origin: synthetics in their headers. For Browser monitors, you can configure the script to include a custom header for all requests.

Can I monitor API endpoints protected by OAuth authentication?

No. The HTTP monitor does not support OAuth authentication before sending the actual request. HTTP monitor supports header-based authentication.

Can I monitor API endpoints protected by Basic authentication?

Yes, the HTTP monitor supports header-based authentication. Custom HTTP request headers can be specified when creating a monitor. For Basic authentication add the Authorization: Basic XYZ header where XYZ is the Base64 encoding of the username:password string.

Can I stop Synthetics Alerts during scheduled maintenance?

Yes. You can temporarily disable the notifications from Edit Configuration -> Configure Alerts -> Notifications. Once the maintenance window is over, you can enable the notifications.

Disable Notifications

Can I configure a monitor to alert only after N successive failures?

Yes. You can update the below setting in Edit Configuration -> Configure Alerts -> Notifications to notify only when there are N consecutive failures from any location. The default value is 1.

Configure run failure count

What are the default timeouts for HTTP & Browser monitors?

The default timeouts for the HTTP and Browser monitors are documented in their respective environment settings.

Is there an API available?

Yes. Please see using the API.

Can I add monitors in bulk for monitoring multiple domains?

Yes. This can be achieved by using a script with the API. Please see using the API.

How are redirects handled?

HTTP monitors don't follow redirects. If you think redirects should be followed please let us know. Browser monitors follow redirects by default and collect metrics from the page to which the monitor has been redirected.

Currently, it is not possible to change the default settings, except for the default navigation timeout in the Browser monitor scripts. It can be changed using the page.setDefaultNavigationTimeout(timeout) API.

How can I filter requests from HTTP & Browser monitors?

Both HTTP and Browser monitor requests will have the string "SematextSyntheticsRobot" in the User-Agent header. If your analytics software doesn't already filter out requests from Synthetics, you can use the User-Agent header to filter requests from Synthetics.

Where can I find user journey scripts that I can customize for my own needs?

You can find Browser monitor scripts for common use cases by selecting the Browse Examples link in the Create Monitor page. You can directly import a script from the example and change it to suit your needs. You can also find more examples here.

Why is the latency reported by Browser monitors different from latency reported by HTTP monitors?

Short answer: because they are measuring somewhat different things.

The HTTP monitor measures how long it takes to execute a single HTTP request and get a response. This includes performing a DNS lookup, establishing a TCP connection, sending of the request, and content transfer. On the other hand, the Browser monitor measures all of that, plus how long it takes to load and render the whole page, which includes fetching of external resources references in that page (e.g., CSS resources, JavaScript resources, etc.). If a user journey script is used with a Browser monitor then that is included as well. Thus, it is expected that Browser monitors display higher latency.

What are the IP addresses from which monitors are run?

N. Virginia (us-east-1) -
N. California (us-west-1) -
Mumbai (ap-south-1) -
Singapore (ap-southeast-1) -
Sydney (ap-southeast-2) -
Frankfurt (eu-central-1) -
Ireland (eu-west-1) -
Sao Paulo (sa-east-1) -

Where can I see if a certain device is supported for browser monitors?

You can simply type the name of your desired device into the Device type dropdown while creating a monitor and see if a matching option will be displayed. You can also find the list of devices we support, as well as their specific properties, in the official Puppeteer docs.


How can I share my Sematext Apps with other users?

See sharing FAQ.

What is the difference between OWNER, ADMIN, BILLING_ADMIN, and USER roles?

See info about user roles in sharing FAQ.


Can I send alerts to HipChat, Slack, Nagios, or other WebHooks?

See alerts FAQ.