Collect Spotlight scores

A single Spotlight job collects scores for all active Spotlight groups. You can execute this job manually. An administrator can have it execute automatically according to a schedule.

Before you begin

  • Ensure that the Spotlight groups for which you want to collect scores are activated. On the Spotlight Group form of each group, Active must be selected.
  • Ensure that you have correctly set whether to collect scores from a snapshot or to collect real-time scores.
  • If you are collecting scores from a snapshot, ensure that a Performance Analytics data collection job has run for the Main indicator of each Spotlight group.

For more information, see Create a spotlight group.

Role required: admin (to set up schedule), pa_spotlight (to run manually)

About this task

Any user with the pa_spotlight role can manually run a job to collect scores. Navigate to Spotlight > Spotlight Job and click Execute now.
Important: When you collect scores, all previously created Snapshot records are deleted for all Snapshot groups.

An administrator can set up a schedule to collect scores automatically, as follows:


  1. Navigate to Spotlight > Spotlight Job.
  2. Select Active.
    Fields appear for scheduling the Spotlight job.
  3. In the Run field, select the frequency with which the Spotlight job runs.
    Different scheduling fields appear depending on the run frequency that you select.
  4. Fill in the scheduling fields, such as Time.
    If you have any Spotlight groups that use snapshots of the data, consider trying to schedule the Spotlight group job shortly after the data collection jobs for the main indicators of those groups.
  5. (Optional) You can select Condition and add a script that specifies further conditions when the Spotlight job runs.
  6. (Optional) You can customize the script that the Spotlight job runs.