Notifications report

The Notifications report provides an overview of all notifications within the system, and can be used to monitor system activity during periods of load. The report contains data when the system is busy creating and delivering notifications.

  1. In the Reports menu, under Activity, click Notifications.
  2. On the Notifications Report, specify the time period for which you want to view notifications; i.e., do one of the following:
    1. Click one of the buttons indicating a time in minutes or hours.
    2. Click the Date Range button to specify a start and end date and time, and then click Search.

The Notification Delivery area displays five boxes, indicating the number of notifications in each of the possible delivery states. The numbers in each of the boxes may not add up to the expected total. This is because the "Responded" category is a count of the responses received, and does not necessarily reflect the number of notifications sent.

Notification Delivery area details
Status Box Description
Total

Number of notifications created and submitted for delivery during the specified time period.
Pending Number of that are being processed, but have not yet been delivered. For more information about the conditions required for a notification to appear in this state, see Pending Notifications report.
Delivered

Number of notifications that have been successfully delivered to a provider. minus the number of notifications for which a response has been received.

 

Note: As used throughout this report, the term "delivered" does not necessarily mean that a notification has been received on a specific user's device, nor does it mean that a user has seen or heard the message. In this case, "delivered" means that xMatters has successfully sent the message to a provider responsible for delivering the message to that specific device type.
Responded

Number of responses received for this event. This number may be different than the number in the "Delivered" total, as the total number of "Responded" includes call-in responses, web browser responses, and responses via mobile apps.

Failed Number of notifications that could not be delivered (all attempts, including retries, have failed).

To view more information about the notifications in each status, click one of the boxes; xMatters displays a new report listing all of the notifications in that category. For example, if you click on the Delivered box, xMatters displays the Delivered Notifications report:

The Notifications reports list the notification details in separate columns; note that not all of the reports have the same columns, as explained in the following table.

Notification Delivery area details
Column Description
Company

Name of the company for which the notification was generated.

Note that this column only appears for Super Administrators.
User The name and target name of the user targeted by the notification.
Event The event ID of the event that generated the notification. Click the link in this column to view the event properties (for more information, see Event Properties Report).
Domain

The event domain associated with the notification. Note: With the exception of some legacy and system messages, all notifications are sent via the applications domain.
Device The device targeted by the notification. Each device type is represented by a different icon, and that you can mouse over the icon to view the device name.
Delivery

Date and time at which a "Provider Delivered" response was received for this notification. .

This column does not appear on the Pending or Failed Notifications reports.
Elapsed Time Available only on the Pending Notifications report; indicates the length of time since the notification was created. For more information about notifications on this report, see Pending Notifications Report.
Failed

The time and date at which the notification passed the maximum number of allowable retries.

This column appears only on the Failed Notifications report.
Response Time

The time and date at which a response was received for this notification.

This column does not appear on the Pending or Failed Notifications reports.
Response

The response returned by the user. The value in this column depends on the possible responses configured in the event domain.

This column does not appear on the Pending or Failed Notifications reports.

You can reorder report results by clicking on column headings. An arrow next to the column heading indicates whether the results are sorted in ascending or descending order.

You can filter the notification results in any of the following ways:

  • To view only the notifications for a specific domain, click the Domain list, and then select one of the available domains. Click Search to regenerate the report. (With the exception of some legacy and system messages, all notifications are sent via the applications domain.)
  • To view only those notifications that were targeted to a specific device type, click the Device drop-down list, and then select one of the available device types. Click Search to regenerate the report.
  • To change the time span for the results, modify the start and end date and time fields, and then click Search.

To export the report results to a Microsoft Excel Spreadsheet, click Export. xMatters will copy the information to a .xls file and save it to your computer.

Pending Notifications report

A notification will be included and displayed on the report when it meets the following conditions:

  • The related event must be active in the system.
  • The notification must have been created; i.e., the delivery services must be properly configured and the notification must have been identified as a non-duplicate.

A notification is removed from the report under the following conditions:

  • The notification is delivered to the provider, usually signified by the provider returning a "Provider Delivered " status update. In the rare event that no status update is received, the notification is removed from the Pending list if the user responds.
  • The notification has passed the maximum number of allowable retries.
  • The notification is archived. By default, xMatters archives runtime data after seven days, and purges archived data 21 days after archiving it.