Grafana Cloud

Set up Synthetic Monitoring in a local Grafana instance


If you connect an on-premise open-source (OSS) Grafana instance to your Grafana Cloud services, Grafana’s support team can help with issues on the Grafana Cloud side but will be unable to assist in troubleshooting issues that arise within your on-premise Grafana installation. Support for doing this is limited to the documentation and the community forums. Refer to Account types and support available for Grafana Cloud users for more information.

Use the grafana-cli tool to install Synthetic Monitoring from the command-line:

grafana-cli plugins install grafana-synthetic-monitoring-app

The CLI installs the plugin in your Grafana plugins directory. The default location is /var/lib/grafana/plugins.


Synthetic Monitoring requires a Grafana Cloud account for logs and metrics storage, as Synthetic Monitoring doesn’t support local logs and metrics storage. The Grafana Cloud Free Tier is sufficient for a basic Synthetic Monitoring setup.

To enable and initialize Synthetic Monitoring in your local Grafana instance:

  1. Setup provisioning files as described in GitHub.
  2. In Grafana, navigate to Administration > Plugins.
  3. Select Synthetic Monitoring from the list.
  4. Click Install.
  5. Click Enable to start the initialization process.
  6. Navigate to Testing & synthetics > Synthetics.
  7. Click Initialize the Plugin.

Next steps

Refer to Create your first check for next steps.