OBSERVABILITY PLATFORM
Stat chart

Visualize large statistic numbers with stat charts

Classic dashboards have their own panels and methods of configuring them. For details about panels in classic dashboards, see Classic dashboard panels.

A stat chart visualizes statistic numbers returned by a query. The chart depicts a value based on the results of the defined query. You can optionally add a sparkline chart that displays under the value, in addition to displaying a message when the value hits a defined threshold.

To create a Stat chart or learn more about the configuration options common to all panels, see Panels.

Stat chart queries

Stat charts use one or more queries to retrieve data to visualize. Stat charts use the following query Options to refine the displayed information, depending on your Datasource:

  • Series naming: Select a method to filter for metrics:

    • Labels require a Naming pattern. Use {{ label_name }} to include a label value. For example, {{ env }} will be replaced with values like staging-1, prod-1.
    • Regex: Use a regular expression in the Regex text field to match a time series. You can also use a Naming pattern to rename series using capture groups.
  • Type: The PromQL query type: Instant, or Range.
  • Downsampling strategy: Select a downsampling strategy to apply to and modify the raw query.

  • Truncation strategy: Truncation strategy to apply to the query. This modifies the raw query.

Configure a stat chart

You can configure a stat chart by modifying its Settings.

Any changes you make in the panel’s Settings tab are immediately reflected in the Preview pane, but take effect only when you click Apply in the Edit panel interface and then Save the dashboard.

See Modify a stat chart’s properties for a list of the settings you can modify.

Observability Platform doesn’t fully support directly editing a panel’s JSON representation and recommends configuring panels in the user interface. Use the JSON representation only for managing your configuration as code with tools such as Chronoctl and Terraform.

Modify a stat chart’s properties

The Misc section in a table’s Settings tab defines how the stat interprets and displays the panel’s query results.

  • Sparkline: Enables a sparkline visualization that displays under the value generated by the defined query.
  • Font size: Controls the size of the font for the displayed value.
  • Series Name: Controls whether or not the time series name displays.

Modify a stat chart’s units and formatting

The Unit and formatting section changes the display of units on the chart.

  • Unit: Defines the unit used to render the Y axis. This has the most significant effect when you enable Abbreviate. Defaults to Decimal.

    • Decimal: Base 10 values. Observability Platform renders a value of 1000000 as 1M.

    • Bytes: As decimal multiple-byte units. Observability Platform renders a value of 1000000 as 1MB.

    • Time: Determines the unit of time that Observability Platform uses to interpret a numeric value.

    • Percent: Interprets the value as a percentile, representing 0% to 100% on a range of either 0.0 to 1.0 (Percent (0.0-1.0)) or 0 and 100 (Percent (0-100)).

      For example, Observability Platform renders a value of 1.0 in Percent (0.0-1.0) as 100%, and in Percent (0-100) as 1%.

  • Decimals: Defines how many decimal places Observability Platform renders for values. Default renders decimal places only if necessary and rounds to the nearest value. Numeric values from 0 to 4 render the corresponding number of decimal places.

  • Abbreviate: Toggles whether to abbreviate the stat’s numeric value. For example, if enabled, Observability Platform renders a value of 100000000 as 100M. You can toggle this setting only if you set the Unit to Decimal or Bytes. Time units are always abbreviated and Percent values don’t require it. Defaults to true.

Modify a stat chart’s thresholds

The Thresholds section in a stat chart’s Settings tab defines values where Observability Platform renders each threshold range. You can define threshold values for stat charts as absolute numeric values.

You can enter a message in the Base settings section to display in the panel, without defining a threshold. You’re able to enter an independent message for each threshold you define.

To create a new threshold value:

  1. Click the plus sign (+) in the Thresholds section header.

  2. In the field that displays, enter a value where you want Observability Platform to end the previous threshold range and begin the next range.

  3. Optional: Click the color indicator, depicted as a colored square with text, to open a color selector and choose a color for the threshold.

  4. Optional: Click the caret (>) to expand the threshold definition, and enter text in the Message field to display on the chart if the threshold is met.

    To display only the text from the Message field, click the Show only message toggle.

  5. In the Edit panel dialog, click Apply to save your changes.

  6. After you’ve finished editing the panel, click Save on the dashboard to save your changes.

To delete a threshold value, click the caret (>) to expand the threshold definition, and then click the Delete icon on its corresponding row of the Thresholds section.