A network path event is an indicator that something about a path has changed. Events include: condition violation and clear, Monitoring Point availability changes, diagnostic test completions, route changes, packet captures, and ISP changes.

All events for all paths in an organization are logged and retained for seven days. If you have email notifications enabled, you will receive an email notification for events you are interested in. In addition, you can see a summary of all events on the Events chart.

Network path events indicate changes to conditions on a network path that exceed alert thresholds. For example, network changes (routing change to a different AS), and violated or cleared alert conditions are network path events. APM stores these events in the Delivery event log and, once logged, there are a number of actions you can perform to locate the ones you are looking for. Actions include view, find, filter, and sort.

View events

You can view logged event details for all network paths in an organization or for a specific network path.

Condition violation and clear events are triggered based on alert profiles. For these events, it is useful to understand some of the boundary conditions affecting them and how alert evaluation periods work.

View network path event details for all network paths

To view network path event details for the past seven days on all network paths:

  1. Navigate to Delivery > Events.
    • The network path events are listed in reverse chronological order (newest first) by default.
    • Network path status is indicated by the status icon in the left-most column. Note: This status is the current status, not the status of the path at the time of the event.

View network path event details for a specific network path

To view network path event details for the past seven days on a specific network path:

  1. Navigate to Delivery > Network Paths.
  2. Click the network path you are interested in.
  3. Click the Events tab.
    • The network path events page for the selected network path is displayed.

Alerts - things to know

There are a few things that are useful to know about how alerts work:

  • If an alert profile time range expires while a condition is in violation, the condition is cleared and a ‘threshold suppressed’ entry is added to the event log.
  • Violations that occur while a Monitoring Point is disconnected from APM don’t raise an event until the connection is restored.

Alert evaluation periods

In general, a condition is violated when it is outside a configured limit for a specified period of time and is cleared when it returns to an acceptable value for another period of time. The time periods specified for a given condition (the evaluation periods) are used to confirm that the condition is persistent for that time before declaring a violation or clear event.

The following diagram shows how this works. In this case the evaluation period is five minutes. The condition is violated twice but the first time it was not violated long enough to trigger an alert. The second violation did last for more than five minutes so an alert was triggered.

pv-alert-eval.png

Find events

Network path events can be searched for using a search string. The search looks at content in the Network Path Name and Description columns on the Events page. Searches can be combined with filters to narrow the search.

To find events:

  1. Navigate to Delivery > Events.
  2. In the search field, enter the search string.
    • Events matching the search string are listed.
    • Click “=” to invert the search.
    • Click “x” to remove the search string.
    • To refine the search, you can add another search string by repeating these steps.

Filter events

A filtering mechanism is available to help narrow a search. Multiple filters can be combined together and with a search string for even further granularity.

To filter events:

  1. Navigate to Delivery > Events.
  2. Click the search field.
  3. Click Event Type.
  4. Select a filter.
    • Objects matching the filter type are listed.
  5. Select one or more of the filter objects listed.
    • Events matching the selected filter objects are listed.
    • Click “=” to invert the filter.
    • Click “x” to remove the filter.
    • To refine what you are filtering, you can add another filter by repeating these steps.

Sort events

Lists of events can be sorted based on data in any column on the Events page except the Description column.

To sort a list of events:

  1. Navigate to Delivery > Events.
  2. Click the heading of the column you want to sort by.
    • The events are sorted by the column you selected.
  3. Click the heading again to reverse the sort order.