All Events report
The All Events report gives you a window into past events, providing you with access to more of your xMatters data to support root cause analyses, address compliance requirements, and other important processes. It runs on our xMatters data warehouse, which allows us to greatly extend data retention and allows you to enjoy improved visibility into your xMatters data via the report.
A quick word about your data...
When we launched the data warehouse, we seeded it with whatever information was available in your system at the time, so your initial experience with the All Events report will be unique to you and your system. Going forward, the data warehouse will retain all of your event data, along with historical on-call and notification history. This means that the All Events report continues to grow in functionality and depth of presentable data, but also limits visibility to that data based on your pricing plan so you only pay for the data you need.
All Events report fields and features
When you open the All Events report, you'll notice the event data is displayed a little differently than the Recent Events report:
The All Events report includes the following fields:
|
Column |
Description |
|
Event ID |
The unique event identifier created when the event was initiated. |
|
Message Subject |
The subject of the email message sent from the event. |
|
Date Started |
The date and time when the event began. |
| Initiator |
The name of the integration or the ID of the person who initiated the event. If initiated by a person, clicking the initiator's name opens their profile card and contact information. |
Recent Events report vs. All Events report
The Activity menu contains links to both the All Events and Recent Events reports.
But which report should you use? Well, that depends on what information you want to see:
- For information on currently live events, or events within the last 30 days, the Recent Events report provides the same robust information you've always used.
- For information on all events that occurred in your system over a defined time frame, use the All Events report.
Arrange the report
To more easily view data in the report, do one or more of the following:
- To sort the content of a column in alphabetical or chronological order, click the column header. (Click the header again to reverse the sort order.)
- To change the width of a column, move the pointer over the edge of the column and when the re-size icon appears, click and drag the column to the desired size.
- To rearrange the columns, click and drag a column header to a new location on the table.
- If the list contains more entries or columns than can be displayed on your screen, scroll horizontally or vertically. The system automatically loads more data as scroll down the page.
Overview and Message tabs
Clicking the Event ID displays the event Overview and Message tabs.
The Overview tab shows you general overview information about the event and includes the following fields:
|
Column |
Description |
|
Event ID |
The unique identifier created when the event was initiated. |
|
Status |
The status of the event. Status options are:
|
|
Duration |
The elapsed time of the event.
|
| Start | The date and time when the event started. |
| End | The date and time when the event completed. If an event is either active or suspended, the End field is not displayed. |
| Initiator | The name of the integration or ID of the person who initiated the event. |
The Message tab displays the initial message that was sent out when the event was triggered.
Search events by date
The All Events report displays events for a specific time frame. You can search by a number of days (Past 30 Days, Past 60 Days, or Past 90 Days), or specify a date and time range using the calendar and time pickers. The All Events report dynamically updates as you set the search parameters.
If you search by a date range the report returns all events that were initiated within that time range. This does not include events that were initiated outside of the time frame, but are active during the specified time frame.
For example: You set a date range of October 1, 2018 - November 1, 2018. An event triggered on September 30 that is still active on October 1 is not displayed.
As the data warehouse continues to collect more events from your system, the All Events report will provide more robust information. Your visibility into that data is based on your pricing plan so you only pay for the data you need. If you search over a time frame that's longer than your pricing plan provides, the All Events report displays a message to let you know.
Search events by initiator or message subject
To search for events by initiator or message subject, use the Search bar. As you type (a minimum of two letters), xMatters displays a drop-down list of matching properties. You can select items from the list to use as search criteria. xMatters then adds a capsule to the search bar that represents this search criteria.
As you add search criteria, the All Events report automatically updates the results to display only the events that match your criteria. The report also highlights the part of each event that matches your search terms.
Include system events in searches
System events are initiated by xMatters, and include device validations, SMS confirmations and deactivations, error responses, temporary absence notifications, and voice recording calls. System Events are not included in search results by default. To include system events, click the Include System Events check box.
If you navigate away from the All Events report when the system events are included, the system events remain in the report when you come back the All Events report page.
Refresh the All Events report
Once you've set the search parameters, the All Events report maintains the initial results without refreshing. To refresh the page, while preserving your search criteria, click the Refresh icon.
