A network path alert profile is a set of conditions that define the limits of acceptable performance for a network path. Each condition is based on a specific network performance metric; for example, network connectivity, utilized capacity, and QoS changes. If a condition is violated, indicating unacceptable performance, or a violated condition is cleared, an alert is triggered. APM indicates all alerts on its performance charts and in its logs. If configured, it will also notify you by email and/or generate an SNMP notification.

You can choose from a number of system-defined alert profiles or create your own. One or more alert profiles can be applied to a network path but only one can be active on the path at a given time. The time range that an alert profile is active on a path for can be specified. By default, it is always active.

Related topics:

View alert profiles

To view existing network path alert profiles:

  1. Navigate to > Manage Alert Profiles > Network Path.
  2. Click the network path alert profile you are interested in.
    • The conditions associated with the profile are displayed to the right.

Apply alert profiles

In order to generate an alert when network path performance is outside of acceptable limits, an alert profile must be applied to the network path. Once an alert profile is applied to a network path, the monitoring point continuously monitors the path for unacceptable performance as defined by the alert profile. All activity is reflected in the network path performance charts in APM.

Note: When selecting an alert profile, the list of available profiles depends on the Target Type, Instrumentation (Dual-ended or Single-ended), and QoS Settings fields in the network path configuration. If all conditions in a profile are not applicable to the Target Type, Instrumentation, and QoS Settings fields, the profile is filtered from the list.

Apply an alert profile to a network path

You can apply an alert profile to a network path either when you are creating a network path or when you are modifying an existing path. In either case, you can apply either a system-defined or a custom alert profile.

To apply an alert profile to an existing network path:

  1. Navigate to Delivery > Network Paths.
  2. For the network path you want to apply an alert profile to, select > Configure.
  3. Click Next.
  4. In the Alert Settings field, select the Alert Profile you want to apply to the path.
  5. Click Save.
    • The alert profile is applied to the network path and a diagnostic is run to evaluate path performance against the new profile.

Apply multiple alert profiles to a network path

In some cases it is desirable to use different alert profiles on a network path at different times of day. To accommodate this, you must first define the time ranges that you want to use. Once this is done, you can apply different alert profiles to specific time ranges for a given network path. You can do this either when you are creating a network path or when you are modifying an existing path. In either case, you can apply either a system-defined or a custom alert profile.

Note: If there are gaps in the time ranges applied, no alerts will be generated during the gap times. If time ranges overlap, there is an order of precedence that determines which profile is used.

To apply multiple alert profiles to an existing network path:

  1. Navigate to Delivery > Network Paths.
  2. For the network path you want to apply an alert profile to, select > Configure.
  3. Click Next.
  4. In the Alert Settings field, select the Time Range and the Alert Profile you want to apply to the path for that time range.
  5. Click and repeat for each Time Range and Alert Profile you want to use.
  6. Click Save.
    • The alert profile is applied to the network path and a diagnostic is run to evaluate path performance against the new profile.

Apply an alert profile to multiple network paths

Once network paths are configured, you can apply either system-defined or custom alert profiles to multiple paths at once.

To apply an alert profile to multiple network paths:

  1. Navigate to Delivery > Network Paths.
  2. Select the network paths you want to apply an alert profile to.
  3. Click the Action dropdown and select Alert Settings.
  4. Select the Time Range and the Alert Profile you want to apply to the paths for that time range.
  5. Click Preview to confirm the changes.
  6. Click OK to apply the changes.
    • The alert profiles are applied to the network paths and a diagnostic is run to evaluate path performance against the new profiles.

Note: When applying an alert profile to multiple paths, the list of applicable profiles is not filtered so it is possible to apply an invalid profile to a path. If you do this you will receive an error when you preview the changes.

Remove an alert profile from a network path

At least one alert profile is required on a network path. If more than one are applied, all but one of them can be removed.

