Histogram Panel Type

Histogram

A Histogram is a plot chart that shows the frequency distribution of a set of measurements. This helps in identifying the distribution of data, skewness, etc.

This panel type allows users to create a chart where the data is grouped into buckets (such as “40 to 49”, “50 to 59”, etc.), and then plotted as bars. Similar to a Bar Graph, but in a Histogram, each bar represents a range of data. The panel type allows the user to control the number of bins, and will automatically calculate the size of each bin accordingly.

Data Formats

Support signals

  • Logs
  • Traces
  • Metrics

This panel type supports any time series data. The time series data can be from logs, traces, or metrics.

Examples

One Series

The following table shows the requests per second (req/s) for a service over a period of time.

Show table
TimestampValue
2024-06-06 00:27:0046.68333333333333
2024-06-06 00:28:0049.88333333333333
2024-06-06 00:29:0045.61666666666667
2024-06-06 00:30:0044.9
2024-06-06 00:31:0050.5
2024-06-06 00:32:0045.15
2024-06-06 00:33:0047.983333333333334
2024-06-06 00:34:0046.016666666666666
2024-06-06 00:35:0046.85
2024-06-06 00:36:0046
2024-06-06 00:37:0048.81666666666667
2024-06-06 00:38:0042.93333333333333
2024-06-06 00:39:0044.6
2024-06-06 00:40:0047.43333333333333
2024-06-06 00:41:0044.6
2024-06-06 00:42:0042.63333333333333
2024-06-06 00:43:0046.53333333333333
2024-06-06 00:44:0046.9
2024-06-06 00:45:0043.4
2024-06-06 00:46:0047.28333333333333
2024-06-06 00:47:0046.833333333333336
2024-06-06 00:48:0047.65
2024-06-06 00:49:0044.6
2024-06-06 00:50:0043.766666666666666
2024-06-06 00:51:0046.583333333333336
2024-06-06 00:52:0047.13333333333333
2024-06-06 00:53:0046.85
2024-06-06 00:54:0047.96666666666667
2024-06-06 00:55:0044.61666666666667

When configured to use 15 buckets, the chart is rendered as follows:

Histogram with one series and 15 buckets
Histogram with one series and 15 buckets.

Multiple Series

The following tables show the requests per second (RPS) by status code over time.

  1. Series with STATUS_CODE_UNSET
Show table for Series with STATUS_CODE_UNSET
TimestampValue
2024-06-06 00:38:0040.8
2024-06-06 00:39:0042.4
2024-06-06 00:40:0045.05
2024-06-06 00:41:0042.4
2024-06-06 00:42:0040.55
2024-06-06 00:43:0044.2
2024-06-06 00:44:0044.6
2024-06-06 00:45:0041.233333333333334
2024-06-06 00:46:0044.95
2024-06-06 00:47:0044.5
2024-06-06 00:48:0045.31666666666667
2024-06-06 00:49:0042.4
2024-06-06 00:50:0041.6
2024-06-06 00:51:0044.25
2024-06-06 00:52:0044.8
2024-06-06 00:53:0044.55
2024-06-06 00:54:0045.6
2024-06-06 00:55:0044.61666666666667
2024-06-06 00:56:0044.8
2024-06-06 00:57:0043.3
2024-06-06 00:58:0042.36666666666667
2024-06-06 00:59:0041.53333333333333
2024-06-06 01:00:0048
2024-06-06 01:01:0042.233333333333334
2024-06-06 01:02:0040.45
2024-06-06 01:03:0048.7
2024-06-06 01:04:0043.88333333333333
2024-06-06 01:05:0046.333333333333336
2024-06-06 01:06:0049.6
  1. Series with STATUS_CODE_ERROR
Show table for Series with STATUS_CODE_ERROR
TimestampValue
2024-06-06 00:38:002.1333333333333333
2024-06-06 00:39:002.2
2024-06-06 00:40:002.3833333333333333
2024-06-06 00:41:002.2
2024-06-06 00:42:002.0833333333333335
2024-06-06 00:43:002.3333333333333335
2024-06-06 00:44:002.3
2024-06-06 00:45:002.1666666666666665
2024-06-06 00:46:002.3333333333333335
2024-06-06 00:47:002.3333333333333335
2024-06-06 00:48:002.3333333333333335
2024-06-06 00:49:002.2
2024-06-06 00:50:002.1666666666666665
2024-06-06 00:51:002.3333333333333335
2024-06-06 00:52:002.3333333333333335
2024-06-06 00:53:002.3
2024-06-06 00:54:002.3666666666666667
2024-06-06 00:55:002.216666666666667
2024-06-06 00:56:002.3333333333333335
2024-06-06 00:57:002.2666666666666666
2024-06-06 00:58:002.2
2024-06-06 00:59:002.15
2024-06-06 01:00:002.5
2024-06-06 01:01:002.216666666666667
2024-06-06 01:02:002.1166666666666667
2024-06-06 01:03:002.533333333333333
2024-06-06 01:04:002.2666666666666666
2024-06-06 01:05:002.4166666666666665
2024-06-06 01:06:002.5833333333333335

When configured to use 15 buckets, the chart is rendered as follows:

Histogram with two series and 15 buckets
Histogram with two series and 15 buckets.
  1. Merging the multiple series into one Histogram

Multiple series can be merged into a Histogram using the option MERGE ALL SERIES INTO ONE from the right side of the panel configuration.

Histogram with two series merged into one and 15 buckets
Histogram with two series merged into one and 15 buckets.

Configuration

Number of Buckets

The number of buckets to create in the Histogram. The default value is 30.

Bucket Width

The size of the buckets. Automatic bucket sizing is applied by default.

Merging Series

This allows users to combine the values from multiple series into one Histogram.

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.