Dash0 Raises $110M Series B at $1B Valuation

Last updated: July 16, 2026

Add Annotations

Overlay events on time-series charts and geographic maps to correlate what happened in your system alongside your metrics.

Annotations overlay events on charts so you can see what happened alongside your metrics. On time-series charts, events appear as markers on the timeline. On GeoMaps, they appear as geographic pins showing where events occurred. If a chart shows a latency spike, an annotation might show that a pod restarted or a container got rescheduled seconds before, right there on the same chart.

Time-series chart with annotation markers overlaying events showing when system changes occurred

Prerequisites

Annotations display log events already ingested into Dash0. In OpenTelemetry, a log event is any log record that carries an event.name attribute (or the event.auto.event.name fallback). Make sure at least one source of log events is active:

  • Service Events: Log events that also carry a service.name attribute, together with, optionally, a service.namespace attribute. These can overlap with Kubernetes Events and other log events.
  • Kubernetes Events: The Dash0 Operator for Kubernetes (v0.92.1+) automatically collects Kubernetes events from monitored namespaces and ingests them as log events.
  • Structured Log Sources: Any structured log record with an otel.event.name attribute is a log event. You can also create log events directly from the Dash0 CLI.

Add Annotations to a Panel

Time-Series Charts

  1. Open a dashboard and click Edit on the panel you want to annotate.
  2. Below the query editor, next to the Query tab, click +, and then select Add Annotation. Query editor with plus button and Add Annotation option for adding event overlays to panel
Tip

When annotations are active, a secondary timeline appears at the top of the panel. Each mark represents a matching log event; hovering over a mark reveals the event details. You can add multiple annotations per panel to layer different event scopes on the same chart.

  1. Select an Annotation type to filter which log events are shown, Service Events, Kubernetes Events, or Log Events. For Service Events, select a Service to scope the annotation to. Annotation configuration panel showing Annotation type selection and Service dropdown for scoping events
  2. Optionally click + Add filter to narrow results by attributes such as event reason, severity, or resource name.
  3. The annotation markers appear immediately on the chart preview. Time-series chart with annotation markers overlaying events showing when system changes occurred
  4. Save the panel to persist the annotation for all dashboard viewers.

You can add multiple annotations to a single panel, each tracking a different event type or service.

GeoMaps

GeoMap panels display event annotations as geographic pins showing where events occurred.

GeoMap showing event annotation pins clustered on a world map with Web events annotation type selected

  1. Open a dashboard and click Edit on the GeoMap panel.
  2. Scroll to the Annotation settings section below the query editor.
  3. Click Add Annotation.
  4. Select an Annotation type (Web Events, Service Events, Kubernetes Events, or Log Events).
  5. Configure filters to scope which events appear as pins.
  6. The pins appear immediately on the map preview.
  7. Save the panel to persist the annotations.

Event pins use the same markers, colors, and severity indicators as timeline annotations. They resolve from standard OpenTelemetry geo attributes (see the OpenTelemetry semantic conventions for geo attributes).

Tip

Enable the Show Cities toggle in the GeoMap panel settings to overlay city reference points for geographic orientation.

View Event Details

Time-Series Charts

Events appear as markers along the chart timeline. When multiple events occur within a short time window, they are grouped into a single indicator that shows the total event count.

Click on any marker to expand a detail panel that lists:

  • The time range of the grouped events
  • Event categories and their counts
  • Individual events with timestamp and description
  • A link to view remaining items if the list is truncated

GeoMaps

Events appear as pins at their geographic locations. As you zoom out, nearby pins cluster into bubbles that show the event count and take the most severe color in the group. Zoom in to split clusters into individual pins.

To view event details:

  • Click a pin: Opens a tooltip with event information
  • Alt/Option + Click: Pins the tooltip open so you can click through to the underlying events
  • Zoom with trackpad (macOS): Pinch to zoom directly on the map

If your telemetry includes exact coordinates and locality data, pins render at precise locations. Otherwise, they resolve to country or region level based on available geographic attributes.