To remove an alert profile from an existing path:

  1. Navigate to Delivery > Network Paths.
  2. For the network path you want to remove an alert profile from, select > Configure.
  3. Click Next.
  4. In the Alert Settings field, for the Time Range / Alert Profile pair you want to remove, click next to the pair.
    1.Repeat for each Time Range / Alert Profile pair you want to remove.
  5. Click Save to save the updated configuration.

Custom alert profiles

If you can’t find a system-defined alert profile to suit your needs, you can create a custom profile from a variety of available conditions.

Before you create a profile, it’s helpful to know the Target Type, Instrumentation (Dual-ended or Single-ended), and QoS Settings for the paths you’ll apply it to as this affects which conditions to include. For example, a MOS condition is not applicable to a path with Target Type ‘Server: WAN Webserver’ because MOS is a voice condition and ‘Server: WAN Webserver’ is a data-only target. Therefore, the profile will be filtered from the drop-down when you try to apply it. Likewise:

  • Data conditions: data loss, data jitter, total capacity, available capacity, and utilized capacity
  • Voice conditions: voice loss, voice jitter, and MOS
  • Dual-ended path conditions: total capacity symmetry, and conditions with directional components
  • QoS conditions: QoS change
  • General conditions: connectivity, route change, latency, and RTT
    • These can be applied to any path.

If the Target Type for your path is set to Auto, you can use both data and voice conditions.

Create a custom alert profile

To create a custom alert profile:

  1. Navigate to > Manage Alert Profiles > Network Path.
  2. Click New.
    • The New Alert Profile page appears.
  3. In the Alert Name field, specify the name of the alert profile you are creating.
  4. In the Select Condition field, select the performance parameter you want to monitor.
  5. In the Path Direction field, specify the direction(s) to monitor (this only applies to dual-ended paths).
  6. In the Violates When field, specify what triggers an alert.
  7. In the Clears When field, specify what clears the alert.
  8. Click Add Condition to add the condition to the profile.
    • Add more conditions to the profile if required.
  9. Click Create to save the profile.

Create a custom alert profile based on an existing profile

To create a custom alert profile based on an existing one:

  1. Navigate to > Manage Alert Profiles > Network Path.
  2. Select the profile you want to base the new one on.
  3. Click Copy.
    • A copy of the selected alert profile is created.
  4. In the Alert Name field, specify the name of the alert profile you are creating.
  5. Edit the profile as required.
  6. Click Create to save the profile.

Edit a custom alert profile

To edit a custom alert profile:

  1. Navigate to > Manage Alert Profiles > Network Path.
  2. Select the profile from the Custom Alert Profiles list.
  3. Click Edit.
    • Add conditions to the profile by specifying the condition and clicking Add Condition.
    • Modify an existing condition by selecting the condition, modifying it, then clicking Replace Condition.
    • Remove conditions from the profile by clicking next to the condition you want to remove.
  4. Click Update to save your changes.

Delete a custom alert profile

To delete a custom alert profile:

  1. Navigate to > Manage Alert Profiles > Network Path.
  2. Select the profile to delete from the Custom Alert Profiles list.
  3. Click Delete.
  4. Click OK to delete the alert profile.

Note: You will receive a warning message if you try to delete a custom alert profile that is applied to a network path.

Alert time ranges

By default, when an alert profile is applied to a network path it is always active. In cases where you want a profile to be valid only for a specified time period (for example, to have different alert profiles in effect at different times of the day) you must first create a time range. Then, when you apply an alert profile to a network path, you can select the time range it is valid for.

Note: Time ranges are based on the monitoring point time zone setting. If the monitoring point time zone is incorrect, your alert conditions won’t be applied at the time you intended.

Overlapping time ranges

When applying multiple alert profiles to a network path, time ranges with the same frequency (e.g daily, weekly, etc.) and period (e.g 00:00-24:00) cannot overlap. For example, time ranges of Friday 08:00-17:00 and Friday 16:00-18:00 cannot both be used on the same network path because they overlap.

