Synthetic Monitoring Agent

Blackbox Exporter agent which executes checks for the Grafana Cloud Synthetic Monitoring service.

  • Monitoring & Logging
  • Network Services
Blackbox Exporter agent which executes checks for the Grafana Cloud Synthetic Monitoring service.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

72/100 Good

Maintained
100last commit 3 days ago
Popular
47227 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
84no serious findings, 2 minor, CI, tests, OpenSSF Scorecard 7.7/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
227
Open issues
89
Last commit
2026-11-18
Latest release
v0.71.0
License
Apache-2.0
Activity
rising

Checked 2 days ago - source: GitHub (grafana/synthetic-monitoring-agent)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the OpenAI Python library first Run pip (Python’s package installer) with pip install openai before starting the agent, because it uses this library to call the Synthetic API. If it’s missing, startup fails with a 'module not found' error. source
  • Set the API key and endpoint before use Put your Synthetic API key in the SYNTHETIC_API_KEY environment variable (a named setting saved outside your code) and point the client to the documented base_url (the API's address). Without the key, the API rejects you; with the wrong endpoint, requests go to the wrong service and fail. source
  • Pick a model ID from the model list Check the model list first and copy an exact model ID, such as one returned by the API, into your request. If you type a model name incorrectly, the API returns an error and the agent can't produce a response. source

Fetched 53 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What startup failure can occur if the OpenAI Python library is not installed?

The agent can fail to start with a 'module not found' error because it uses that library to call the Synthetic API. Install the OpenAI Python library with pip before starting the agent.

What configuration is required before the Synthetic API accepts the agent's requests?

Put the Synthetic API key in the SYNTHETIC_API_KEY environment variable and point the client to the documented base_url. Without the key the API rejects the request, and with the wrong endpoint requests fail.

What must be included in a request to avoid a model error from the Synthetic API?

Use an exact model ID from the model list, such as one returned by the API. An incorrect model name causes the API to return an error and prevents the agent from producing a response.

What setup issue has been reported for a private Grafana synthetic monitoring agent?

A user reported failure when trying to obtain the key/certificate from the documentation steps.

Answers sourced from community.grafana.com, dev.synthetic.new, dev.synthetic.new

Community

Collected 48 days ago - public community threads