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) can contain 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.

Bar gauge

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 Mode The layout of the bar gauge.
    • Horizontal: The bar charts horizontally stretch from left to right.

      If you set the Layout Mode 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.
  • 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.
    Note The 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.
  • Configure Query and Analysis section
    Parameter Description
    Displayed Field The field whose values you want to display in the bar gauge.
  • Threshold section
    Parameter Description
    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.

  • Mapping Value 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.

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.
Bar gauge (Pro)