Overview
Widgets are building blocks for your dashboards. They allow you to visualize and correlate your data across your infrastructure.
Graphs
Generic widgets to graph data from Datadog products:
Groups
Display your widgets under groups:
Product Analytics
Visualize Product Analytics data:
Architecture
Visualize infrastructure and architecture data:
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
Summary widgets to display Monitoring information:
Site reliability visualizations:
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
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.
Metrics info
On a metric graph, click the context menu (three vertical dots) to find the Metrics Info option. This opens a panel with a description of the metric. Clicking on the metric name in this panel opens the metric in the metric summary page for further analysis or edits.
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:
Global time selector
To use the global time selector, at least one time-based widget must be set to use Global Time. Make the selection in the widget editor under Set display preferences, or add a widget (global time is the default time setting).
The global time selector sets the same time frame for all widgets using the Global Time option on the same dashboard. Select a moving window in the past (for example, Past 1 Hour or Past 1 Day) or a fixed period with the Select from calendar… option or enter a custom time frame. If a moving window is chosen, the widgets are updated to move along with the time window.
Widgets not linked to global time show the data for their local time frame as applied to the global window. For example, if the global time selector is set to January 1, 2019 through January 2, 2019, a widget set with the local time frame for Past 1 Minute shows the last minute of January 2, 2019 from 11:59 pm.
Widgets can be copied on Dashboards, Notebooks, APM Service, and the APM resource page by using Ctrl/Cmd + C, or by selecting the share icon and choosing “Copy”.
The copied widgets can be pasted within Datadog by using Ctrl/Cmd + V:
- 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.
For more information, see Datadog Clipboard.
Timeboard group widgets can be copied by hovering over the group widget area and using Ctrl/Cmd + C 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/Cmd + C.
Note: This only works when sharing within Datadog. It does not generate a preview image.
Hover your cursor over a graph to access the following menu options.
View in full screen
View the graph in full screen mode.
Export
Click on the export icon of any dashboard graph to open an options menu:
| Option | Description |
|---|
| Copy | Create a copy of the dashboard graph. |
| Share snapshot | Create and send a snapshot of your graph. |
Use within Datadog
| Option | Description |
|---|
| Declare incident | Declare an incident from the graph. |
| Add to incident | Add the graph to an existing incident. |
| Create case | Create a case from the graph. |
| Save to notebook | Save the graph to a notebook. |
| Link to widget | Get a link to the widget copied to your clipboard. |
Share externally
| Format | Instructions |
|---|
| Download as PNG | Download the widget in PNG format. |
| Download as SVG | Download the widget in SVG format. |
| Download as CSV | Download the widget in CSV format. |
Edit
Click on the pencil icon of any dashboard graph to make edits.
Additional options
Click on the context menu (three vertical dots) of any dashboard graph to open an options menu:
| Option | Description |
|---|
| Edit | Edit the graph. |
| Clone | Create an adjacent copy of the graph. |
| Split graph | Create a split graph. |
| Create custom links | Create custom links. |
| Create monitor | Create a monitor preconfigured with the graph’s query. |
| Metrics info (metric graphs only) | Get a description of the metrics in this graph. You can click on the metric names to open them in the Metric Summary page. |
| Delete | Delete the graph. |
Further Reading
Additional helpful documentation, links, and articles:
