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.do.

Note: Only the properties on the Performance Analytics Properties page are described here. The sys_properties.list page contains other properties that affect Performance Analytics. For more information, see Available system properties.

Collection cleanup Performance Analytics 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.

Note: This property can be overridden on individual indicators.
  • 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.

Note: This property can be overridden on individual indicators.
  • Type: String
  • Default value: 183;26;13;10;15;8;5;5;5;3;3
  • Location: Performance Analytics > System > Properties

Fiscal year Performance Analytics 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

Range: 1 (January) - 12 (December)

Default: 1

Default color scheme Performance Analytics properties

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

Default: 3 color traffic light

com.snc.pa.chart_default_color_schema Default visualization color scheme

Default: Default UI14

Breakdown and indicator Performance Analytics properties

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

Chart properties for Performance Analytics

A chart refers here to a graphical component of a Performance Analytics widget or the Analytics Hub. These properties apply only to the Core UI, not visualizations in configurable workspaces.

Data collector Performance Analytics 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.

Note: Try not to increase these values beyond what is necessary. Depending on your implementation, increases in these values may impact performance. If possible, consult a domain expert or implementation partner, who may be able to find an alternative solution to increasing the property value.

Collected scores and com.snc.pa.breakdown_element_cutoff

The elements of a breakdown that the Analytics Hub and KPI Details display for a selected date depend on the number of elements and the value of com.snc.pa.breakdown_element_cutoff.

In general, when the number of elements for a breakdown exceeds com.snc.pa.breakdown_element_cutoff, the Analytics Hub and KPI Details display only the elements that have ever had a score.

For a formula indicator, the elements that have ever had a score for all the contributing automated indicators are displayed. These scores do not need to be on the same date. The requirement is only that for each contributing indicator, on some date, there was a score for the element.

For collected scores of an automated indicator—that is, for all scores other than real-time scores—there are two behaviors:
  • If the number of elements that have ever had a score is less than the limit set in com.snc.pa.breakdown_element_cutoff, all of these elements are listed for any selected date. Elements that do not have a score for the selected date are still listed for that date. This behavior is the same as the behavior for real-time scores.
  • If the number of elements that have ever had a score is greater than the limit set in com.snc.pa.breakdown_element_cutoff, only elements that have a score or a Change value for a selected date are listed for that date. Elements that do not have a score or Change value for that date are not listed regardless of whether they have a score for any other date.
Tip:

To prevent elements with null scores appearing in the Analytics Hub or KPI Details for automated indicators, consider setting a low value for com.snc.pa.breakdown_element_cutoff, such as 0 or 1. Elements with null scores may still appear however for real-time scores and formula indicators.

Example: Scores appearing for automated indicators with different values of com.snc.pa.breakdown_element_cutoff

This example uses KPI Details to explore the Assignment Group breakdown for the "Number of open incidents" indicator. The Assignment Group breakdown on the instance used in the example has just under 50 elements.

First is the default case, where com.snc.pa.breakdown_element_cutoff=50. This value is higher than the number of elements of Assignment Group. Therefore, for any selected date, all elements of the breakdown group are displayed.

All elements of the Assignment Group breakdown being displayed.

The next case is where com.snc.pa.breakdown_element_cutoff=10. The number of elements in the Assignment Group breakdown far exceeds this value. However, only eight elements have ever had a score. This number is less than the cutoff value of 10, so for any date, all eight elements are shown, even when null.

All elements of Assignment Group that ever had a score being displayed.

Finally, there is the case where com.snc.pa.breakdown_element_cutoff=5. This number is less than the number of elements that have ever had a score. Now only the elements with a non-null value or a change value on the selected date are shown on that date. Different elements are thus shown for different dates.

Only non-null and changed elements of Assignment Group being shown for each date.

Note:

The Analytics Settings Manager element is shown for March 7 despite having a null value. It is shown because it had a value of 5 for the previous collection period and thus has a change value of -5 for March 7.

Number of Open Incidents with Assignment Group: Analytics Settings Managers at zero for today and 5 for yesterday.