Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.

Performance Analytics properties

Log in to subscribe to topics and get notified when content changes.

Performance Analytics properties

These system properties control the behavior of Performance Analytics.

To configure properties, navigate to Performance Analytics > System > Properties or to sys_properties.list.

Collection cleanup properties

Several properties determine how long Performance Analytics scores and snapshots are maintained before the scheduled cleanup job deletes them.
Property Description
com.snc.pa.dc.keep_scores_for.frequency Maximum number of periods prior to today for which scores are collected and kept. The number of periods varies according to the score collection frequency, as follows: daily; weekly; bi-weekly; four weeks; monthly; bi-monthly; quarterly; fiscal quarterly; half-yearly; yearly; fiscal yearly

Scores older than this limit are not collected during data collection.

  • Type: String
  • Default value: 732;105;53;40;60;30;20;20;20;10;10
  • Location: Performance Analytics > System > Properties
com.snc.pa.dc.keep_snapshots_for.frequency Maximum number of periods prior to today for which lists of records (snapshots) related to a score are collected and kept. The number of periods varies according to the score collection frequency, as follows: daily; weekly; bi-weekly; four weeks; monthly; bi-monthly; quarterly; fiscal quarterly; half-yearly; yearly; fiscal yearly.
Snapshots older than this limit are not collected during data collection.
  • Type: String
  • Default value: 183;26;13;10;15;8;5;5;5;3;3
  • Location: Performance Analytics > System > Properties

Fiscal year properties

These properties set the year in Performance Analytics to match your company fiscal year.

Property Description
com.snc.pa.fy_start Start of the fiscal year of your company

Default color schemes

These properties set the default colors for the chart overall and for indicator targets.

Property Description
com.snc.pa.indicator_target_default_color_schema Default indicator target color scheme
com.snc.pa.chart_default_color_schema Default visualization color scheme

Breakdown and visualization properties

Most of these properties relate to breakdowns and how breakdowns are displayed in visualizations.

Property Description
com.snc.pa.scoresheet.max_elements Maximum number of elements of a breakdown that can be shown in a scoresheet
com.snc.pa_breakdown_element_cutoff Maximum number of elements that a breakdown can have for the elements without scores to be shown in an Analytics Hub. If the value of this parameter is exceeded, no scoreless elements are shown in the Analytics Hub.

Example: The value of the parameter is 10. Breakdown A has 8 elements. All 8 are shown in the Analytics Hub. Breakdown B has 12 elements, of which 5 have scores. Only those 5 elements are shown.

Notes:
  • This parameter does not affect whether unmatched elements are shown.
  • Both historical and real-time/live scores are counted when considering whether an element has a score.
  • If the element involves a formula with multiple scores, the element is considered to have a score if all parts of the formula have scores at any point in time. The formula is considered to have a score even if the result is invalid, such as a division by 0.
com.snc.pa.scorecards.max_breakdown_elements Maximum number of breakdown elements in Analytics Hub lists
com.snc.pa.scorecard.breakdown.chart.max_rows Number of breakdown elements in visualizations
com.snc.pa.thresholds.frequency_intervals_in_the_pa Maximum number of frequency intervals in the past that a threshold check job will analyze
com.snc.pa.scorecard.max_record_number Number of records to be loaded automatically on the records tab of a detailed Analytics Hub. 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.
com.snc.pa.breakdown_element_ui_max_records Deprecated in new Analytics Hub. Limit for the number of elements to be fetched for a breakdown. Default 100. Used for the lookup fields (breakdown dashboard, old detailed scorecard, etc.)
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

Chart properties

A chart refers here to a graphical component of a widget visualization or the Analytics Hub.

Property Description
com.snc.pa.default_chart_line_color Color of the scores in the Analytics Hub and widgets, including the trend line and bullet chart.
  • Format: RGBA
  • Default: 106,183,239,1
com.snc.pa.text.trendline_points_for.frequency Maximum number of points visible in the text analytics trend-line
com.snc.pa.defaut_chart_target_color Color of the target in a chart.
  • Format: Hexadecimal
  • Default: #666666
com.snc.pa.default_chart_personal_target_color The line color for personal targets displayed on Analytics Hubs.
  • Type: string
  • Default value: #BDC0C4
com.snc.pa.default_chart_threshold_color Color of the threshold in a chart.
  • Format: Hexadecimal
  • Default: #666666
com.snc.pa.default_chart_personal_threshold_color The line color for personal thresholds displayed on the Analytics Hub.
  • Type: string
  • Default value: #BDC0C4
com.snc.pa.default_chart_area_color() Color of first gradient area in a chart.
  • Format: RGBA
  • Default: 106,183,239,1
