You can specify users in your ServiceNow instance who will receive email notifications about errors and other issues with the DataSync application. To configure email notifications about errors with your Perspectium solution, navigate to Perspectium > Control and Configuration > Error Notification. The default Perspectium errors that you can configure notifications for are:
- Perspectium Error: Be notified when there is a Perspectium error that is critical, change the filter to tailor your notifications
- Perspectium Situation: Be notified when there is any situation, critical or not, that results in a connection error to the Perspectium Mesh
- Perspectium Agent Error: Be notified
- Perspectium Table Compare Discrepancies: Be notified
| 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. |
| 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. |
| 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. The email body is as follows: 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. The email body is as follows: 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. |
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).
To learn more about how to configure error notifications, see create a messaging 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:
Enable email sending
Log into your ServiceNow instance and 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.
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 Perspectium connection error 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.
