Create a gauge visualization

  • Release version: Washingtondc
  • Updated August 1, 2024
  • 5 minutes to read

    • A gauge visualization shows where a value lies between expected minimum and maximum values. Use the gauge visualization to follow progress with color-coded value ranges.

    Before you begin

    Role required: Anyone with access to data can create a visualization of that data on a dashboard that they own. Users with the itil, report_user, admin, or viz_creator role can create a visualization in the Visualization Designer. If you create a visualization in the Visualization Designer, it is saved to the Library. For more information on access, see Report_view access control and Platform Analytics roles.

    About this task

    For information about the use of a Gauge visualization in a dashboard, see the Developer Site. This site gives information about Gauge data visualization components in the UI Builder, and some configuration options may differ from the Visualization Designer.

    Procedure

    1. Navigate to All > Platform Analytics > Library > Data Visualizations.
    2. Select New.
    3. Select the Gauge (Gauge icon) visualization type.
    4. Configure the Header and border. Header and border options are the same for all data sources.
      Header and border fields Description
      Show header The visualization header, including title and icons.
      Show header separator Option to display a line separating the header from the rest of the component.
      Chart title Title of the visualization.
      Description A short overview about the visualization that the end user sees.
      Wrap title Option to wrap long titles onto a second line. If false, displays an ellipsis to truncate long titles.
      Show border Option to display a line around the component.
      Bare Option to remove padding around data visualization to provide more compact positioning on the page. Only available when Show border is turned off.
    5. Choose a data source.
      For general descriptions of the data sources, see Data sources for data visualizations.

      • Table (available in the base system). When you select a table, you can filter it by custom or preconfigured conditions. Custom conditions can include questions or Service Catalog variables.

        Configured report sources appear in the Predefined conditions list. For more information, see Report sources.

        To help you create a custom filter, there is a preview list of records that would be included in the visualization. You can change which fields are shown as columns and the width of columns in the list actions.
        Preview record list for table source data visualization with list actions shown.
      • Indicator (available in the base system). When you select an indicator as a data source, you can select a breakdown and one or several elements for filtering the results. If an element filter is set on the breakdown source, that element filter is available in the elements field. However, data visualizations support element filters only for automated indicators with the Count, Minimize, or Maximize aggregations. For more information, see Element filters.
      • Usage Insights (available with the User Experience PAR Integration application, to users with a required role). Choose one of up to three KPIs included with this application, depending on the visualization type. For more information, see User Experience Analytics data sources for visualizations.
    6. Select the options for your data source.
    7. Under Presentation, provide display and color information.
      Field Description

      Display settings

      Gauge arc angle

      Choice of sizes for the gauge, in degrees.
      Value label size

      Characters that represent dynamic sizes: small (S), medium (M), or large (L). The actual size of the type changes in proportion to the size of the chart.
      Inner radius Specify the ratio of the visualization's inner radius to the outer. Allowed values are 0.7–0.95.
      Show data table Shows a table with chart and graph data for easier screen reader access. Data includes the percentage of the total for each value, when appropriate.

      Range
      Min value Set the lowest value shown on the visualization. If not specified, zero is the default.
      Max value Set the highest value shown on the visualization.
      Configure ranges Specify the number of ranges to divide the gauge into; default 3. You select the number of ranges, the start and end values of each range, the labels, and the color spectrum.

      Legend (Available with the latest Data Visualizations application from the ServiceNow® Store)
      Show legend Option to display the legend. Activated automatically at 400% zoom.
      Legend position Legend location relative to the chart: Above, Below, Right, or Left
      Legend orientation Options for how to display the register.
      • Horizontal horizontal: Option to display the legend horizontally.
      • Vertical vertical: Option to display the legend vertically up to five lines.

      This property applies only when Legend position is Below.
      Horizontal alignment

      Horizontal alignment of elements in the legend: Start, Center, or End
      Max legend item width, px

      Number of pixels after which the item in the legend is truncated.
      Labels
      Score label [scoreLabel]
      The label of the score in the center of the gauge:
      • No label (None)
      • The same label as the visualization metric (Metric label)
      • The label that you set for the range that the score falls into, in Configure ranges (Range label)

      Labels are disabled and replaced by legends at 400% zoom.
      Show range limit [showRangeLimit] When true, the limits that you configured for the ranges are shown. If you did not configure any ranges, the default min and max values are shown.
      Show range labels [showRangeLabels] When true, any labels you configured for ranges are shown. This property is available only if you configured ranges and specified labels for them.
      Show label as primary Available when the score label is configured as Range label. Changes the places of the score value and label to make the score value small and emphasize the range value.
    8. Under Chart interaction, set what if anything happens when a viewer clicks a chart or a chart segment on the visualization.
      Field Description
      Allow chart interaction Enable an event to occur when a user clicks in a chart or one of its segments.
      Action Choose the event that occurs when a user clicks in a chart or one of its segments. Choices depend on the visualization type and data source. Applies only when Allow chart interaction [chartInteractionEnabled] is true.
      • Go to data view opens the records view in a Core UI list or KPI Details relevant to the associated segment or visualization. Records do not open in Workspace embedded lists.

        Not supported for Usage Insights data sources.

      • Go to URL opens the specified URL, which can be on the instance or external. You have the option of specifying a page name to appear in the tooltip, for those visualizations with tooltips.
    9. Select Save to continue editing the visualization, or Save and close to return to the Analytics Overview main screen.

    What to do next