You can, however, apply multiple alert profiles to a network path when the time ranges have different frequencies. In this case, an order of precedence determines which profile is applied: yearly time ranges supersede monthly, monthly supersedes weekly, and weekly supersedes daily. For example, take a range recurring monthly on the 15th from 16:00-18:00, and a range recurring weekly on Friday’s from 16:00-18:00. In this case, when the 15th day of the month is a Friday there is an overlap. In this instance, the alert profile associated with the monthly time range takes effect.

Note: ‘Always’ and ‘Daily’ are considered overlapping and so they cannot be applied concurrently.

Gaps in time ranges

If you apply multiple alert profiles to a network path by specifying a different time range for each profile, take care not to leave gaps in the time ranges as no alerts will be generated during the times when no profile is active.

Create a time range

To create a time range:

  1. Navigate to > Manage Time Ranges.
  2. Click Add Time Range.
  3. In the Name field, enter a name for the time range.
  4. In the Start Time and End Time fields, enter the time using a 24-hour clock (e.g. 17:00 equals 5:00 PM).
  5. In the Frequency field, select how often the time range occurs.
  6. In the On field, specify the days the time frame occurs on.
  7. Click Save to save the time range.

Copy a time range

To copy a time range:

  1. Navigate to > Manage Time Ranges.
  2. For the time range you want to copy, click > Copy.
  3. Update the configuration as appropriate.
  4. Click Save to save the new time range.

Rename a time range

To rename a time range:

  1. Navigate to > Manage Time Ranges.
  2. For the time range you want to rename, click > Rename.
  3. In the Name field, enter the new name.
  4. Click Save to save the renamed time range.

Delete a time range

If you delete a time range that is assigned to a network path, the time range and its corresponding alert profile are removed from the path; if no other profile/time-ranges are assigned, then the last applied alert profile is paired with the default time range: ‘Always’.

To delete a time range:

  1. Navigate to > Manage Time Ranges.
  2. For the time range you want to delete, click > Delete.
  3. Click OK to delete the time range.

Alert profile conditions

The following conditions are available for network path alert profiles:

  • Connectivity:* Triggered when the source monitoring point is not receiving responses from the target.
  • QoS Change: Triggered when QoS markings are altered by a network device. See Alerting on QoS Changes for details on how QoS changes are detected.
  • Route Change: Triggered when the route to/from the target changes multiple times over a specified time period.
  • Latency: Triggered when latency is greater than a specified threshold for a specified time period.
  • RTT: Triggered when Round-trip time (RTT) is greater than a specified threshold for a specified time period.
  • Data Loss: Triggered when Data Loss is greater than a specified % threshold for a specified time period.
  • Data Jitter: Triggered when Data Jitter is greater than a specified threshold for a specified time period.
  • Total Capacity (Mbps): Triggered when Total Capacity is less than a specified threshold for a specified time period.
  • Available Capacity (Mbps): Triggered when Available Capacity is less than a specified threshold for a specified time period.
  • Available Capacity (%): Triggered when Available Capacity is less than a specified % threshold for a specified time period.
  • Utilized Capacity (Mbps): Triggered when Utilized Capacity is less than a specified threshold for a specified time period.
  • Utilized Capacity (%): Triggered when Utilized Capacity is less than a specified % threshold for a specified time period.
  • Total Capacity Symmetry (Mbps): Triggered when the difference in Total Capacity in each direction is greater than a specified threshold for a specified time period. This is only applicable to a dual-ended path.
  • Total Capacity Symmetry (%): Triggered when the difference in Total Capacity in each direction is greater than a specified % threshold for a specified time period. This is only applicable to a dual-ended path.
  • Voice Loss: Triggered when Voice Loss is greater than a specified % threshold for a specified time period.
  • Voice Jitter: Triggered when Voice Jitter is greater than a specified threshold for a specified time period.
  • MOS: Triggered when MOS is less than a specified threshold for a specified time period.

The Connectivity condition monitors the monitoring point’s connection to the target. It does not monitor the monitoring point’s connection to APM. APM continually monitors monitoring point availability so no additional alert condition is required. Loss of connection to the target is marked by a red circle in the Events chart, indicating the violation of an alert condition. Loss of connection to APM is denoted by a purple circle .