Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Histogram reports

Histograms group numbers in a data set into ranges. The data used in a histogram is continuous data. Continuous data is measured whereas discrete data, which is used in bar charts, is counted.

For example, a histogram can show the pattern of P1 incidents logged over a four-week period after a product release. For the first week after the product was released, P1 incidents are low because users do not really understand the product enough to use it. In the second week, more users start working with the product and P1 issues increased. In the third week, P1 issues increase even more as more users began working with the product. In the fourth week, P1 issues stay the same as the third week. The information suggests that it is not necessary to increase support staff until the third week after a product is released.

Note: When accessibility is enabled, this visualization includes a report that screen readers can interpret. For more information, see Enabling accessibility features.

Image omitted: histo-report-ex.png
Histogram Report example

Parent Topic:Report types

Create a histogram report

Histograms group numbers in a continuous data set into ranges.

Before you begin

Roles required: itil, report_user, report_group, report_global, report_admin, or admin. To create a meaningful report, you must have the right to access the data you want to report on.

Procedure

  1. Navigate to All > Platform Analytics > Library > Data Visualizations and select New.

  2. On the Data tab, give the report a name that reflects the information being grouped.

  3. Select the applicable source for the report.

Data sourceAlso called a report source, a data source is a table with filters applied to provide a single source of information for all users. For more information, see Report sources.Note: If you select a data source used by existing reports, a notification prompts you to view them.
TableThe raw data from a table with no filters applied. When you select a table, its short description appears below the table name. For trend reporting, you can also select a remote table, which aggregates, in memory, data retrieved from an external source. Then select a Trend by field option to aggregate its data. To learn more about remote tables, see Retrieving external data using remote tables and scripts
External importChoose an existing imported report source, or select the Upload icon \(
Image omitted: upload-icon.png
Upload icon\) to import a new file. See <a href="../create-report-with-imported-data-source/">Create a Core UI report from an imported Microsoft Excel document</a>.
MetricBaseMetricBase enables you to collect, retain, analyze, and visualize custom time series data on the ServiceNow AI Platform. For more information, see MetricBase.
  1. On the Type tab, enter Histogram in the filter, select the report type, and click Next.

    The application shows a preliminary version of the report. To view the updated report at any time, select Run.

  2. On the Configure tab, fill in the following fields and select Next.

FieldDescription
Configure function fieldConfigure fields based on calculation of multiple inputs including arithmetic functions. For more information, see Report on function fields. Function field results are calculated when the report is run. You can use the results for aggregations and grouping. You have to save the report before you can configure function fields.Configured function fields appear in the Group by and Additional group by lists after you save the report.
Measured bySelect a field to report against. The values from this field appear on the X axis of the histogram and determine the width of the bars. Select the info icon
Image omitted: icon-info.png
No alternative text supplied
for a description of the selected field.
  1. To limit the information displayed in the report, select the filter icon (
Image omitted: List\_FilterIcon.png
Filter icon\) and specify conditions to filter the report data.
To learn how to construct conditions, see [Condition builder](../../platform-user-interface/c_ConditionBuilder.md).

**Note:** In aggregated and list reports, language-dependent filter conditions may return zero results on localized instances.
  1. Select Save to continue editing the visualization, or Save and close to return to the Analytics Overview main screen.

What to do next

  • Select the Report info icon (
Image omitted: Form\_ReferenceLookupIcon.png
Info icon\) and add a description of the report.
  • Select the sharing icon (
Image omitted: ShareIcon.png
Sharing icon\) to open the **Sharing** menu. On this menu, you can add the report to a dashboard, export the report to PDF, publish the report to the web, and set visibility and schedules.