References > Template Reference > APC PowerChute Agent (Windows)

APC PowerChute Agent (Windows)

This template assesses the status and overall performance of APC PowerChute Agent installed on Windows by checking for different event log events.

Prerequisites

WMI access to the target server.

Credentials

Windows Administrator on the target server.

Monitored Components

For details on monitors, see SAM Component Monitor Types.

All monitors should return zero values. Returned values other than zero indicate an abnormality. Examining the Windows application log files with source name APCPBEAgent should provide information pertaining to the issue.

Service: APC PBE Agent

This monitor returns the CPU and memory usage of the APC PowerChute Agent.

APC PowerChute Agent TCP port

This component monitor tests the ability of the APC PowerChute Agent service to accept incoming sessions. By default it monitors TCP port 2161.

Events: Hardware Errors

This monitor returns hardware error events such as:

  • Base Module Fan Fault
  • Base Power Supply Failure
  • Battery Needs Replacing
  • System Level Fan Fault
  • Main Relay Malfunction
  • Site Wiring Fault
  • Battery Charger Failure
  • Inverter Fault
  • Battery Communication Lost
  • Contact Fault

Type of event:

Error and Warning. Event ID: 3014, 3015, 3016, 3017, 3018, 3020, 3021, 3022, 3006, 3103, 3104, 3105, 3106.

For the Base Module Fan Fault event: Ensure that the fan events are not blocked.

For the Base Power Supply Failure event: If utility power fails during this condition, a Matrix-UPS, Smart-UPS, or Back-UPS Pro runs for less than half its normal run-time. A failed battery in a Symmetra Power Array reduces normal run-time in proportion to the number of batteries the system contains.

For the Battery Needs Replacing event: Replace the battery.

For other events you should contact UPS manufacturer support.

Events: Bypass

This monitor returns the number of bypass events such as:

  • Bypass Contactor Failed
  • Bypass Relay Malfunction
  • Bypass Internal Fault

Type of event:

Error and Warning. Event ID: 2037, 2040, 2044.

The Bypass Contactor Failed event occurs when the bypass switch failed to put the Symmetra Power Array into bypass, or failed to take it out of bypass.

The Bypass Relay Malfunction event occurs when low or high voltage, or a blackout, has tripped the input circuit breaker at the Symmetra Power Array.

For these events you should contact UPS manufacturer support.

Events: Environmental

This monitor returns the number of environmental errors events such as:

  • Maximum Internal Temperature has been exceeded
  • Humidity Out of Range
  • Temperature Out Of Range.

Type of event

Error and Warning. Event ID: 3107, 3110, 3111, 3120, 3121.

For these events, ensure that the fan inside the UPS is working. Check with the UPS documentation about UPS working environmental issues.

Events: Battery

This monitor returns the number of battery events such as:

  • UPS On Battery
  • Low Battery Condition
  • UPS Battery Is Discharged

Type of event

Error and Warning. Event ID: 2000, 2003, 3003.

Events: Output Overload

This monitor returns the number of output overload events such as:

  • UPS Output Overload
  • Output Load threshold Exceeded

Type of event

Error and Warning. Event ID: 3001, 3031.

Reduce the load by unplugging equipment from the UPS and then run a self-test.

Events: Communication with UPS

This monitor returns the number of communications with UPS events such as:

  • Communication Not Established
  • Lost Communication With UPS

Type of event

Error and Warning. Event ID: 3005, 3000.

Check the connection cable.

Event: System Shutdown

This monitor returns the number of "system shutdown" starting events.

Type of event

Error and Warning. Event ID: 1016.

The system is shutting down because an event occurred for which the Shut Down Server action is enabled.

Event: Monitoring Stopped

This monitor returns the number of "monitoring stopped" events.

Type of event

Error and Warning. Event ID: 1000.

Check if UPS monitoring is enabled.

Event: UPS Self-Test Failed

This monitor returns the number of "self-test errors" events.

Type of event

Error and Warning. Event ID: 3002.

The UPS failed a self-test for one of the following reasons: Bad Battery - the battery is discharged or defective; the UPS is not in a condition to complete a meaningful test. For an overload condition, unplug equipment that is not in use and try the self-test again.

Event: Insufficient Runtime Available

This monitor returns the number of "insufficient runtime available" events.

Type of event

Error and Warning. Event ID: 3030.

You should reduce the load or change runtime configuration.