System Queue Monitor

Form ID: (SM302010)

You use this form to monitor statuses of the queues for push notifications, business event, and commerce push notifications.

Attention:

In cluster environments, this form displays queue data from all nodes of the cluster.

Form Toolbar

The form toolbar and More menu include the buttons and commands described below.


Element	Description
Refresh Statistics	Refreshes queue data statistics on click.
Show Errors	Opens the Errors dialog box where you can review the list of errors occurred during processing of the selected queue.
Clear Queue	Clears the selected queue.
Restart Dispatcher	Restarts services that are processing records in the selected queue.
Notification Settings	Opens the Notification Settings dialog box, where you can turn on notifications about the growth of the system queue (which are sent when a threshold is reached) or review the notification settings.
Statistics Settings	Opens the Statistics Settings dialog box, where you can configure for how long to keep statistics and specify log settings for different queue types.

Errors Dialog Box

You use this dialog box to view the list of errors occurred during processing of the selected queue.

Attention:

The system logs processing errors if the value of the api:push-notifications:enable-dead-message-log key is set to True in the web.config file. You add the key to the <appSettings> section of the file as follows:

<add key="api:push-notifications:enable-dead-message-log" value="True" />

Table 1. Errors Dialog Box: Table Toolbar
The table toolbar includes the buttons described below.
Button	Description
Delete All	Deletes all error records in the table.
Show Source Data	Opens the Source Data dialog box, where you can view details of the notification whose processing raised an error.

Table 2. Errors Dialog Box: Table Columns
Column	Description
Destination ID	The internal identifier of a destination defined for the notification on the Push Notifications (SM302000) form.
Notification Source	The identifier of a generic inquiry defined for the notification on the Push Notifications (SM302000) or Business Events (SM302050) form.
Internal Source Event	The details of the notification whose processing raised an error.
Error	The description of an error.
Date	The date and time of an error occurrence.

Notification Settings Dialog Box

You use this dialog box to review or specify the settings of the notifications about the growth of different queues, which are sent when a threshold is reached. This dialog box opens when you click Notification Settings on the form toolbar.

Table 3. Notification Settings Dialog BoxThe dialog box has the following elements.
Element	Description
Queue Type	Specifies the particular queue type which notifications should be configured. There are three types available: Push Notifications, Business Events, Commerce.
Notification Threshold (% of Maximum Queue Size)	The notification threshold, which is defined as the percent of the maximum queue size. If the number of messages in the queue exceeds this threshold and at least one check box is selected in the Send section, the system sends a notification by using the notification template specified in the respective Template box. The default threshold is 50%.
Send Notifications By Email	A check box that indicates (if selected) that the system sends notifications about system queue growth by email. You can select a template for the email notifications in the Template box that is right of this check box. By default, the check box is cleared.
Template	The template to be used for the email notification. This type of template can be created and edited on the Email Templates (SM204003) form. By default, the predefined System queue exceeded size threshold notification template is used.
Send Notifications By Mobile SMS	A check box that indicates (if selected) that the system sends mobile SMS notifications about system queue growth. You can select a template for the mobile SMS notifications in the Template box that is right of this check box. By default, the check box is cleared.
Template	The template to be used for the mobile SMS notification. This type of template can be created and edited on the Mobile Notifications (SM204004) form. By default, the predefined System queue exceeded size threshold notification template is used.
Send Notifications By Push	A check box that indicates (if selected) that the system sends mobile push notifications about system queue growth. You can select a template for the mobile push notifications in the Template box that is right of this check box. By default, the check box is cleared.
Template	The template to be used for the mobile push notification. This type of template can be created and edited on the Mobile Notifications (SM204004) form. By default, the predefined System queue exceeded size threshold notification template is used.

Table 4. Notification Settings Dialog Box: ButtonsThe dialog box has the following buttons.
Button	Description
OK	Saves the notifications settings and closes the dialog box.
Cancel	Closes the dialog box without saving the notification settings.

Statistics Settings Dialog Box

You use this dialog box to specify for how long the system should keep statistics and logs for a queue type and whether it should log trigger details. This dialog box opens when you click Statistics Settings on the form toolbar.

Table 5. Statistics Settings Dialog Box: Summary AreaThe summary area of the dialog box has the following elements.
Element	Description
Keep Statistics and Logs for (Days)	The number of days the system should keep statistics and long processing logs in database. The records that are older than the specified period will be removed automatically. If you do not need to keep the statistics at all, specify 0 value in the box.
Log Trigger Details	A check box that indicates (if selected), that the system will save detailed statistics for the selected queue type. You can view the details by clicking a link in the Date column of the table on the Statistics by Hour or Statistics by Minute tabs.

