Application Health Agent Templates

Application Health agents monitor the new traffic on the network, as well as traffic that is classified into default categories. The specific agents in this category are described in the table below.

Note: You can configure green, yellow, and red thresholds by entering values for just the green and red threshold parameters. The yellow threshold is not a settable parameter—it is the range between the green and red threshold values, and is shown in the table below just for reference.

Agent Template Name	Default Agent Name	Description
Default Traffic	Inbound Default Traffic, Outbound Default Traffic	Agents based on the Default Traffic template monitor the rate (avg-bps) of a Default traffic class, and can alert you when the amount of traffic not classified (falling into Default) is too great. A change in the status of this agent will create a report showing detailed information on the specified class over the most current interval. This agent can only be assigned to default traffic classes, such as /Inbound/Default or /Outbound/HTTP/Default. Agent Parameters ClassName: Name of the Default class to be monitored RedThreshold: Percent of parent partition's bandwidth that gets classified into the Default class (ClassName); when the rate of ClassName exceeds the RedThreshold, the agent will have a red status GreenThreshold: Percent of parent partition's bandwidth that gets classfiied into ClassName; when the rate of ClassName is less than the GreenThreshold, the agent will have a green status Inbound Default Traffic and Outbound Default Traffic are default agents. Default parameter values are as follows: Red > 15% of parent partition size is classed into ClassName Yellow 7-15% (implied) Green < 7% Evaluation interval: 1 minute Action Fle Variables $className, $avg-bps, $class-id Example
New Application	na	An agent based on the New Application template can alert you when the PacketShaper auto-discovers new applications during the evaluation interval. This agent will return a score value from 0-99999, equal to the number of new auto-discovered classes in the evaluation interval (one day, by default). The red incident report will list the names of all the classes auto-discovered during the interval; a green incident report is not generated. Each unit or PolicyCenter configuration can have only one instance of a New Application agent. Note: When discovery is disabled during an interval, the New Application agent's score value will be zero. Therefore, this agent will not work as intended unless traffic discovery is enabled. Agent Parameters RedThreshold: Number of new applications discovered; when the number of new classes auto-discovered during the interval exceeds the RedThreshold, the agent will have a red status. GreenThreshold: Number of new applications discovered; when the number of new classes auto-discovered during the interval is less than or equal to the GreenThreshold, the agent will have a green status. Default parameter values are as follows: Red > 0 Green <= 0 Evaluation interval: 1440 minutes Action File Variables none Example
High Bandwidth New App	High Bandwidth New App	An agent based on the High Bandwidth New App template monitors classes that were auto-discovered during the interval, evaluating the amount of bandwidth they are using (avg-bps). This agent can help prevent new applications from consuming too much bandwidth and will create a report when the class crosses a threshold. This agent calculates the amount of bandwidth a newly discovered class is using, as a percentage of the class' parent partition. Typically, the parent partition is either Inbound or Outbound (the link size). But a parent partition isn't restricted to Inbound or Outbound. It can also be a class, such as a subnet class, that has its own partition and has traffic discovery within the class enabled. Each unit or PolicyCenter configuration can have only one instance of a High Bandwidth New App agent. Note: When discovery is disabled during an interval, the High Bandwidth New App agent's score value will be zero. Therefore, this agent will not work as intended unless traffic discovery is enabled. Agent Parameters RedThreshold: Percent of parent partition's bandwidth; when the rate of any classes auto-discovered during the evaluation interval exceeds the RedThreshold, the agent will have a red status GreenThreshold: Percent of parent partition's bandwidth; when the rate of any newly auto-discovered classes is less than the GreenThreshold, the agent will have a green status The High Bandwidth New App agent is one of the default agents. The default values for the parameters are: Green < 5% of the parent partition Yellow 5-10% of the parent partition (implied) Red > 10% of the parent partition Evaluation interval: 60 minutes Action File Variables $namelist, $avg-bps Example

Agent Template Name

Default Agent Name

Description

Default Traffic

Inbound Default Traffic,

Outbound Default Traffic

Agents based on the Default Traffic template monitor the rate (avg-bps) of a Default traffic class, and can alert you when the amount of traffic not classified (falling into Default) is too great. A change in the status of this agent will create a report showing detailed information on the specified class over the most current interval. This agent can only be assigned to default traffic classes, such as /Inbound/Default or /Outbound/HTTP/Default.

Agent Parameters

ClassName: Name of the Default class to be monitored

RedThreshold: Percent of parent partition's bandwidth that gets classified into the Default class (ClassName); when the rate of ClassName exceeds the RedThreshold, the agent will have a red status

GreenThreshold: Percent of parent partition's bandwidth that gets classfiied into ClassName; when the rate of ClassName is less than the GreenThreshold, the agent will have a green status

Inbound Default Traffic and Outbound Default Traffic are default agents. Default parameter values are as follows:

Red > 15% of parent partition size is classed into ClassName
Yellow 7-15% (implied)
Green < 7%
Evaluation interval: 1 minute

Action Fle Variables

$className, $avg-bps, $class-id

Example

New Application

An agent based on the New Application template can alert you when the PacketShaper auto-discovers new applications during the evaluation interval. This agent will return a score value from 0-99999, equal to the number of new auto-discovered classes in the evaluation interval (one day, by default). The red incident report will list the names of all the classes auto-discovered during the interval; a green incident report is not generated.

Each unit or PolicyCenter configuration can have only one instance of a New Application agent.

Note: When discovery is disabled during an interval, the New Application agent's score value will be zero. Therefore, this agent will not work as intended unless traffic discovery is enabled.

Agent Parameters

RedThreshold: Number of new applications discovered; when the number of new classes auto-discovered during the interval exceeds the RedThreshold, the agent will have a red status.

GreenThreshold: Number of new applications discovered; when the number of new classes auto-discovered during the interval is less than or equal to the GreenThreshold, the agent will have a green status.

Default parameter values are as follows:

Red > 0
Green <= 0
Evaluation interval: 1440 minutes

Action File Variables

none

Example

High Bandwidth New App

An agent based on the High Bandwidth New App template monitors classes that were auto-discovered during the interval, evaluating the amount of bandwidth they are using (avg-bps). This agent can help prevent new applications from consuming too much bandwidth and will create a report when the class crosses a threshold.

This agent calculates the amount of bandwidth a newly discovered class is using, as a percentage of the class' parent partition. Typically, the parent partition is either Inbound or Outbound (the link size). But a parent partition isn't restricted to Inbound or Outbound. It can also be a class, such as a subnet class, that has its own partition and has traffic discovery within the class enabled.

Each unit or PolicyCenter configuration can have only one instance of a High Bandwidth New App agent.

Note: When discovery is disabled during an interval, the High Bandwidth New App agent's score value will be zero. Therefore, this agent will not work as intended unless traffic discovery is enabled.

Agent Parameters

RedThreshold: Percent of parent partition's bandwidth; when the rate of any classes auto-discovered during the evaluation interval exceeds the RedThreshold, the agent will have a red status

GreenThreshold: Percent of parent partition's bandwidth; when the rate of any newly auto-discovered classes is less than the GreenThreshold, the agent will have a green status

The High Bandwidth New App agent is one of the default agents. The default values for the parameters are:

Green < 5% of the parent partition
Yellow 5-10% of the parent partition (implied)
Red > 10% of the parent partition
Evaluation interval: 60 minutes

Action File Variables

$namelist, $avg-bps

Example