Breakdown and indicator Performance Analytics properties

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Breakdown and indicator Performance Analytics properties

    This document outlines key Performance Analytics properties available in ServiceNow Yokohama release (updated January 30, 2025) that configure limits and behaviors related to breakdown elements and indicators, primarily impacting visualization and data handling within Analytics Hub, KPI Details, and scorecards.

    Show full answer Show less

    Key Properties and Their Practical Use

    • Max breakdown elements in scoresheets (com.snc.pa.scoresheet.maxelements): Controls the maximum number of breakdown elements shown in a scoresheet, defaulting to 500.
    • Breakdown element cutoff (com.snc.pa.breakdownelementcutoff): Sets the maximum number of elements where scoreless elements (elements without scores based on defined conditions) are displayed in Analytics Hub and KPI Details, default 50. This helps optimize performance by limiting elements displayed.
    • Max breakdown elements in Analytics Hub lists (com.snc.pa.scorecards.maxbreakdownelements): Limits elements shown in lists with a default of 1000 and maximum enforced at 10,000. Customers should consider solution redesign if this limit is insufficient.
    • Max breakdown elements in visualizations (com.snc.pa.scorecard.breakdown.chart.maxrows): Defines how many breakdown elements appear in visual charts, defaulting to 10 for clarity and performance.
    • Threshold frequency intervals analyzed (com.snc.pa.thresholds.frequencyintervalsinthepastlimit): Limits the number of past frequency intervals used in threshold evaluations, with a default of 2.
    • Max records auto-loaded in Analytics Hub (com.snc.pa.scorecard.maxrecordnum): Controls the number of indicator records automatically loaded on the records tab; set at 50,000 by default. If exceeded, users must manually request loading to prevent performance issues.
    • Target batch operation limit (com.snc.pa.targetbatchoperationlimit): Applies to KPI Details, limiting bulk insert/update operations on targets to 100 to avoid timeouts. This can be adjusted if needed.
    • Max widget indicators (com.snc.pa.widget.maxwidgetindicators): Specifies the number of additional indicators allowed in a widget besides the main indicator; default is 7.
    • Widget visibility respecting ACLs (com.snc.pa.widgets.respectacl): Determines if widget visibility enforces ACLs on indicators and breakdowns. New instances default to true, while upgrades prior to Quebec default to false.

    Deprecated Properties

    • Breakdown element UI max records (com.snc.pa.breakdownelementuimaxrecords): Deprecated in Analytics Hub; previously limited elements fetched for breakdown lookups.

    Implications for ServiceNow Customers

    Understanding and configuring these properties enables customers to optimize Performance Analytics visualizations, prevent performance bottlenecks, and tailor data presentation to business needs. Adjusting limits such as maximum breakdown elements and record loading thresholds can improve user experience and system responsiveness. Customers facing timeouts or performance issues are advised to review and possibly reduce batch operation limits or redesign analytic solutions to fit within practical thresholds.

    These properties set limits on breakdown elements and indicators, mostly in the context of visualizations.

    Property Description
    com.snc.pa.scoresheet.max_elements Maximum number of breakdown elements of a breakdown that can be shown in a scoresheet

    Default: 500

    com.snc.pa.breakdown_element_cutoff

    Maximum number of elements that a breakdown can have where the Analytics Hub and KPI Details show its scoreless elements.

    An element is scoreless when it meets one of these conditions:
    • For real-time scores, the element has never had a score.

    • For a formula indicator, the element has never had a score in one or more of the contributing indicators.

    • For the collected scores of an automated indicator, the element has never had a score. However, if the number of elements that would still be displayed exceeds the com.snc.pa.breakdown_element_cutoff value, only the elements that have a score or change value on the selected date are displayed. For more information and examples, see Collected scores and com.snc.pa.breakdown_element_cutoff.

    Note:
    This parameter does not affect whether unmatched elements are shown.

    Default: 50

    com.snc.pa.scorecards.max_breakdown_elements

    Maximum number of breakdown elements in Analytics Hub lists

    Default: 1000

    Maximum: 10,000. Any value set above 10,000 is treated as 10,000.

    Tip:
    If this value is not high enough for your indicators, consider redesigning your Performance Analytics solution.
    com.snc.pa.scorecard.breakdown.chart.max_rows Number of breakdown elements in visualizations

    Default: 10

    com.snc.pa.thresholds.frequency_intervals_in_the_past_limit Maximum number of frequency intervals in the past that a threshold check job analyzes

    Default: 2

    com.snc.pa.scorecard.max_record_num

    Number of records to be loaded automatically on the records tab of the Analytics Hub for a single indicator. If the number of records exceeds the value of this property, records are not automatically loaded. In this case, the user is presented with a message and a button to load all records.

    Default: 50,000

    com.snc.pa.breakdown_element_ui_max_records

    Deprecated in Analytics Hub. Limit for the number of elements to be fetched for a breakdown. Used for the lookup fields (breakdown dashboard, old detailed scorecard, and so on.)

    Default: 100

    com.snc.pa.target_batch_operation_limit

    Applies only to KPI Details: The maximum number of targets that can be inserted or updated in one bulk action on the Targets Configuration page. If you face timeouts while inserting or updating targets in bulk, consider reducing this limit.

    Default: 100

    com.snc.pa.widget.max_widget_indicators Maximum number of widget indicators, in addition to the main indicator that can be added to a widget

    Default: 7

    com.snc.pa.widgets.respect_acl Restrict widget visibility following the ACLs of indicators and breakdowns. True|false.
    • Default on new instances: true
    • Default on upgraded instances from before Quebec: false