Unit Health Agent Templates

Unit Health agents monitor the health and activity on an individual PacketShaper. There are four different agent templates in this category; these agents and their action file variables 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 of values between the green and red parameters, and is shown in the table below just for reference.

Agent Template Name	Default Agent Name	Description
Unit Limits	na	An agent based on the Unit Limits template monitors portions of the system limits of the PacketShaper and will notify you when the capacity of the unit nears its limit. This agent tracks values for the number of classes, matching rules, partitions, and dynamic partitions, and reports a value of 99% when there is only one left of any of these monitored entities. A change in the status of this agent will create a report showing detailed information on unit limits over the most current interval. Each unit or PolicyCenter configuration can have only one instance of a Unit Limits agent. Agent Parameters RedThreshold: Percent of system capacity that indicates the unit is approaching its limits; when the RedThreshold is exceeded, the agent will have a red status GreenThreshold: Percent of system capacity that indicates the unit is operating at an acceptable level The default parameter values are: Green < 90% of system capacity Yellow 90-98% of system capacity (implied) Red >= 99% of system capacity Evaluation interval: 15 minutes Action File Variables none Example
System Load	na	An agent based on the System Load template monitors the system processing load on the PacketShaper. This agent can alert you when system load becomes too great. Though a very high percentage of system load is not a problem by itself, it often occurs as a symptom of other problems such as a severe traffic spike or malfunction of the unit. A change in the status of this agent will create a report showing detailed information on system health over the most current interval. Each unit or PolicyCenter configuration can have only one instance of a System Load agent. Agent Parameters RedThreshold: Unacceptable percent of system processing capacity. These threshold units are similar to the percentage of CPU utilization. GreenThreshold: Acceptable percent of system processing capacity The default parameter values are: Green < 90% capacity Yellow 90%-95% capacity (implied) Red > 95% capacity Evaluation interval: 1 minute Action File Variables none Example
Memory Allocation	na	An agent based on the Memory Allocation template monitors some of the memory limits of the PacketShaper and can alert you about memory failures in TCP, UCB, ACB, host allocation, and classification allocation. These failures which can occur when a heavy traffic load leads to insufficient memory to manage the new flows. In some cases, memory allocation errors can lead to dropped packets. This agent will automatically return to green if there has been no failure for a 60-second period. A change in the status of this agent will create a report showing detailed information on memory allocation over the most current interval. Each unit or PolicyCenter configuration can have only one instance of a Memory Allocation agent. Agent Parameters RedThreshold: Unacceptable number of memory allocation failures GreenThreshold: Acceptable number of failures The default parameter values are: Green = 0 failures Yellow = 1 failure (implied) Red: >= 2 failures Evaluation interval: 1 minute Action File Variables none Example

Agent Template Name

Default Agent Name

Description

Unit Limits

An agent based on the Unit Limits template monitors portions of the system limits of the PacketShaper and will notify you when the capacity of the unit nears its limit. This agent tracks values for the number of classes, matching rules, partitions, and dynamic partitions, and reports a value of 99% when there is only one left of any of these monitored entities. A change in the status of this agent will create a report showing detailed information on unit limits over the most current interval.

Each unit or PolicyCenter configuration can have only one instance of a Unit Limits agent.

Agent Parameters

RedThreshold: Percent of system capacity that indicates the unit is approaching its limits; when the RedThreshold is exceeded, the agent will have a red status

GreenThreshold: Percent of system capacity that indicates the unit is operating at an acceptable level

The default parameter values are:

Green < 90% of system capacity
Yellow 90-98% of system capacity (implied)
Red >= 99% of system capacity
Evaluation interval: 15 minutes

Action File Variables

none

Example

System Load

An agent based on the System Load template monitors the system processing load on the PacketShaper. This agent can alert you when system load becomes too great. Though a very high percentage of system load is not a problem by itself, it often occurs as a symptom of other problems such as a severe traffic spike or malfunction of the unit. A change in the status of this agent will create a report showing detailed information on system health over the most current interval.

Each unit or PolicyCenter configuration can have only one instance of a System Load agent.

Agent Parameters

RedThreshold: Unacceptable percent of system processing capacity. These threshold units are similar to the percentage of CPU utilization.

GreenThreshold: Acceptable percent of system processing capacity

The default parameter values are:

Green < 90% capacity
Yellow 90%-95% capacity (implied)
Red > 95% capacity
Evaluation interval: 1 minute

Action File Variables

none

Example

Memory Allocation

An agent based on the Memory Allocation template monitors some of the memory limits of the PacketShaper and can alert you about memory failures in TCP, UCB, ACB, host allocation, and classification allocation. These failures which can occur when a heavy traffic load leads to insufficient memory to manage the new flows. In some cases, memory allocation errors can lead to dropped packets.

This agent will automatically return to green if there has been no failure for a 60-second period. A change in the status of this agent will create a report showing detailed information on memory allocation over the most current interval.

Each unit or PolicyCenter configuration can have only one instance of a Memory Allocation agent.

Agent Parameters

RedThreshold: Unacceptable number of memory allocation failures

GreenThreshold: Acceptable number of failures

The default parameter values are:

Green = 0 failures
Yellow = 1 failure (implied)
Red: >= 2 failures
Evaluation interval: 1 minute

Action File Variables

none

Example