Course contentsShow
← Cloud and Infrastructure
Lesson 2000 of 2,98942. Observability - MetricsFree lesson

Annotations and Time Range Controls

Understand how to add annotations to mark events, configure time ranges, and use time-based navigation features.

Annotations and Time Range Controls

You'll learn how to mark important events on your Grafana dashboards with annotations and navigate time-based data effectively using time range controls.

What Are Annotations?

Annotations are visual markers that appear as vertical lines or regions on your dashboard panels. They help you correlate metrics with real-world events like deployments, incidents, or maintenance windows. Think of them as "bookmarks in time" that tell the story behind your data spikes or dips.

When you see a sudden CPU spike at 3:47 PM, an annotation can remind you: "deployment: v2.4.5 released."

Adding Annotations

Annotations can come from:

  • Manual entry: You click a timestamp and add a description
  • Query-based: Pull events from a data source (like Prometheus) that match certain conditions
  • Built-in sources: Grafana's own alert events

They help teams understand why metrics changed, not just that they changed.

Time Range Controls

Time range controls let you zoom into specific periods of your metrics data. Located at the top-right of most dashboards, they allow you to:

  • Select relative ranges (Last 5 minutes, Last 24 hours)
  • Choose absolute ranges (specific start/end timestamps)
  • Use the time picker to navigate quickly
  • Apply refresh intervals to auto-update data

Navigation Features

Time-based navigation includes:

  • Zoom in/out: Click-drag on a panel to focus on a time window
  • Shift time: Move forward or backward without changing the range duration
  • Time sync: Link multiple panels to explore the same period together

These controls turn your dashboard into a time machine, letting you investigate past incidents or compare current performance to historical baselines.

Key Takeaway: Annotations contextualize metric changes with real events, while time range controls give you precise temporal navigation to investigate and understand your observability data.