Documentation

Using annotations in Chronograf views

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.
  1. To delete the annotation, click Delete.
  2. 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.

Was this page helpful?

Thank you for your feedback!


Linux Package Signing Key Rotation

All signed InfluxData Linux packages have been resigned with an updated key. If using Linux, you may need to update your package configuration to continue to download and verify InfluxData software packages.

For more information, see the Linux Package Signing Key Rotation blog post.

InfluxDB Cloud backed by InfluxDB IOx

All InfluxDB Cloud organizations created on or after January 31, 2023 are backed by the new InfluxDB IOx storage engine. Check the right column of your InfluxDB Cloud organization homepage to see which InfluxDB storage engine you’re using.

If powered by IOx, this is the correct documentation.

If powered by TSM, see the TSM-based InfluxDB Cloud documentation.

InfluxDB Cloud backed by InfluxDB TSM

All InfluxDB Cloud organizations created on or after January 31, 2023 are backed by the new InfluxDB IOx storage engine which enables nearly unlimited series cardinality and SQL query support. Check the right column of your InfluxDB Cloud organization homepage to see which InfluxDB storage engine you’re using.

If powered by TSM, this is the correct documentation.

If powered by IOx, see the IOx-based InfluxDB Cloud documentation.

State of the InfluxDB Cloud (IOx) documentation

The new documentation for InfluxDB Cloud backed by InfluxDB IOx is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.