Grafana Learn
Sign in Sign up
Section 1 · Journey overview

A watcher checks your telemetry on a schedule and reports notable changes, using checks Assistant builds from what you describe.

Estimated time: 1 min

What’s a watcher?

A watcher checks your telemetry on a schedule and reports notable changes. You describe what to monitor, Assistant builds checks from your data, and you review the findings and adjust the watcher as your service changes. Depending on the data sources you select, a watcher can check metrics, logs, trace-derived metrics, profiles, and other data.

Why use a watcher?

  • Service health checks: A watcher checks the same scope on each scheduled run and notifies you when an issue needs attention, not on every run.
  • Services with expected noise: Describe the behavior you expect, such as brief error spikes during deployments, and focus the watcher on the signals that need attention.
  • Services that change over time: Turn on automatic recalibration, and Assistant reviews and updates the watcher’s checks on a schedule.
  • Follow-up monitoring after an incident: Keep a watcher running on the affected service, and set a stop time for a limited monitoring window.

The hands-on learning path leaves notifications off so you can create, calibrate, run, and read a result first. Refer to Manage watcher notifications when you want a watcher to send findings somewhere.