Widgets

Overview

Widgets are building blocks for your dashboards. They allow you to visualize and correlate your data across your infrastructure.

Graphs


Groups

Display your widgets under groups:


Annotations and embeds

Decoration widgets to visually structure and annotate dashboards:


Lists and streams

Display a list of events and issues coming from different sources:


Alerting and response


Architecture

Visualize infrastructure and architecture data:


Performance and reliability


Full screen

You can view most widgets in full screen mode and do the following:

  • Change time frames
  • Move backward or forward by the time frame selected
  • Pause the graph at the current time or view the live graph
  • Reset the time frame
  • Export the graph to a dashboard, notebook, or copy the query
  • Download the data producing the graph in a CSV format

To access the widget overview directly, click the full-screen button on the top right-hand corner of the widget.

Additional options are available for timeseries widgets.

Custom links connect data values to URLs such as a Datadog page or your AWS console.

To customize interactions with data inline your generic widgets, see Custom Links.

Unit override

Customize unit values displayed on widgets to add context to your data. For more use cases and information, see the Customize your visualizations with unit overrides.

  • Unit override: choose to display units in the family of ‘memory’, and have Datadog take care of displaying the appropriate scale depending on data (such as megabytes or gigabytes).
  • Unit and scale override: fix units to a single scale (display data in megabytes regardless of value).
  • Define custom units: define completely custom units (like ’tests’ instead of a generic count).

This is not an alternative for assigning units to your data.

Set units at the organization level:


Copy and paste widgets

You must have dashboard_public_share permissions and enable Static Public Data Sharing in your Organization Settings to use this feature.

Widgets can be copied on Dashboards, Notebooks, APM Service, and the APM resource page by using Ctrl + C (Cmd + C for Mac), or by selecting the share icon and choosing “Copy”.

The copied widgets can be pasted within Datadog by using Ctrl + V (Cmd + V for Mac) on:

  • Dashboards: Adds a new widget positioned under your mouse cursor.
  • Notebooks: Adds a new cell at the end of the notebook.

You can also paste the widget into your favorite chat program that displays link previews (like Slack or Microsoft Teams). This displays a snapshot image of your graph along with a direct link to your widget.

Groups of widgets

Timeboard group widgets can be copied by hovering over the group widget area and using Ctrl + C (Cmd + C for Mac) or by selecting the share icon and choosing “Copy”.

Note: When pasting graphs to screenboards or notebooks, individual widgets within the group are pasted.

To copy multiple screenboard widgets (edit mode only), shift + click on the widgets and use Ctrl + C (Cmd + C for Mac).

Note: This only works when sharing within Datadog. It does not generate a preview image.

Export graphs

PNG

To download a widget in PNG format, click the export button in the upper right hand side of the widget, and select Download as PNG.

CSV

To download data from a timeseries, table, or top list widget in CSV format, click the export button in the upper right hand side of the widget, and select Download as CSV.

Further Reading

Additional helpful documentation, links, and articles: