Example: Incident Spotlight

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 1 minute to read
  • This example describes the settings in the Incident Spotlight group, which is included in the Incident Spotlight Platform Analytics Solution. The example includes the results of a Spotlight job and the details of a resulting Spotlight record.

    The Incident Spotlight solution includes the Spotlight group Incident Spotlight. This group uses the indicator Number of open incidents and has a threshold of 1000. Because the Number of open incidents indicator uses the incident facts table as its source, the Spotlight job evaluates records in that table.

    The Incident Spotlight group has a job scheduled to execute every day at 1500. Set the group to Active for the job to execute according to the schedule.


    Details of the Incident Spotlight group
    The Incident Spotlight group has Spotlight Criteria related to:
    • How long the incident has been open
    • How long since the incident has been updated
    • Whether the incident has a description
    • Whether the incident has been reassigned more than three times
    • Whether the priority of the incident is Low or Moderate. (Critical and High priority incidents are not expected to require Spotlight.)

    Each criterion is assigned a weight, which varies in this case from 1 for a priority of P4 Low to 1000 for not being updated for more than 30 days.

    When a data evaluation job executes, it evaluates the records of the incident facts table. Each record is given a score equal to the sum of the weights of the criteria that the record meets. The job generates a Spotlight for each incident record with a score that meets or exceeds the group threshold of 1000.


    List of spotlights showing total weight of spotlight criteria that were met.

    Clicking an information icon for a Spotlight shows the details of which criteria contributed to the score. For example, Incident INC0007001 met the following Spotlight criteria:

    Criteria Weight
    Incidents older than 28 days 25
    Incidents older than 14 days 25
    Open incidents not updated 30 days 1,000
    Incidents older than 7 days 25
    Incidents older than 90 days 25
    Open incidents not updated 5 days 100
    TOTAL SCORE: 1,200
    The results of the Spotlight job are visible on the Incident dashboard, which is in the Spotlight group. This dashboard is identical to the interactive analysis of the Incident Spotlight group.
    The Incident dashboard in the Spotlight group