# Multi-metric gauge chart

Create a multi-metric gauge chart to display a ratio of the good state and the bad state of devices, users, or events.

<figure><img src="/files/reUGsPPM4O4WxlD93kTb" alt="Gauge widget" width="268"><figcaption></figcaption></figure>

## Data shape <a href="#multi-metricgaugechart-datashape" id="multi-metricgaugechart-datashape"></a>

`<kpi for good state>, <kpi for bad state>`

## NQL structure <a href="#multi-metricgaugechart-nqlstructure" id="multi-metricgaugechart-nqlstructure"></a>

{% hint style="info" %}
Refer to the [Live Dashboards NQL examples](/platform/user-guide/live-dashboards/live-dashboards-nql-examples.md#livedashboardsnqlexamples-multi-metricgaugechart) documentation for query examples of multiple-metric gauge widgets.
{% endhint %}

The NQL structure depends on the variable state comparison you set for the multi-metric gauge—good values versus bad values.

For example, the NQL structure below returns the ratio of devices or users with bad events against objects without bad events.

```
<devices|users>
| include <event table>
| compute temp_bad_number = <device|user>.count()
| summarize 
   <good_label> = count() - temp_bad_number.sum(), 
   <bad_label> = temp_bad_number.sum()
```

The image below displays a gauge using the NQL structure referenced above. The legend labels for good and bad values, come from their corresponding variable names in the NQL query.

<figure><img src="/files/qON2vuMTgfLqDXYUbSL8" alt="Multi-metric gauge chart labels" width="442"><figcaption></figcaption></figure>

The variable names are formatted with the following heuristic:

* Underscores are replaced with spaces.
* The first character of the variable is changed to upper-case.

## Configuring visualization fields specific to multi-metric gauges <a href="#linechart-linechartspecificsettings" id="linechart-linechartspecificsettings"></a>

{% hint style="info" %}
Refer to the [Managing Live Dashboards](/platform/user-guide/live-dashboards/managing-live-dashboards.md#filling-in-widget-visualization-fields) documentation to learn how to fill in the remaining configuration fields that are not specific to this widget.
{% endhint %}

After selecting the **Multi metric gauge chart** option from the **Chart type** dropdown in the [Add widget](/platform/user-guide/live-dashboards/managing-live-dashboards.md#adding-widgets)/[Edit a widget](/platform/user-guide/live-dashboards/managing-live-dashboards.md#managing-widgets) pop-up:

1. Use the **Label (optional)** field to create the visible name of the main gauge.
   * The text can contain special characters. There is a 50-character limit on the **Label** field.
   * See the image in the [NQL structure](#multi-metricgaugechart-nqlstructure) to understand how to define the legend labels for the good and bad values in the query.
2. Enter a **Widget description (optional)** to explain, for example, how the metric should be interpreted, calculated, or any subtleties to the metric.
   * The widget description appears by hovering over the info icon next to the multi-metric gauge widget in the dashboard.

***

RELATED TOPIC

* [KPI](/platform/user-guide/live-dashboards/widget-types/kpi.md)
* [Line chart](/platform/user-guide/live-dashboards/widget-types/line-chart.md)
* [Bar chart](/platform/user-guide/live-dashboards/widget-types/bar-chart.md)
* [Single-metric gauge chart](/platform/user-guide/live-dashboards/widget-types/single-metric-gauge-chart.md)
* [Table](/platform/user-guide/live-dashboards/widget-types/table.md)
* [Heading](/platform/user-guide/live-dashboards/widget-types/heading.md)
* [Filter widget](/platform/user-guide/live-dashboards/widget-types/filter-widget.md)
* [Timeframe picker](/platform/user-guide/live-dashboards/widget-types/timeframe-picker.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/user-guide/live-dashboards/widget-types/multi-metric-gauge-chart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.