You can specify users in your ServiceNow instance who will receive email notifications about errors and other events within the DataSync application. To configure notifications with your Perspectium solution, navigate to Perspectium > Control and Configuration > Error Notification.
Perspectium notifications are created as ServiceNow email notifications in order to send emails natively through the ServiceNow instance and some notification use notification email scripts for the email's subject and body content. See email notifications and notification email scripts for more information.
NOTE: Since these notifications use built-in ServiceNow functionality, you are able to view and change the notifications and their content from the default behavior. However this is only recommended for advanced users as changes may cause the notifications to not function properly.
The following notifications are included with the DataSync app:
| Name | Description |
|---|---|
| Perspectium Error | Notification when there is an error in the Perspectium Logs. When the DataSync application encounters an issue and logs an error, you can use this notification to be notified of this error. An example of an email created is as follows: Subject: Perspectium Error: perspectium - psp.out.replicator.queue_name Body: Instance: perspectium Name: psp.out.replicator.queue_name Value: 2020-10-28 20:08:26: Error getting metrics for queue psp.out.replicator.testqueue on https://<server>.perspectium.net/ |
| Perspectium Situation | Notification when a situation has occurred multiple times. Situations include old messages that haven't been posted to the Mesh and queue monitoring errors. The batch size is defined in Perspectium > Properties as described below. An example of an email created is as follows: Subject: Perspectium Situation Triggered: Perspectium Old Message Alert Body: Situation: messages that have been sitting in a outbound for more than the specified time |
| Perspectium Agent Error | Notification when the DataSync Agent encounters error processing records. The Agent will send back batches of errors and this notification will create an email that contains a list of records that errored, including the table the record belongs to, the record sys_id and the Agent's error message. An example of an email created is as follows: Subject: Perspectium DataSync Agent (psp_test_agent) Errors Body: Errors have occurred in the DataSync Agent when attempting to process the following records: Table: incident, Record: 72c645032f431010744b90bcf699b67c Error: SubscribeException: Invalid sys_id Table: incident, Record: 72c645032f431010744b90bcf699b67d Error: SubscripeException: Invalid sys_id For more information on the email content, see the psp_agent_error_script notification email script in your ServiceNow instance. |
| Perspectium Table Compare Discrepancies | Notification when Table Compare executes and there are discrepancies between the instance and the database the Agent is saving records to. Each time a Table Compare is executed, this notification will create an email that details any discrepancies found. An example of an email created is as follows: Subject: Perspectium Table Compare Discrepancies Body: Discrepancies found in the DataSync Agent database:
For more information on the email content, see the psp_table_compare_script notification email script in your ServiceNow instance. |
Subscribe to a notification
To subscribe to a Perspectium notificaton and receive emails when an event occurs, follow these steps:
Enable email sending
Navigate to System Mailboxes > Administration > Email Properties. In the upper left-hand corner of the form, check the Yes | No box under Email sending enabled to allow emails to be sent from your ServiceNow instance.
Select the notification to subscribe to
Navigate to Perspectium > Control and Configuration > Error Notification and open the notification you want to subscribe to.
Choose users who will receive error notification emails
Click the Who will receive tab. Then, click 
> 
next to Users to start adding users who will receive the notification emails.
NOTE: The users that you specify to receive email notifications for must have an email entered in the Email field of their User Profile (Username > Profile).
Save your notification changes
In the bottom left-hand corner of the form, click Update to save the changes for the Perspectium notification.
Sending error notifications in batches
In Perspectium Properties, you can specify whether you want to send error notification emails in batches and how frequently to send batched notification emails. Sending batched notification emails can be helpful if your ServiceNow instance is sending error notifications frequently.
To send error notifications in batches, follow these steps:
Create a Perspectium connection error notification
Navigate to Perspectium > Control and Configuration > Error Notification and click New. Type any Name for your error notification and choose a Table to send notifications for. Scroll down to the When to send tab, and select Event is fired from the Send when drop down. Then, select perspectium.connection.error.threshold from the Event name dropdown.
Choose users who will receive error notification emails
Click the Who will receive tab. Then, click > next to Users to start adding users who will receive batched connection error notification emails.
Save your new notification
In the bottom left-hand corner of the form, click Submit to save the settings for your Perspectium connection error notification.
Set your notification batch size and timing
Navigate to Perspectium > Control and Configuration > Properties. Scroll to the section labeled Send notification emails in batches of. In the box underneath this label, type a number to indicate the amount of notifications that will signify one batch. Next, scroll to the section labeled Send notification emails about connection errors in batches every and choose a time interval to send batched notifications in. Finally, click Save at the bottom of the page to save your Perspectium properties. Once these two properties are setup, your notifications will be emailed in batches at the specified intervals to the users you configured in Step #3.
NOTE: The notifications for Perspectium connection errors will be emailed in batches of 10 notifications every 30 minutes by default.
