You can use a bar gauge (Pro) to visualize multiple bar charts. You can also configure custom settings for fields. This topic describes the basic configurations of a bar gauge (Pro).
Background information
A bar gauge (Pro) contains one or more bar charts. In most cases, bar charts are used in top-N analysis. The following figure shows a sample bar gauge. Each colored rectangle in the bar gauge represents a bar chart.
If a bar gauge (Pro) contains only one bar chart. It is usually a progress bar. The progress bar is primarily used for displaying percentage indicators or data proportions.
For more information, see Add a chart (Pro) to a dashboard.
Common Settings tab
On the Common Settings tab, you can configure global settings for the bar gauge.
Basic Configurations section
Parameter
Description
Title
The title of the bar gauge.
Show Title
If you turn on Show Title, the title of the bar gauge is displayed.
Show Border
If you turn on Show Border, the borders of the bar gauge are displayed.
Show Background
If you turn on Show Background, the background color of the bar gauge is displayed.
Show Time
If you turn on Show Time, the query time range of the bar gauge is displayed.
Fixed Time
If you turn on Fixed Time, the specified time range remains unchanged regardless of whether the global time range of the dashboard changes.
Standard Configurations section
Parameter
Description
Format
The display format of numeric values.
Unit
The unit of numeric values.
Number of Digits after Decimal Point
The number of digits after the decimal point of numeric values.
Display Name
The name of the row.
If you specify the parameter, the name of each row in the bar gauge is changed to the specified value. If you want to modify the name of a row, you can configure a field on the Fields tab.
Color Scheme
The color scheme that specifies the colors of slices in the bar gauge.
Built-in: The built-in color scheme is used.
Solid: You can select a color.
Threshold: The color of each bar chart is based on the threshold settings.
Data Configuration section
Parameter
Description
Display Mode
Specifies how the bar gauge displays data.
Calculation Result: The bar gauge displays a calculated value based on the specified field.
All Values: The bar gauge displays all values of the specified field.
Function
If you set the Display Mode parameter to Calculation Result, you must select a function to query a calculated value based on the specified field.
For example, if you set the Function parameter to Maximum, the bar gauge displays the maximum value of the specified field in the results of all query statements.
Limit
If you set the Display Mode parameter to All Values, you can configure the Limit parameter to specify the number of bar charts that you want to display in the bar gauge.
Layout
The layout of the bar gauge.
Horizontal: The bar charts horizontally stretch from left to right.
If you set the Layout parameter to Horizontal, you can set the Minimum Width parameter to specify the minimum width of the bar charts.
Vertical: The bar charts vertically stretch from bottom to top.
If you set the Layout Mode parameter to Vertical, you can set the Minimum Height parameter to specify the minimum height of the bar charts.
Show Percentage
Specifies whether to display the percentage of the value of each bar in the maximum value.
Show Title
Specifies whether to display the title of each bar.
Style Settings section
Parameter
Description
Display Mode
The display mode of the bar gauge.
Gradient: The bar gauge is displayed based on multiple threshold levels.
Retro LCD: The bar gauge is split into small cells.
Basic: The bar gauge is displayed in a single color.
Show Blank Area
If you turn on Show Blank Area, the unfilled area of the bars is rendered as gray.
NoteThe feature is not applicable to Retro LCD display mode.
Minimum Scope
The minimum value of data that you want to display.
Maximum Scope
The maximum value of data that you want to display.
Value Font Color
The font color of the percentage value.
Value Font Size
The font size of the percentage value.
Title Font Size
The font size of the bar title.
Edge Shape
The edge shape of the bar.
Width
The width of the bar.
Background Color
The background color of the bar.
Configure Search & Analysis Settings section
Parameter
Description
Displayed Fields
The field whose values you want to display in the bar gauge.
Use Query Result
If you turn on Use Query Result, the Field of Maximum Value
field is displayed.
Threshold section
Parameter
Description
Threshold Mode
The display mode of the threshold value.
Threshold
The thresholds of numeric values.
If you set the Color Scheme parameter to Threshold and specify thresholds in the Threshold section, each bar chart is displayed in the corresponding color.
Value Mapping section
Parameter
Description
Mapping Value
The text or icon that is used to replace a specified value in the bar gauge.
For example, if you set the Value parameter to 200, the Mapping Type parameter to Text, and the Mapping Value parameter to Success, 200 in the bar gauge is replaced by Success.
Variable Replacement section
Parameter
Description
Variable Replacement
The settings of variable replacement. You can click AddVariable Replacement to add a filter of the Replace Variable type to a chart. After you configure the settings of variable replacement on the General Configurations tab, Simple Log Service adds a filter in the upper-left corner of the chart. You can select a value from the filter drop-down list. After you select a value, Simple Log Service automatically replaces the variable in the query statement of the chart with the variable value indicated by the value that you select, and performs a query and analysis operation. For more information, see Example 2: Configure variable replacement.
Documentation section
Parameter
Description
Add Documentation Link
The button that allows you to add custom document links and descriptions. The added document links are displayed in the upper-right corner of the chart.
Fields tab
You can configure custom display settings for the result of a single query statement or for a single column. For information about the parameters on the Fields tab, see Common Settings tab.
In this example, a query statement is executed to calculate the number of requests for each request method. The result of the query statement is displayed in a bar gauge (Pro). On the Fields tab, you can configure different colors for the bar charts. The following figure shows the bar gauge and the related settings.
A > POST indicates that the POST column in the result of Query Statement A is selected as the displayed field. The color of the corresponding bar chart is blue.
A > PUT indicates that the PUT column in the result of Query Statement A is selected as the displayed field. The color of the corresponding bar chart is green.
A > D indicates that the D column in the result of Query Statement A is selected as the displayed field. The color of the corresponding bar chart is yellow. DELETE is a keyword in SQL syntax and cannot be used as a column name in analytic statements. In this case, you can specify DELETE as the display name for the D column on the Fields tab.
A > GET indicates that the GET column in the result of Query Statement A is selected as the displayed field. The color of the corresponding bar chart is red.
A > HEAD indicates that the HEAD column in the result of Query Statement A is selected as the displayed field. The color of the corresponding bar chart is purple.
