Documentation

Using annotations in Chronograf views

This page documents an earlier version of Chronograf. Chronograf v1.8 is the latest stable version. View this page in the v1.8 documentation.

Using annotations in the Chronograf interface

Annotations in Chronograf are notes of explanation or comments added to graph views by editors or administrators. Annotations can provide Chronograf users with useful contextual information about single points in time or time intervals. Users can use annotations to correlate the effects of important events, such as system changes or outages across multiple metrics, with Chronograf data.

When an annotation is added, a solid white line appears on all graph views for that point in time or an interval of time.

Annotations example

The following screenshot of five graph views displays annotations for a single point in time and a time interval. The text and timestamp for the single point in time can be seem above the annotation line in the graph view on the lower right. The annotation displays “Deploy v3.8.1-2” and the time “2018/28/02 15:59:30:00”.

Annotations on multiple graph views

To add and edit an annotation:

  1. In the top menu bar, click Annotations.
  2. Click Annotate in the upper right.
  3. Click Add Annotation, then move your cursor to point in time you want to annotate and click or drag to create an annotation.
  4. To edit, hover over the annotation and select the edit (pencil) button from the tooltip that appears. The Edit Annotation window appears:
    • Name: The name for the annotation.
    • Type: Point annotations are for a single point in time. Window annotations cover a specified interval.
    • Start and End (window) or Time (point): The timestamp(s) for the annotation.
    • Annotation Tags: Click + Add Tag, then enter a tag key and values.
  5. To delete the annotation, click Delete.
  6. Click Save.

To filter annotations by tag:

  1. In the top menu bar, click Annotations.
  2. Select Filter Annotations by Tags from the drop-down menu in the upper left.
  3. Click + Filter to add a filter.
  4. Enter the tag key and values you want to filter by, then click the green check mark to add that filter.
  5. To filter by more than one tag, repeat steps 3-4.

To hide all annotations:

  • In the top menu bar, click Annotations.
  • Select Hide Annotations from the drop-down menu in the upper left.

New! Cloud or OSS?

InfluxDB OSS 2.0 release candidate

InfluxDB OSS v2.0.rc includes breaking changes that require a manual upgrade from all alpha and beta versions. For information, see:

Upgrade to InfluxDB OSS v2.0.rc