Set up Grafana k6 synthetic monitoring checks via the Cloud API

domain: grafana.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Authenticate to the Grafana Cloud Synthetic Monitoring API using a Synthetic Monitoring token obtained from the SM plugin UI; pass it as Authorization: Bearer YOUR_TOKEN in all requests
  2. POST to /api/v1/check to create a new check; specify job (name), target (URL or host), frequency (milliseconds between executions), timeout, probeIDs (probe location IDs), and settings (http, ping, dns, or tcp)
  3. For an HTTP check populate the settings.http object with method, headers, and body; add validations such as failIfBodyMatchesRegexp or failIfStatusNot2xx to assert content correctness
  4. GET /api/v1/probe to list available probe locations and their IDs; choose probes from multiple regions to get geographic coverage
  5. Retrieve check results and uptime metrics from the Prometheus-compatible metrics endpoint exposed by the Synthetic Monitoring datasource in Grafana Cloud
  6. Add alerting on the probe_success metric (value 0 means failure) using Grafana unified alerting rules targeting the SM datasource

Known gotchas

Related routes

Create and run a Grafana Cloud Synthetic Monitoring k6 scripted check against an internal API
grafana.com/docs/grafana-cloud/testing/synthetic-monitoring · 6 steps · unrated
Implement synthetic monitoring with browser and API checks
grafana.com · 5 steps · unrated
Deploy and register a Grafana Cloud Synthetic Monitoring private probe (synthetic-monitoring-agent) via Docker or Kubernetes so synthetic checks can run from within a private network
grafana.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans