Synthetic MonitoringGetting started

Getting started

To set up your first check, let’s ping a target system to see if it is reachable by sending a network packet to the host and waiting for a response. This is the simplest check for system availability.

Create a ping check

  1. Navigate to Synthetic Monitoring > Checks.
  2. Click New Check.
  3. Choose PING as the Check Type.
  4. Enter a Job Name.
  5. Enter a Target. This is the hostname or IP of the system to check.
  6. Select the Probe Locations to test from, or click All to test from all locations.
  7. Click Save.

The Synthetic Monitoring backend distributes the check to all selected probes. Each probe pings the configured target and reports metrics and logging data back to your Grafana Cloud account. Follow the steps in Viewing your check data to dig deeper.

View the ping dashboard

Grafana dashboards display your data in panels arranged in rows. Synthetic Monitoring ships with default dashboards that can be customized, or you can create your own.

  1. Click Search (magnifying glass icon) in the left menu bar.
  2. Type synthetic in the search bar at the top of the screen.
  3. Click Synthetic Monitoring Ping from the list of Synthetic Monitoring dashboards.

This dashboard shows details of all ping checks you have set up. You’ll see a world map with the selected probe locations for the check, plus uptime, average latency, and any error logs at the bottom of the panel.

If you have multiple ping checks set up and would like to see only one of them, select a different job in the drop-down above the world map.

View Loki log data

You can view the check metrics or logs data directly with the Grafana Explore feature if you are using Grafana 6.0 or above.

  1. Click Explore (compass icon) in the left menu bar.
  2. Choose your Loki data source from the top left drop-down list.
  3. In the query bar, next to Log labels, enter {check_name="ping"}.
  4. Click Run Query in the upper right corner, or press Shift+Enter.

You will see the logs collected for all ping checks. See the Loki LogQL documentation if you want to query the logs deeper.

Next steps

See the Checks page to get an overview of other types of checks and additional things you can do with Synthetic Monitoring.