The heatgrid widget displays timeseries data grouped by tag, with each group shown as its own row and values encoded by color. This makes it easier to spot changes and compare groups directly, even when the number of groups is high.

Setup

Configuration

1. Configure your query, grouping by the tag you want to compare across rows. Each group in the query’s results appears as its own row in the grid.

2. Sort rows by: Order rows by average value, max value, min value, sum of values, or label, in ascending or descending order.
3. Colors: Configure how query values map to row colors.
   • Scheme: Select a preset color scheme, or edit an individual stop’s color or position in Format stops to customize it.
   • Apply as: Choose Continuous Gradient to map values along a smooth color scale, or Discrete Conditions to map value ranges to specific colors.
   • For a custom gradient, add stops along the scale and set a color and position (0-100%) for each.
   • For custom discrete conditions, define a color and a value range (lower and upper bound) for each condition. The first condition has no lower bound and the last has no upper bound, so together the conditions cover the full range of values. Note: The lower bound of the first bucket is the min value across the data and the upper bound of the last bucket is the max value.
   • Each gradient or set of discrete conditions supports 2-6 stops or conditions.
4. Row label width: Choose a specific width for the row label column, using preset sizes. By default, Datadog selects the size closest to the width of the labels in view.
5. Show legend label: Toggle to show or hide the legend label.

Options

Unit override

Configure units as they display in the grid and tooltips.

Context links

Context links are enabled by default; you can toggle them on or off. Context links connect dashboard widgets with other pages (in Datadog or third-party).

Further Reading

Additional helpful documentation, links, and articles:

Building Dashboards using JSONDOCUMENTATION