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.