Number Panel Type | SigNoz Docs

Number

Number panels are used to display a single value of a metric, APM, or log.

Data Formats

Supported signals

Logs
Traces
Metrics

This panel type supports any time series data that can be aggregated to a single value. The time series data can be from logs, traces, or metrics.

Setup

The following graph shows the combined average requests per second (req/s) for all services over a period of time.

*Number panel for req/s over period of time.*

Configuration

Choose the signal type (logs, traces, metrics)
Choose the metric, APM, or log to display
- Metric: see the Metrics query builder documentation to configure metric query
- Log: see the Logs query builder documentation to configure log query
- Trace: see the Traces query builder documentation to configure trace query
Reduce: choose the function to reduce the data (e.g. avg, sum, max, min, or latest). This step aggregates the data over the selected time period and returns a single value. For example, if you have a request rate over a period of time, the avg function will return the average of per-minute request rate over the period.

Configuration Options

Visualization

Time range (formerly "Panel Time Preference"): Override the global dashboard time range for this panel. Keep Global Time to follow the dashboard time picker, or choose a fixed time range.

Formatting & Units

Unit: The unit of the displayed value (for example, Bytes, Percent, Requests/s). The default is None.
Decimal places (formerly "Decimal precision"): Choose how many decimals to show from compact tiles: 0, 1, 2, 3, 4, or Full (the raw value, unrounded). A live Shows as preview beneath the tiles displays a sample value formatted at the selected precision (for example 1,234.56 at 2). The default is 2.

When you create a new panel, the Unit is pre-filled with the unit of the selected metric, so the value matches how the metric was reported. If you choose a unit that is incompatible with the unit the metric was sent with, a warning icon appears on the unit selector. Hover the icon to see a tooltip explaining the mismatch and the unit the metric was sent with.

One value, one query

A Number panel shows a single value, so it renders only the first enabled query. If more than one query is enabled, an amber warning icon appears on the panel, in both the editor preview and the rendered dashboard tile. Hovering the icon shows: "This panel shows a single value, but more than one query is enabled. Disable the queries you don't want to display, keeping only the one whose value you want to show." Disable the extra queries to clear the warning.

A Number panel backed by a PromQL query reduces the resulting series to its last data point and displays that single value. For rate-style expressions such as rate(...), "last" is the most recent evaluated point, not an average over the window. If you want a different aggregate, wrap the expression in a range function such as avg_over_time(...) so the query itself returns the value you want to display.

Actions

Select Create alert to open the alert editor in a new tab, with this panel's query pre-filled.

Context Links

Add context links to enable click-through navigation from the panel to other dashboards, external URLs, or filtered views. See Interactivity for details.

Thresholds

Thresholds highlight the displayed value when it crosses a limit you set. Each saved threshold appears as a summary row, for example > 500 ms · Red background.

Select Add threshold to open the threshold editor. It is titled New threshold when you add one and Edit threshold when you change one. It offers:

When the value is: Pick the comparison from tiles that show the math symbol, such as >, <, or =.
Value and Unit: Set side by side in one row. The unit list matches the panel's units, and a mismatch with the panel unit shows a warning.
Color: Pick a swatch, or use the custom-color swatch at the end to enter any color.
Apply color to: Background or Text. A live preview on the sample number 512 updates as you choose.

Select Save to keep the threshold, or Cancel (formerly "Discard") to drop your edits.

Threshold edits preview live as you type, and thresholds carry over when you change the panel's visualization type. See Panel editor behavior.

On a Number panel, the threshold's comparison operator and value also seed the condition when you create an alert from the panel, and the panel's Reduce To setting seeds the alert occurrence.

Get Help

If you need help with the steps in this topic, please reach out to us on SigNoz Community Slack. If you are a SigNoz Cloud user, please use in product chat support located at the bottom right corner of your SigNoz instance or contact us at cloud-support@signoz.io.