Dashboard

 NOTE: This feature is only functional using an Integration Mesh with version 4.6.12+. Contact Perspectium Support if you have any questions about this feature or the version of the Integration Mesh your instance is connected to. 

In order to active this feature, follow these instructions:

1. Download and install any version of the DataSync Agent
   
   
2. Set up the Agent to connect to the same Integration Mesh credentials as the Perspectium application on your ServiceNow instance
   
   
3. Start/use the Agent which automatically start sending in heartbeats

Once this is set, the scheduled job will run every 10 minutes and automatically request heartbeats. You can install and run multiple independent agents.

Agent Status Descriptions:

Running: last heartbeat received is less than or equal to 30 minutes ago

Warning: last heartbeat received is greater than 30 minutes but less than 60 minutes ago

Down: last heartbeat received is greater than 60 minutes ago

On Finish Install after installing the Dashboard, Monitor and Track History will be enabled for all existing queues to track and show queue data in the dashboard. This is controlled by a PSP property in the Properties > Dashboard Properties module. You can change options for this feature as follows:

To disable/enable the Monitor and Track History for all queues:

1. Go to Perspectium > Properties > Dashboard Properties
   
   
2. Uncheck or check the Enable Track History for all queues (necessary for Perspectium Dashboard queue display) property
   
   
3. Click Save
   
   Note: You may be asked to fill in your Perspectium portal username and password in order to save.
   
   
4. Go to the Shared/Subscribed Queues module and observe how existing queues are updated based on the property value saved

To create a new queue when the Enable Track History property is ON:

1. Go to the Shared/Subscribed Queues module
   
   
2. Click New
   
   
3. Confirm that Monitor and Track History are enabled on the form
   
   Note: When Enable Track History is off, the new queue record form does not have Monitor and Track History on automatically

To uncheck Monitor and/or Track History on a queue form when Enable Track History is ON:

1. Go to the Shared/Subscribed Queues module
   
   
2. Click New or click on an existing queue
   
   
3. Confirm that Monitor and Track History are enabled on the form
   
   
4. Uncheck the Monitor and/or Track History checkboxes
   
   Note: You should see an info message to let you know that it's important to have these checked, since they are necessary to properly display Queue Status on your dashboard.

The Queue History table (u_psp_queue_history) stores the queue data shown in the dashboard and is rotated to minimize performance issues on your instance. The default rotation is set up for 8 rotations of 2 days each (16 days total of queue history data). You can adjust the rotation settings to change how much data is saved in this table and subsequently shown on the dashboard.

Total Daily Records: Displays the total record shares for the current day. 

Total Monthly Records: Displays the total record shares for the current month. 

 NOTE: Changing the date/month on the calendar does not affect this count.

Use this feature to get a breakdown of the number of records sent based on a selected date in the calendar.

Any time you access or reload the dashboard, the calendar date will reset to the current date.

You can change the date on the calendar using the available arrows or the dropdown settings.

The Records Sent/Day count reflects the number of records sent on the specific calendar date selected.

The Records Sent/Hour count is reflects the number of records sent in the the specific calendar date selected, divided by 24 hours. However, if the current date is selected, then this number is divided by the number of hours that have passed in that day so far. 

The Record Breakdown graph is a visualization of data based on the calendar date selected. It reflects both dynamic and bulk shares. Toggle between different data representation (records per hour, day, month, or lifetime).

 NOTE: Shares from additional related tables selected on a dynamic or bulk share (such as selecting the include attachments or include journal fields options) are not counted in the overall share count displayed on the dashboard. This includes additional shares from tables such as sys_attachment, sys_journal, and sys_audit.

This feature displays the most recent (up to 50) dynamic/bulk shares from you instance. You can click on any entry to access that specific record directly. 

 NOTE: Shares from additional tables are not counted in the overall share count displayed on the dashboard. This includes additional shares from tables such as sys_attachment, sys_journal, and sys_audit.

This feature displays the most recent inbound, outbound, and receipt messages that have an Error state. Click on any entry to access that message directly.

The Perspectium Dashboard Data scheduled job creates the instancedaily payload used to retrieve updated queue and recent shares information. This will run periodically every 5 minutes.