re-added single stat graph doc that was unintentially removed
parent
1dc00f2ec8
commit
22bcd1c951
|
@ -0,0 +1,65 @@
|
|||
---
|
||||
title: Single Stat visualization
|
||||
list_title: Single stat
|
||||
list_image: /img/2-0-visualizations-single-stat-example.png
|
||||
description: >
|
||||
The Single Stat view displays the most recent value of the specified time series as a numerical value.
|
||||
weight: 205
|
||||
menu:
|
||||
v2_0:
|
||||
name: Single Stat
|
||||
parent: Visualization types
|
||||
---
|
||||
|
||||
The **Single Stat** view displays the most recent value of the specified time series as a numerical value.
|
||||
|
||||
{{< img-hd src="/img/2-0-visualizations-single-stat-example.png" alt="Single stat example" />}}
|
||||
|
||||
Select the **Single Stat** option from the visualization dropdown in the upper right.
|
||||
|
||||
## Single Stat behavior
|
||||
The Single Stat visualization displays a single numeric data point.
|
||||
It uses the latest point in the first table (or series) returned by the query.
|
||||
|
||||
{{% note %}}
|
||||
#### Queries should return one table
|
||||
Flux does not guarantee the order in which tables are returned.
|
||||
If a query returns multiple tables (or series), the table order can change between query executions
|
||||
and result in the Single Stat visualization displaying inconsistent data.
|
||||
For consistent results, the Single Stat query should return a single table.
|
||||
{{% /note %}}
|
||||
|
||||
## Single Stat Controls
|
||||
To view **Single Stat** controls, click the settings icon ({{< icon "gear" >}})
|
||||
next to the visualization dropdown in the upper right.
|
||||
|
||||
- **Prefix**: Prefix to be added to the single stat.
|
||||
- **Suffix**: Suffix to be added to the single stat.
|
||||
- **Decimal Places**: The number of decimal places to display for the single stat.
|
||||
- **Auto** or **Custom**: Enable or disable auto-setting.
|
||||
|
||||
###### Colorized Thresholds
|
||||
- **Base Color**: Select a base or background color from the selection list.
|
||||
- **Add a Threshold**: Change the color of the single stat based on the current value.
|
||||
- **Value is**: Enter the value at which the single stat should appear in the selected color.
|
||||
Choose a color from the dropdown menu next to the value.
|
||||
- **Colorization**: Choose **Text** for the single stat to change color based on the configured thresholds.
|
||||
Choose **Background** for the background of the graph to change color based on the configured thresholds.
|
||||
|
||||
## Single Stat examples
|
||||
|
||||
### Show human-readable current value
|
||||
The following example shows the current memory usage displayed has a human-readable percentage:
|
||||
|
||||
###### Query memory usage percentage
|
||||
```js
|
||||
from(bucket: "example-bucket")
|
||||
|> range(start: v.timeRangeStart, stop: v.timeRangeStop)
|
||||
|> filter(fn: (r) =>
|
||||
r._measurement == "mem" and
|
||||
r._field == "used_percent"
|
||||
)
|
||||
```
|
||||
|
||||
###### Memory usage as a single stat
|
||||
{{< img-hd src="/img/2-0-visualizations-single-stat-memor.png" alt="Graph + Single Stat Memory Usage Example" />}}
|
Loading…
Reference in New Issue