Table 6. Statistics Settings Dialog Box: Log Settings per Queue Type AreaThe log settings area of the dialog box has the following elements.
Element	Description
Queue Type	Specifies the particular queue type which notifications should be configured. There are three types available: Push Notifications, Business Events, Commerce.
Processing Time Threshold (s)	The processing time threshold in seconds, set to 2 second by default. If processing time of a record exceeds this value the system saves the processing details.
Number of Records in Detailed Log	The number of log events to be logged during processing of a transaction. The log is to be displayed in the Queue Processing Log dialog box that you open by clicking a link in the Date column from the table below.

Table 7. Statistics Settings Dialog Box: ButtonsThe dialog box has the following buttons.
Button	Description
Save	Saves the statistics and log settings and closes the dialog box.
Cancel	Closes the dialog box without saving the statistics and log settings.

Summary Area

In this area, you can select a queue type to clear queues and restart dispatchers for the selected queue type.

Tip:

To reduce clutter and keep you focused on queues that are currently operational, the form hides the queues that have been inactive for 24 hours or longer.


Element	Description
Queue Name	A read-only box that displays the name of the queue that was generated by the queue service for the website during the site installation.
Current Node	A check box that indicates if the queue belongs to the current node.
Queue Type	There are three types available: Push Notifications, Business Events, Commerce.
Status	A read-only box that displays the processing status of a queue which can be either OK or Invalid. The system displays a warning with an error details, in case of the Invalid status.
Messages	A read-only box that displays the current number of records in the queue.
Queue Size, KB	Current and maximum queue size. By default, the maximum size is of a queue is limited by 100 MB, which is the recommended size of the queue. If the current queue size reaches 80% of the limit, the system displays a warning that limit will be exceeded soon. You can use this parameter to monitor the queue growing size.
Last Response	A date and time when the queue sent back statistics. The system retrieves queue data every minute. To fetch queue data on demand, click Refresh Statistics in the form toolbar.
Node ID	The identifier of the node to which the queue belongs.

Statistics Tabs

You use this tab to view statistics of a queue type selected in the Summary area. There are two tabs where statistics is grouped by hours and by minute, that include the same list of parameters that is described in the table below.

Table 8. Table Toolbar
The table toolbar includes the buttons described below.
Button	Description
Clear Statistics	Clears the statistics for the selected queue.

Table 9. Table Columns
Column	Description
Date	Time interval rounded by an hour or by minute, listed in descending order. You can click the link in the column to open the Trigger Details dialog box. If the Log Trigger Details is selected for the queue type, the dialog box will display the detailed statistics, otherwise the dialog box will display no details.
Queued	The number of messages came to the queue within the selected period of time.
Processed	The number of messages processed by the dispatcher within the selected period of time
Max. Queue Size (KB)	Maximum size of a queue for the selected period of time.
Avg Processing Time (ms)	Average processing time within the selected period of time.
Max Processing Time (ms)	Maximum processing time within the selected period of time.

Trigger Details Dialog Box

You use this dialog box to review detailed statistics about the source of incoming messages in the queue within the period of time selected in the Date column on the Statistics by Hour or Statistics by Minute tab. You can change the time period using the From and To boxes.

Attention:

Details are logged only if the Log Trigger Details check box is selected on the Statistics Settings dialog box.

Table 10. Trigger Details Dialog Box: Summary Elements
Element	Description
From	The start time of the time period rounded to hour.
To	The end time of the time period rounded to hour.

Table 11. Trigger Details Dialog Box: Triggering Fields Tab
Column	Description
Handler Definition	A definition of a handler that triggered the messages (generic inquiry or business event).
Field	The field name that triggered the messages within the selected period of time.
Messages	The number of messages triggered within the selected period of time

Table 12. Trigger Details Dialog Box: Source DACs Tab
Column	Description
Screen	An identifier of a screen which was the source of transaction.
DAC	The name of a DAC which was the source of transaction.
Messages	The number of messages triggered within the selected period of time

Performance Issues Tab

You use this tab to review the processing details for queues whose processing time exceeds the specified threshold.

Table 13. Table Toolbar
The table toolbar includes the buttons described below.
Button	Description
Clear Logs	Removes the saved logs for the selected queue.

Table 14. Table Columns
Element	Description
Date	Time interval rounded by an hour, listed in descending order.
Processing Time	The processing time of the queue within the selected period of time.
Queries	Queries involved in the processing.