Network Health Agent Templates

Network Health agents monitor the health and activity of traffic on the network link. The specific agents in this category and the action file variables for each agent are described in the table below.

Agent Template Name	Default Agent Name	Description
Traffic Performance	na	Agents based on the Traffic Performance template monitor transmission efficiency for one or more traffic classes and can determine when too many retransmissions are occurring, degrading the performance of the traffic class(es). A change in the status of this agent will create a report showing detailed information on traffic performance for the monitored classes over the most current interval. Note: Classes with an ignore policy are not monitored. Agent Parameters ClassName: Name of traffic class whose efficiency you want to monitor; a wildcard may be used to monitor many classes (for example, /inbound* to monitor all classes in the inbound direction) Efficiency: Percent efficiency RedThreshold: An unacceptable number of violating classes; a class is in violation if it drops below the defined Efficiency percentage GreenThreshold: An acceptable number of violating classes Default parameters are as follows: ClassName = * (all classes) Efficiency < 80 percent RedThreshold >=1 violating classes (at least one class had an efficiency less than the defined Efficiency percent) GreenThreshold <=0 violating classes Evaluation interval: 5 minutes Action File Variables $className, $efficiency, $class-id, $network-efficiency Example
Partition Utilization	na	Agents based on the Partition Utilization template monitor the throughput (avg-bps) utilization measured against the capacity of a partition, and can alert you when you are running out of bandwidth for the partition. Note that this agent measures the utilization based upon the maximum size of the partition, not the configured minimum. A change in the status of this agent will create a report showing detailed information on the monitored classes over the most current interval. Agent Parameters ClassName: Name of traffic class whose partition you want to monitor; a wildcard may be used to monitor many classes (for example, /outbound* to monitor all classes in the outbound direction) Utilization: Percent utilization of the partition RedThreshold: An unacceptable number of violating classes; a class is in violation if it exceeds the defined Utilization percentage GreenThreshold: An acceptable number of violating classes Default parameters are as follows: ClassName = * (all classes) Utilization > 90 percent RedThreshold >= 1 violating classes (at least one class had utilization greater than the defined Utilization percent) GreenThreshold <= 0 violating classes Evaluation interval: 60 minutes Action File Variables $className, $utilization, $class-id, $avg-bps Note: The $class-id and $avg-bps variables are valid in red action files only. Example

Agent Template Name

Default Agent Name

Description

Traffic Performance

Agents based on the Traffic Performance template monitor transmission efficiency for one or more traffic classes and can determine when too many retransmissions are occurring, degrading the performance of the traffic class(es). A change in the status of this agent will create a report showing detailed information on traffic performance for the monitored classes over the most current interval.

Note: Classes with an ignore policy are not monitored.

Agent Parameters

ClassName: Name of traffic class whose efficiency you want to monitor; a wildcard may be used to monitor many classes (for example, /inbound* to monitor all classes in the inbound direction)

Efficiency: Percent efficiency

RedThreshold: An unacceptable number of violating classes; a class is in violation if it drops below the defined Efficiency percentage

GreenThreshold: An acceptable number of violating classes

Default parameters are as follows:

ClassName = * (all classes)
Efficiency < 80 percent
RedThreshold >=1 violating classes (at least one class had an efficiency less than the defined Efficiency percent)
GreenThreshold <=0 violating classes
Evaluation interval: 5 minutes

Action File Variables

$className, $efficiency, $class-id, $network-efficiency

Example

Partition Utilization

Agents based on the Partition Utilization template monitor the throughput (avg-bps) utilization measured against the capacity of a partition, and can alert you when you are running out of bandwidth for the partition. Note that this agent measures the utilization based upon the maximum size of the partition, not the configured minimum. A change in the status of this agent will create a report showing detailed information on the monitored classes over the most current interval.

Agent Parameters

ClassName: Name of traffic class whose partition you want to monitor; a wildcard may be used to monitor many classes (for example, /outbound* to monitor all classes in the outbound direction)

Utilization: Percent utilization of the partition

RedThreshold: An unacceptable number of violating classes; a class is in violation if it exceeds the defined Utilization percentage

GreenThreshold: An acceptable number of violating classes

Default parameters are as follows:

ClassName = * (all classes)
Utilization > 90 percent
RedThreshold >= 1 violating classes (at least one class had utilization greater than the defined Utilization percent)
GreenThreshold <= 0 violating classes
Evaluation interval: 60 minutes

Action File Variables

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

Note: The $class-id and $avg-bps variables are valid in red action files only.

Example