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/troubleshoot.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/troubleshoot/. 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.
Troubleshoot private probes
If a Synthetic Monitoring private probe isn’t connecting or working as expected, use the following checks to review the agent’s configuration, logs, and metrics. For failures reported by a check, refer to Troubleshoot a failing check.
- Check the probe version using the
-versionflag and make sure you are running a supported version. - Make sure the probe has a valid probe access token.
- Make sure the probe can connect to the Synthetic Monitoring API server.
- Run the Synthetic Monitoring Agent in debug mode with the
-debugand-verboseflags and check for errors in the logs. - Check the Synthetic Monitoring Agent metrics. The default address for Synthetic Monitoring Agent Prometheus metrics is
localhost:4050/metrics.
If you are still facing issues with Private Probes, ask for help in the community forum. Refer to Account types and support available for Grafana Cloud users for more information.
Was this page helpful?
Related resources from Grafana Labs


