Annotations

Annotations provide a way to mark points on the graph with rich events. When you hover over an annotation you can get event description and event tags. The text field can include links to other systems with more detail.

Native annotations

Grafana v4.6+ comes with a native annotation store and the ability to add annotation events directly from the graph panel or via the HTTP API.

Adding annotations

By holding down CTRL or CMD + Click. Add tags to the annotation will make it searchable from other dashboards.

Adding regions events

You can also hold down CTRL or CMD and select region to create a region annotation.

Built in query

After you added an annotation they will still be visible. This is due to the built in annotation query that exists on all dashboards. This annotation query will fetch all annotation events that originate from the current dashboard and show them on the panel where they where created. This includes alert state history annotations. You can stop annotations from being fetched & drawn by opening the Annotations settings (via Dashboard cogs menu) and modifying the query named Annotations & Alerts (Built-in).

When you copy a dashboard using the Save As feature it will get a new dashboard id so annotations created on source dashboard will no longer be visible on the copy. You can still show them if you add a new Annotation Query and filter by tags. But this only works if the annotations on the source dashboard had tags to filter by.

Query by tag

You can create new annotation queries that fetch annotations from the native annotation store via the -- Grafana -- data source and by setting Filter by to Tags. Specify at least one tag. For example create an annotation query name outages and specify a tag named outage. This query will show all annotations you create (from any dashboard or via API) that have the outage tag.

Querying other data sources

Annotation events are fetched via annotation queries. To add a new annotation query to a dashboard open the dashboard settings menu, then select Annotations. This will open the dashboard annotations settings view. To create a new annotation query hit the New button.

Specify a name for the annotation query. This name is given to the toggle (checkbox) that will allow you to enable/disable showing annotation events from this query. For example you might have two annotation queries named Deploys and Outages. The toggles will allow you to decide what annotations to show.

Annotation query details

The annotation query options are different for each data source.