> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard widgets

Some [Datadog](/ingest/metrics-traces/collector/mappings/datadog) dashboard widgets
have a close match in Chronosphere Observability Platform
[standard dashboards](/observe/dashboards). Recreate them with
[panels](/observe/dashboards/panels) on a standard dashboard, not a
[classic dashboard](/observe/dashboards/classic-dashboards).

Before you rebuild visuals, translate Datadog queries to
[PromQL](/investigate/querying/promql). For more information, see
[Querying metrics](/ingest/metrics-traces/collector/mappings/datadog/dogstatsd),
[Mapping](/ingest/metrics-traces/collector/mappings/datadog/mapping), and
[Migration considerations](/ingest/metrics-traces/collector/mappings/datadog/migration-issues).

## Widget overview

| Datadog widget             | Observability Platform panel                                      | Notes                                              |
| -------------------------- | ----------------------------------------------------------------- | -------------------------------------------------- |
| Time series (stacked bars) | [Time series chart](/observe/dashboards/panels/time-series-chart) | Plots values across the dashboard time range       |
| Top list                   | [Bar chart](/observe/dashboards/panels/bar-chart)                 | Set **Query type** to **Instant** in **Options**   |
| Top list (tabular)         | [Table](/observe/dashboards/panels/table)                         | Use when you need columns or multiple calculations |
| Query value                | [Stat chart](/observe/dashboards/panels/stat-chart)               | Single aggregated value                            |

Observability Platform doesn't directly import Datadog dashboard JSON. Rebuild panels
manually or with your migration plan and tooling.

## Stacked bar graph

Datadog time series widgets with stacked bars show values over time. Match them
with a **Time series chart** panel.

1. [Create a panel](/observe/dashboards/panels#create-panels-in-a-dashboard) of type
   **Time series chart**, or [edit an existing panel](/observe/dashboards/panels#edit-panels-on-a-dashboard)
   and [change its type](/observe/dashboards/panels#change-a-panels-type-cloud) to
   **Time series chart**.

2. In the **Query** tab, enter a PromQL query for the series you want to stack.

3. 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.

4. Optional: In the **Settings** tab, in the **Tooltip** section, set **Sort** to
   **Descending** instead of **Auto** or **None**.

5. In the **Edit panel** interface, click **Apply**.

6. On the dashboard, click **Save**.

After you [convert the Datadog query](/ingest/metrics-traces/collector/mappings/datadog/dogstatsd),
the following example shows one pattern for stacked values over time.

```text theme={null}
sum by (LABEL_NAME) (rate(METRIC_NAME[5m]))
```

Replace the following:

* *`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.

1. [Create a panel](/observe/dashboards/panels#create-panels-in-a-dashboard) of type
   **Bar chart**, or [edit an existing panel](/observe/dashboards/panels#edit-panels-on-a-dashboard)
   and [change its type](/observe/dashboards/panels#change-a-panels-type-cloud) to
   **Bar chart**.

2. In the **Query** tab:

   * In **Options**, set **Query type** to **Instant**.
   * Enter a PromQL query with one value per series.

3. 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.

4. 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 the `topk` argument, or omit `topk` from the query
     and use **Limit** only.

5. In the **Edit panel** interface, click **Apply**.

6. On the dashboard, click **Save**.

Use an instant query that returns one value per series. The `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.

```text theme={null}
topk(10, sum by (LABEL_NAME) (rate(METRIC_NAME[5m])))
```

Replace the following:

* *`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.

1. [Create a panel](/observe/dashboards/panels#create-panels-in-a-dashboard) of type
   **Table**, or [edit an existing panel](/observe/dashboards/panels#edit-panels-on-a-dashboard)
   and [change its type](/observe/dashboards/panels#change-a-panels-type-cloud) to
   **Table**.

2. In the **Query** tab:

   * In **Options**, set **Query type** to **Instant**.
   * Enter a PromQL query with one value per series.

3. 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**.

4. Optional: In the **Settings** tab, in the **Data Format** section, enable
   **Label-based columns** to show each series's labels.

5. In the **Edit panel** interface, click **Apply**.

6. On the dashboard, click **Save**.

Use an instant query that returns one value per series. The `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.

```text theme={null}
topk(10, sum by (LABEL_NAME) (rate(METRIC_NAME[5m])))
```

Replace the following:

* *`METRIC_NAME`*: Your Prometheus metric name.
* *`LABEL_NAME`*: The label you group by.