Metric chart
A metric chart displays a single numeric value prominently, making it ideal for showing key performance indicators (KPIs) or summary statistics at a glance.
Creating a metric chart
The following example demonstrates a basic metric visualization. Before you begin, complete the prerequisites.
Basic metric chart
Start with a query that returns a numeric field:
source = opensearch_dashboards_sample_data_flights | FIELDS AvgTicketPrice
After running this query, select Metric as the chart type. The editor maps the field as follows:
- The Value field displays the
AvgTicketPricefield (using the Last calculation by default).
The result is a single large number displaying the last ticket price value, as shown in the following image.
Configuring a metric chart
You can configure the following settings in the configuration panel.
Fields
In the Fields section, configure the data fields.
| Field | Description |
|---|---|
| Value | Select a numeric field to display as the metric value. The field is reduced to a single number using the configured calculation method. |
Split
In the Split by dropdown list, select a field to split the chart into separate elements by value. For more information, see Split.
Metric
| Setting | Description |
|---|---|
| Text display | Controls what text is shown alongside the value. Supported values: Value only, Name only, Value and Name, None. |
| Color mode | Controls how threshold colors are applied to the metric. Supported values: None (no color), Value (colors the value text), Background gradient (applies a gradient background), Background solid (applies a solid background color). |
| Show percentage | When enabled, displays the value as a percentage of the max value. |
| Use threshold colors | When enabled, applies threshold colors to the metric based on the current value. |
Value options
| Setting | Description |
|---|---|
| Calculation | Determines how multiple data points are reduced to a single value. Supported values: Last *, Last, First *, First, Min, Max, Median, Variance, Distinct count, Count, Total. For more information, see Value calculations. |
Thresholds
For information about configuring thresholds, see Thresholds.
Standard options
| Setting | Description |
|---|---|
| Min | The lower bound of the metric scale (used for percentage calculations). |
| Max | The upper bound of the metric scale (used for percentage calculations). |
| Units | An optional unit label applied to the displayed value. |
Text size
| Setting | Description |
|---|---|
| Value size | Controls the font size of the displayed value. |
| Title size | Controls the font size of the metric title. |
| Percentage size | Controls the font size of the percentage display (when Show percentage is enabled). |