Filter the events report
The events report displays a list of events that match the search criteria. You can use search options to refine this list and display only the events that match your criteria, such as events that targeted specific users or events that occurred during a particular time frame.
Once you have developed a search filter that you like, you can save it and share it with others. For more information about saving and managing event report searches, see Save and manage events report searches.
You can export information about the displayed events to an Excel spreadsheet. If you filtered the event report based on specific properties, the properties and their values will also be exported in the spreadsheet file. For more information about exporting events, see Export events.
The events report can display the events that were initiated during a specific time frame. This does not include events that are active during the specified time frame but were initiated outside of the time frame. For example, if you choose to display events for the Past 15 minutes, the events report will not display an event that was initiated 45 minutes ago but is still active.
To search events by date:
- Click the Search button.
- To search for recently initiated events, click All Dates and select the corresponding time frame (Past 15 minutes, Past 1 hour, Past 6 hours, or Past 12 hours)
- To search for events that occurred during a specific time frame, click the All Dates and then select Date Range.
- In the calendar pickers, select the start date and time and the end date and time of the time frame you want to display.
- The events report is dynamically updated as you manipulate the calendar picker.
To search for events that were delivered to specific recipients, or to search for events with specific event properties, begin typing part of any event recipient or property name in the search bar. As you type (a minimum of two letters), xMatters displays a drop-down list of properties that match what you have typed. You can click one of the items in the list to add that item as a search criteria. xMatters then adds a capsule to the search bar that represents this search criteria.
As you add search criteria, the events report automatically updates the results to display only the events that match your criteria. The report also adds any matching properties to the Properties column, and highlights the part of each event that matches your search results.
To further refine your search, do any of the following:
- Click the search bar and start typing to select another option from the drop-down list and create another capsule.
- Click the right half of a capsule to edit the search criteria. Note that you can only have one capsule for each of the available items in the drop-down list, but you can have multiple capsules that search for the same term in different item properties.
- Click the left half of a capsule and then press Delete to remove a criteria.
System events include events that are initiated by xMatters, such as device validations, SMS confirmations and deactivations, error responses, temporary replacement notifications, and voice recording calls.
To include system events in the events report:
- Click Options.
- Select Include System Events.
Completed events are no longer active in xMatters. They may have run for their specified duration or may have been manually terminated.
To include completed events in the events report:
- Click Options.
- Select Include Completed Events.
You can view events that have been archived. By default, xMatters archives data after seven days, and purges archived data 21 days after archiving it. When you view archived events the other events are excluded from the results. In other words, active events are not displayed.
To view only archived events:
- Click Options.
- Select Select from Archive.
- The events report displays only events that have been archived.
You can combine various search filters. You cannot use more than one instance of a search criteria but you can use combinations of different search criteria.
For example, you can search for all events sent to the Operations group within a certain date range, but you cannot search for events that were sent to the Operations group and Mary McBride.