Synthetic Monitoring Agent
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
Variants
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
- r/selfhosted on Reddit: I've been working on a synthetic monitoring ... (reddit)
- Synthetic monitoring agent - Grafana Labs Community Forums (other)
- Synthetic Monitoring Agent minimum requirements (other)
- Synthetic Monitoring - Troubleshooting - Checkmk Forum (forum)
Collected 48 days ago - public community threads