Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/set-up/set-up-private-probes/network-and-resource-requirements.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/set-up/set-up-private-probes/network-and-resource-requirements/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Network and resource requirements
Before setting up a Synthetic Monitoring private probe, review the connections it needs and estimate CPU and memory for your checks. Use these requirements to prepare the host or container environment and its firewall rules.
Firewall configuration
Private probes initiate connections to Synthetic Monitoring services and monitored targets. Configure the probe host’s firewall to allow the outbound connections in the following sections. If a monitored target has its own firewall, configure that firewall separately to allow inbound connections from the probe host.
Synthetic Monitoring services
- Allow outbound connections from the probe host to the addresses in the “API server URL” column of the regional endpoint table.
- Allow outbound connections from the probe host to the addresses in the “Secrets proxy” column of the regional endpoint table.
Prometheus and Loki instances
Allow outbound connections from the probe host to the Prometheus server URL and the Loki URL:
- Log in to Grafana Cloud and open your stack.
- Navigate to Home > Testing & synthetics > Synthetics > Config.
- Under the General tab, scroll down to Data sources.
- For the Prometheus server URL:
- Click the Prometheus data source. For example:
grafanacloud-STACK_NAME-prom. - Copy the Prometheus server URL under the Settings tab -> Connection.
- Click the Prometheus data source. For example:
- For the Loki URL:
- Click the Loki data source. For example:
grafanacloud-STACK_NAME-logs. - Copy the URL under the Settings tab -> Connection.
- Click the Loki data source. For example:
- Update the probe host’s firewall rules with both URLs.
External script imports
- If you use k6 scripts that import external modules, for example, k6 modules from
jslib.k6.io, allow outbound connections from the probe host to the module hosts.
Note
MultiHTTP test executions make outbound connections to
jslib.k6.iowhen run. If you run MultiHTTP checks on private probes behind a firewall, allow outbound connections from the probe host tojslib.k6.io.
Monitored targets
Allow outbound connections from the probe host to each monitored target. The required protocol depends on the check type. For example:
- ICMP: for ping and traceroute checks.
- UDP or TCP: for DNS checks.
- TCP: for HTTP and MultiHTTP checks.
If a target’s firewall blocks these connections, configure the target’s firewall, not the probe host’s firewall, to allow inbound connections from the probe host over the required protocol.
Calculate resource requirements
Resources used by private probes may vary based on the targets being monitored, so it can be hard to predict them in advance. Below, we provide a rough estimate to get you started.
The baseline CPU and memory resources, if you want to run:
- API endpoint checks:
50m/64Mi. - The above, plus multi-step checks, scripted checks, or both:
200m/256Mi. - The above, plus browser checks:
1000m/1024Mi.
Then, for each check per minute of the following types, add:
- API endpoint (HTTP, Ping, DNS, TCP, Traceroute):
5m/2Mi. - Multi-step or scripted checks:
20m/32Mi - Browser checks:
100m/256Mi.
As mentioned above, keep in mind that these are ballpark estimates. Monitor the resource usage of your probe, and stay on the lookout for CPU throttling and OOM events to see if you need to adjust any resources.
Next steps
Continue with Set up a private probe to register a probe, or install the agent if you already have a probe authentication token.
Was this page helpful?
Related resources from Grafana Labs