com.snc.pa.default_chart_area_color1 Color of second gradient area in a chart.
  • Format: RGBA
  • Default: 106,183,239,0
com.snc.pa.navigator_line_color Color of the Line in the chart navigator.
  • Format: RGBA.
  • Default: 106,183,239,1
com.snc.pa.navigator_area_color() Color of first gradient area in the chart navigator.
  • Format: RGBA.
  • Default: 204,204,204,0.25
com.snc.pa.navigator_area_color1 Color of second gradient area in the chart navigator.
  • Format: RGBA.
  • Default: 204,204,204,0.5
com.snc.pa.navigator_mask_fill_color Deprecated in new Analytics Hub. Mask fill color of the chart navigator.
  • Format: RGBA.
  • Default: 106,183,239,0.25
com.snc.pa.spark_line_width Pixel width of the chart line. Used only on the workbench widget.

Default: 1

com.snc.pa.scorecard.breakdown.chart.name_max_length Maximum number of element names on the legend in a breakdown widget.

Default: 27

Data collector properties

Data collector properties enable you to configure various limits for Performance Analytics data collection. The properties are configured to safeguard the data collection process. The default values are appropriate for most environments.

Property Description
com.snc.pa.dc.script_timeout The maximum time in seconds that a script is allowed to run during a data collection cycle, such as an indicator source script or a breakdown script.

This limit applies individually for each record processed by the data collection job. If a script exceeds this limit, the data collection job skips the current record.

If your scripts frequently reach the default limit, simplify the scripts as much as possible before modifying this property.

  • Type: integer
  • Default value: 30
com.snc.pa.dc.query_time_limit The maximum duration in minutes that a single query for a data collection job can run before a warning is logged.
  • Type: integer
  • Default value: 60
com.snc.pa.dc.max_row_count_indicator_source The maximum number of records that a job can collect from a single indicator source.
Warning: If the number of records that an indicator source contains is higher than the value of this property, no indicators are collected for this indicator source.

Increasing this value may cause data collection jobs to take longer to complete.

This limit applies separately to each indicator source included in a data collection job. The number of indicators associated with each indicator source does not affect this limit.

For example, if a data collection job collects scores for 12 indicators from three indicator sources, the job can collect a maximum of 150,000 records by default: 50,000 from each indicator source.

  • Type: integer
  • Default value: 50,000
com.snc.pa.dc.max_breakdown_elements_limit Maximum number of breakdown elements retrieved by data collection for each breakdown source. If a breakdown source has more elements than this property defines, it is disabled.

Increasing this limit increases the potential number of table insertions that are made for a data collection job. This increase may impact performance, depending on your database. Also, it may be difficult for users to access data for a specific breakdown element when there are many elements.

This limit applies separately to each breakdown source included in a data collection job. The number of breakdowns associated with each breakdown source does not affect this limit.

For example, if a data collection job collects scores for 12 breakdowns from three breakdown sources, the job can collect a maximum of 30,000 records by default: 10,000 from each breakdown source.

  • Type: integer
  • Default value: 10,000
com.snc.pa.dc.max_breakdown_elements_level2_limit Maximum number of breakdown elements resulting from the combination of two breakdowns for a data collection. For example, if the first-level breakdown has 10 elements, and the second-level breakdown has 5, 50 breakdown elements are collected.

Increasing this limit can cause data collection to use a large amount of memory which may impact performance.

Consider a first-level breakdown with the maximum of 10,000 elements. In this scenario, the second-level breakdown can specify at most 100 breakdown elements before reaching the default second-level limit of 1,000,000 total elements.

Note: This limit is also affected by the com.snc.pa.dc.max_breakdown_elements_limit property. For example, if the first-level breakdown has greater than 10,000 elements, the breakdown is disabled.
  • Type: integer
  • Default value: 1,000,000
com.snc.pa.dc.max_error_count The maximum number errors that may occur for a single data collection job run before data collection is stopped.

Errors during data collection usually occur due to an invalid script, or when encountering the script timeout limit.

Do not increase this value. If you encounter this limit, review any scripts that run during data collection to ensure that they are valid and perform as expected.

  • Type: integer
  • Default value: 500
com.snc.pa.dc.max_records Maximum number of records that are stored on the Snapshots [pa_snapshots] table during each data collection. This limit applies only when Collect records is selected for an indicator. This limit does not apply to scores.

Generally, the default limit provides enough detail into collected records. Increasing this limit may impact performance during data collection or when performing operations on the Snapshots table.

  • Type: integer
  • Default value: 5000
Feedback