Widget overview
| Datadog widget | Observability Platform panel | Notes |
|---|---|---|
| Time series (stacked bars) | Time series chart | Plots values across the dashboard time range |
| Top list | Bar chart | Set Query type to Instant in Options |
| Top list (tabular) | Table | Use when you need columns or multiple calculations |
| Query value | Stat chart | Single aggregated value |
Stacked bar graph
Datadog time series widgets with stacked bars show values over time. Match them with a Time series chart panel.- Create a panel of type Time series chart, or edit an existing panel and change its type to Time series chart.
- In the Query tab, enter a PromQL query for the series you want to stack.
-
In the Settings tab, in the Visual section:
- Set Display to Bar.
- Set Stack series to All for stacked bars, or to Percent for percent-stacked bars.
- Optional: In the Settings tab, in the Tooltip section, set Sort to Descending instead of Auto or None.
- In the Edit panel interface, click Apply.
- On the dashboard, click Save.
METRIC_NAME: Your Prometheus metric name.LABEL_NAME: The label you group by.
Top list
Datadog top list widgets rank series by a single value at a point in time. The closest match is a Bar chart panel.- Create a panel of type Bar chart, or edit an existing panel and change its type to Bar chart.
-
In the Query tab:
- In Options, set Query type to Instant.
- Enter a PromQL query with one value per series.
- In the Settings tab, in the Misc section, set Mode to Value for absolute values, or to Percentage for values as a percent of the total.
-
Optional: In the Settings tab, in the Misc section:
- Set Sort to Descending (value) if it isn’t already. New bar chart panels default to descending sort.
- Set Limit to cap how many bars display. If your query uses
topk, set Limit to the same value as thetopkargument, or omittopkfrom the query and use Limit only.
- In the Edit panel interface, click Apply.
- On the dashboard, click Save.
topk argument limits how many
series the panel ranks, similar to a Datadog top list limit.
The following example shows one pattern for a ranked instant query.
METRIC_NAME: Your Prometheus metric name.LABEL_NAME: The label you group by.
Top list as a table
Use a Table panel when you need label columns, multiple calculations, or a sortable grid instead of horizontal bars.- Create a panel of type Table, or edit an existing panel and change its type to Table.
-
In the Query tab:
- In Options, set Query type to Instant.
- Enter a PromQL query with one value per series.
-
In the Settings tab:
- In the Data Format section, set Time series format to Series To Rows.
- Under Calculations, select Total.
- In the Sorting section, set Sort by to Total and Sort order to Descending.
- Optional: In the Settings tab, in the Data Format section, enable Label-based columns to show each series’s labels.
- In the Edit panel interface, click Apply.
- On the dashboard, click Save.
topk argument limits how many
rows display, similar to a Datadog top list limit.
The following example shows one pattern for a ranked instant query.
METRIC_NAME: Your Prometheus metric name.LABEL_NAME: The label you group by.

