diff options
Diffstat (limited to 'templates/power/apc/apc_ups_snmp/README.md')
| -rw-r--r-- | templates/power/apc/apc_ups_snmp/README.md | 78 |
1 files changed, 39 insertions, 39 deletions
diff --git a/templates/power/apc/apc_ups_snmp/README.md b/templates/power/apc/apc_ups_snmp/README.md index 1d4dc21e84c..80603c8a9b0 100644 --- a/templates/power/apc/apc_ups_snmp/README.md +++ b/templates/power/apc/apc_ups_snmp/README.md @@ -1,9 +1,9 @@ -# APC UPS SNMP +# APC UPS by SNMP ## Overview -For Zabbix version: 6.4 and higher +For Zabbix version: 6.4 and higher. The template to monitor APC UPS with NMC by Zabbix SNMP agent. Note: please, use the latest version of the firmware for your NMC in order for the template to work correctly. @@ -49,8 +49,8 @@ There are no template links in this template. |----|-----------|----|----| |External bad battery packs discovery |<p>Discovery of the number of external defective battery packs.</p> |SNMP |battery.packs.bad.discovery | |External battery packs discovery | |SNMP |battery.packs.discovery<p>**Filter**:</p>AND <p>- {#CARTRIDGE_STATUS} NOT_MATCHES_REGEX `^$`</p> | -|External sensor port 1 discovery |<p>uioSensorStatusTable</p> |SNMP |external.sensor1.discovery<p>**Overrides:**</p><p>Temp<br> - {#EXTERNAL_SENSOR1_NAME} MATCHES_REGEX `Temp`<br> - ITEM_PROTOTYPE LIKE `Humidity` - NO_DISCOVER</p> | -|External sensor port 2 discovery |<p>uioSensorStatusTable</p> |SNMP |external.sensor2.discovery<p>**Overrides:**</p><p>Temp<br> - {#EXTERNAL_SENSOR2_NAME} MATCHES_REGEX `Temp`<br> - ITEM_PROTOTYPE LIKE `Humidity` - NO_DISCOVER</p> | +|External sensor port 1 discovery |<p>uioSensorStatusTable</p> |SNMP |external.sensor1.discovery<p>**Overrides:**</p><p>Temp<br> - {#EXTERNAL_SENSOR1_NAME} MATCHES_REGEX `Temp`<br> - ITEM_PROTOTYPE LIKE `Humidity`<br> - NO_DISCOVER</p> | +|External sensor port 2 discovery |<p>uioSensorStatusTable</p> |SNMP |external.sensor2.discovery<p>**Overrides:**</p><p>Temp<br> - {#EXTERNAL_SENSOR2_NAME} MATCHES_REGEX `Temp`<br> - ITEM_PROTOTYPE LIKE `Humidity`<br> - NO_DISCOVER</p> | |Input phases discovery |<p>The input phase identifier. OID upsPhaseInputPhaseIndex.1.1</p> |SNMP |input.phases.discovery | |Output phases discovery |<p>The output phase identifier. OID upsPhaseOutputPhaseIndex.1.1</p> |SNMP |output.phases.discovery | @@ -106,43 +106,43 @@ There are no template links in this template. |Name|Description|Expression|Severity|Dependencies and additional info| |----|-----------|----|----|----| -|System name has changed |<p>System name has changed. Ack to close.</p> |`last(/APC UPS SNMP/system.name[sysName.0],#1)<>last(/APC UPS SNMP/system.name[sysName.0],#2) and length(last(/APC UPS SNMP/system.name[sysName.0]))>0` |INFO |<p>Manual close: YES</p> | -|Battery has an internal error condition |<p>A battery installed has an internal error condition.</p> |`last(/APC UPS SNMP/battery.status[upsBasicBatteryStatus])=4` |AVERAGE | | -|Battery is Low |<p>The UPS will be unable to sustain the current load, and its services will be lost if power is not restored.</p> |`last(/APC UPS SNMP/battery.status[upsBasicBatteryStatus])=3` |AVERAGE | | -|Battery has low capacity |<p>-</p> |`last(/APC UPS SNMP/battery.capacity[upsHighPrecBatteryCapacity]) < {$BATTERY.CAPACITY.MIN.WARN}` |HIGH | | -|Battery needs replacement |<p>A battery installed has an internal error condition.</p> |`last(/APC UPS SNMP/battery.replace_indicator[upsAdvBatteryReplaceIndicator])=2` |HIGH | | -|Battery has high temperature |<p>-</p> |`min(/APC UPS SNMP/battery.temperature[upsHighPrecBatteryTemperature],{$TIME.PERIOD}) > {$BATTERY.TEMP.MAX.WARN}` |HIGH | | -|Unacceptable input voltage |<p>-</p> |`min(/APC UPS SNMP/input.voltage[upsHighPrecInputLineVoltage],{$TIME.PERIOD}) > 0 and (min(/APC UPS SNMP/input.voltage[upsHighPrecInputLineVoltage],{$TIME.PERIOD}) > {$UPS.INPUT_VOLT.MAX.WARN} or max(/APC UPS SNMP/input.voltage[upsHighPrecInputLineVoltage],{$TIME.PERIOD}) < {$UPS.INPUT_VOLT.MIN.WARN})` |HIGH | | -|Unacceptable input frequency |<p>-</p> |`min(/APC UPS SNMP/input.frequency[upsHighPrecInputFrequency],{$TIME.PERIOD}) > 0 and (min(/APC UPS SNMP/input.frequency[upsHighPrecInputFrequency],{$TIME.PERIOD}) > {$UPS.INPUT_FREQ.MAX.WARN} or max(/APC UPS SNMP/input.frequency[upsHighPrecInputFrequency],{$TIME.PERIOD}) < {$UPS.INPUT_FREQ.MIN.WARN})` |HIGH | | -|Output load is high |<p>A battery installed has an internal error condition.</p> |`min(/APC UPS SNMP/output.load[upsHighPrecOutputLoad],{$TIME.PERIOD}) > {$UPS.OUTPUT.MAX.WARN}` |HIGH | | -|UPS is Timed Sleeping |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=5` |AVERAGE | | -|UPS is Switched Bypass |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=9` |AVERAGE | | -|UPS is Software Bypass |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=6` |AVERAGE | | -|UPS is Sleeping Until Power Return |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=11` |AVERAGE | | -|UPS is Rebooting |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=8` |AVERAGE | | -|UPS is On Smart Trim |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=12` |AVERAGE | | -|UPS is on Smart Boost |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=4` |AVERAGE | | -|UPS is on battery |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=3` |AVERAGE | | -|UPS is Off |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=7` |AVERAGE | | -|UPS is Emergency Static Bypass |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=16` |AVERAGE | | -|UPS is Hardware Failure Bypass |<p>-</p> |`last(/APC UPS SNMP/output.status[upsBasicOutputStatus])=10` |AVERAGE | | -|Host has been restarted |<p>Uptime is less than 10 minutes.</p> |`(last(/APC UPS SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/APC UPS SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/APC UPS SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/APC UPS SNMP/system.net.uptime[sysUpTime.0])<10m)` |WARNING |<p>Manual close: YES</p><p>**Depends on**:</p><p>- No SNMP data collection</p> | -|No SNMP data collection |<p>SNMP is not available for polling. Please check device connectivity and SNMP settings.</p> |`max(/APC UPS SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0` |WARNING | | -|{#PHASEINDEX}: Unacceptable phase {#PHASEINDEX} input voltage |<p>-</p> |`min(/APC UPS SNMP/phase.input.voltage[upsPhaseInputVoltage.1.1.{#PHASEINDEX}],{$TIME.PERIOD}) > {$UPS.INPUT_VOLT.MAX.WARN} or max(/APC UPS SNMP/phase.input.voltage[upsPhaseInputVoltage.1.1.{#PHASEINDEX}],{$TIME.PERIOD}) < {$UPS.INPUT_VOLT.MIN.WARN}` |HIGH | | -|{#PHASEINDEX}: Unacceptable phase {#PHASEINDEX} output voltage |<p>-</p> |`min(/APC UPS SNMP/phase.output.voltage[upsPhaseOutputVoltage.1.1.{#PHASEINDEX}],{$TIME.PERIOD}) > {$UPS.INPUT_VOLT.MAX.WARN} or max(/APC UPS SNMP/phase.output.voltage[upsPhaseOutputVoltage.1.1.{#PHASEINDEX}],{$TIME.PERIOD}) < {$UPS.INPUT_VOLT.MIN.WARN}` |HIGH | | -|{#BATTERY_PACK}.{#CARTRIDGE_INDEX}: Battery status is not okay |<p>The battery cartridge status:</p><p>bit 0 Disconnected</p><p>bit 1 Overvoltage</p><p>bit 2 NeedsReplacement</p><p>bit 3 OvertemperatureCritical</p><p>bit 4 Charger</p><p>bit 5 TemperatureSensor</p><p>bit 6 BusSoftStart</p><p>bit 7 OvertemperatureWarning</p><p>bit 8 GeneralError</p><p>bit 9 Communication</p><p>bit 10 DisconnectedFrame</p><p>bit 11 FirmwareMismatch</p> |`find(/APC UPS SNMP/battery.pack.status[upsHighPrecBatteryPackCartridgeStatus.{#BATTERY_PACK}.{#CARTRIDGE_INDEX}],,"regexp","^(0{16})$")=0` |WARNING | | -|{#BATTERY_PACK}.{#CARTRIDGE_INDEX}: Battery has high temperature |<p>-</p> |`min(/APC UPS SNMP/battery.temperature[upsHighPrecBatteryPackTemperature.{#BATTERY_PACK}.{#CARTRIDGE_INDEX}],{$TIME.PERIOD}) > {$BATTERY.TEMP.MAX.WARN}` |HIGH | | -|{#BATTERY_PACK}.{#CARTRIDGE_INDEX}: Battery lifetime is not okay |<p>The battery cartridge health.</p><p> bit 0 Battery lifetime okay</p><p> bit 1 Battery lifetime near end, order replacement cartridge</p><p> bit 2 Battery lifetime exceeded, replace battery</p><p> bit 3 Battery lifetime near end acknowledged, order replacement cartridge</p><p> bit 4 Battery lifetime exceeded acknowledged, replace battery</p><p> bit 5 Battery measured lifetime near end, order replacement cartridge</p><p> bit 6 Battery measured lifetime near end acknowledged, order replacement cartridge</p> |`find(/APC UPS SNMP/battery.pack.cartridge_health[upsHighPrecBatteryPackCartridgeHealth.{#BATTERY_PACK}.{#CARTRIDGE_INDEX}],,"regexp","^(0)[0|1]{15}$")=1` |WARNING | | -|{#EXTERNAL_SENSOR1_NAME}: Sensor has status Not Applicable |<p>The external sensor does not work or is not connected.</p> |`last(/APC UPS SNMP/external.sensor.status[uioSensorStatusAlarmStatus.1.{#SNMPINDEX}])=4` |INFO | | -|{#EXTERNAL_SENSOR1_NAME}: Sensor has status Warning |<p>The external sensor has returned a value greater than the warning threshold.</p> |`last(/APC UPS SNMP/external.sensor.status[uioSensorStatusAlarmStatus.1.{#SNMPINDEX}])=2` |AVERAGE | | -|{#EXTERNAL_SENSOR1_NAME}: Sensor has status Critical |<p>The external sensor has returned a value greater than the critical threshold.</p> |`last(/APC UPS SNMP/external.sensor.status[uioSensorStatusAlarmStatus.1.{#SNMPINDEX}])=3` |HIGH | | -|{#EXTERNAL_SENSOR2_NAME}: Sensor has status Not Applicable |<p>The external sensor does not work or is not connected.</p> |`last(/APC UPS SNMP/external.sensor.status[uioSensorStatusAlarmStatus.2.{#SNMPINDEX}])=4` |INFO | | -|{#EXTERNAL_SENSOR2_NAME}: Sensor has status Warning |<p>The external sensor has returned a value greater than the warning threshold.</p> |`last(/APC UPS SNMP/external.sensor.status[uioSensorStatusAlarmStatus.2.{#SNMPINDEX}])=2` |AVERAGE | | -|{#EXTERNAL_SENSOR2_NAME}: Sensor has status Critical |<p>The external sensor has returned a value greater than the critical threshold.</p> |`last(/APC UPS SNMP/external.sensor.status[uioSensorStatusAlarmStatus.2.{#SNMPINDEX}])=3` |HIGH | | +|System name has changed |<p>System name has changed. Ack to close.</p> |`last(/APC UPS by SNMP/system.name[sysName.0],#1)<>last(/APC UPS by SNMP/system.name[sysName.0],#2) and length(last(/APC UPS by SNMP/system.name[sysName.0]))>0` |INFO |<p>Manual close: YES</p> | +|Battery has an internal error condition |<p>A battery installed has an internal error condition.</p> |`last(/APC UPS by SNMP/battery.status[upsBasicBatteryStatus])=4` |AVERAGE | | +|Battery is Low |<p>The UPS will be unable to sustain the current load, and its services will be lost if power is not restored.</p> |`last(/APC UPS by SNMP/battery.status[upsBasicBatteryStatus])=3` |AVERAGE | | +|Battery has low capacity |<p>-</p> |`last(/APC UPS by SNMP/battery.capacity[upsHighPrecBatteryCapacity]) < {$BATTERY.CAPACITY.MIN.WARN}` |HIGH | | +|Battery needs replacement |<p>A battery installed has an internal error condition.</p> |`last(/APC UPS by SNMP/battery.replace_indicator[upsAdvBatteryReplaceIndicator])=2` |HIGH | | +|Battery has high temperature |<p>-</p> |`min(/APC UPS by SNMP/battery.temperature[upsHighPrecBatteryTemperature],{$TIME.PERIOD}) > {$BATTERY.TEMP.MAX.WARN}` |HIGH | | +|Unacceptable input voltage |<p>-</p> |`min(/APC UPS by SNMP/input.voltage[upsHighPrecInputLineVoltage],{$TIME.PERIOD}) > 0 and (min(/APC UPS by SNMP/input.voltage[upsHighPrecInputLineVoltage],{$TIME.PERIOD}) > {$UPS.INPUT_VOLT.MAX.WARN} or max(/APC UPS by SNMP/input.voltage[upsHighPrecInputLineVoltage],{$TIME.PERIOD}) < {$UPS.INPUT_VOLT.MIN.WARN})` |HIGH | | +|Unacceptable input frequency |<p>-</p> |`min(/APC UPS by SNMP/input.frequency[upsHighPrecInputFrequency],{$TIME.PERIOD}) > 0 and (min(/APC UPS by SNMP/input.frequency[upsHighPrecInputFrequency],{$TIME.PERIOD}) > {$UPS.INPUT_FREQ.MAX.WARN} or max(/APC UPS by SNMP/input.frequency[upsHighPrecInputFrequency],{$TIME.PERIOD}) < {$UPS.INPUT_FREQ.MIN.WARN})` |HIGH | | +|Output load is high |<p>A battery installed has an internal error condition.</p> |`min(/APC UPS by SNMP/output.load[upsHighPrecOutputLoad],{$TIME.PERIOD}) > {$UPS.OUTPUT.MAX.WARN}` |HIGH | | +|UPS is Timed Sleeping |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=5` |AVERAGE | | +|UPS is Switched Bypass |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=9` |AVERAGE | | +|UPS is Software Bypass |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=6` |AVERAGE | | +|UPS is Sleeping Until Power Return |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=11` |AVERAGE | | +|UPS is Rebooting |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=8` |AVERAGE | | +|UPS is On Smart Trim |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=12` |AVERAGE | | +|UPS is on Smart Boost |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=4` |AVERAGE | | +|UPS is on battery |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=3` |AVERAGE | | +|UPS is Off |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=7` |AVERAGE | | +|UPS is Emergency Static Bypass |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=16` |AVERAGE | | +|UPS is Hardware Failure Bypass |<p>-</p> |`last(/APC UPS by SNMP/output.status[upsBasicOutputStatus])=10` |AVERAGE | | +|Host has been restarted |<p>Uptime is less than 10 minutes.</p> |`(last(/APC UPS by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/APC UPS by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/APC UPS by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/APC UPS by SNMP/system.net.uptime[sysUpTime.0])<10m)` |WARNING |<p>Manual close: YES</p><p>**Depends on**:</p><p>- No SNMP data collection</p> | +|No SNMP data collection |<p>SNMP is not available for polling. Please check device connectivity and SNMP settings.</p> |`max(/APC UPS by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0` |WARNING | | +|{#PHASEINDEX}: Unacceptable phase {#PHASEINDEX} input voltage |<p>-</p> |`min(/APC UPS by SNMP/phase.input.voltage[upsPhaseInputVoltage.1.1.{#PHASEINDEX}],{$TIME.PERIOD}) > {$UPS.INPUT_VOLT.MAX.WARN} or max(/APC UPS by SNMP/phase.input.voltage[upsPhaseInputVoltage.1.1.{#PHASEINDEX}],{$TIME.PERIOD}) < {$UPS.INPUT_VOLT.MIN.WARN}` |HIGH | | +|{#PHASEINDEX}: Unacceptable phase {#PHASEINDEX} output voltage |<p>-</p> |`min(/APC UPS by SNMP/phase.output.voltage[upsPhaseOutputVoltage.1.1.{#PHASEINDEX}],{$TIME.PERIOD}) > {$UPS.INPUT_VOLT.MAX.WARN} or max(/APC UPS by SNMP/phase.output.voltage[upsPhaseOutputVoltage.1.1.{#PHASEINDEX}],{$TIME.PERIOD}) < {$UPS.INPUT_VOLT.MIN.WARN}` |HIGH | | +|{#BATTERY_PACK}.{#CARTRIDGE_INDEX}: Battery status is not okay |<p>The battery cartridge status:</p><p>bit 0 Disconnected</p><p>bit 1 Overvoltage</p><p>bit 2 NeedsReplacement</p><p>bit 3 OvertemperatureCritical</p><p>bit 4 Charger</p><p>bit 5 TemperatureSensor</p><p>bit 6 BusSoftStart</p><p>bit 7 OvertemperatureWarning</p><p>bit 8 GeneralError</p><p>bit 9 Communication</p><p>bit 10 DisconnectedFrame</p><p>bit 11 FirmwareMismatch</p> |`find(/APC UPS by SNMP/battery.pack.status[upsHighPrecBatteryPackCartridgeStatus.{#BATTERY_PACK}.{#CARTRIDGE_INDEX}],,"regexp","^(0{16})$")=0` |WARNING | | +|{#BATTERY_PACK}.{#CARTRIDGE_INDEX}: Battery has high temperature |<p>-</p> |`min(/APC UPS by SNMP/battery.temperature[upsHighPrecBatteryPackTemperature.{#BATTERY_PACK}.{#CARTRIDGE_INDEX}],{$TIME.PERIOD}) > {$BATTERY.TEMP.MAX.WARN}` |HIGH | | +|{#BATTERY_PACK}.{#CARTRIDGE_INDEX}: Battery lifetime is not okay |<p>The battery cartridge health.</p><p> bit 0 Battery lifetime okay</p><p> bit 1 Battery lifetime near end, order replacement cartridge</p><p> bit 2 Battery lifetime exceeded, replace battery</p><p> bit 3 Battery lifetime near end acknowledged, order replacement cartridge</p><p> bit 4 Battery lifetime exceeded acknowledged, replace battery</p><p> bit 5 Battery measured lifetime near end, order replacement cartridge</p><p> bit 6 Battery measured lifetime near end acknowledged, order replacement cartridge</p> |`find(/APC UPS by SNMP/battery.pack.cartridge_health[upsHighPrecBatteryPackCartridgeHealth.{#BATTERY_PACK}.{#CARTRIDGE_INDEX}],,"regexp","^(0)[0|1]{15}$")=1` |WARNING | | +|{#EXTERNAL_SENSOR1_NAME}: Sensor has status Not Applicable |<p>The external sensor does not work or is not connected.</p> |`last(/APC UPS by SNMP/external.sensor.status[uioSensorStatusAlarmStatus.1.{#SNMPINDEX}])=4` |INFO | | +|{#EXTERNAL_SENSOR1_NAME}: Sensor has status Warning |<p>The external sensor has returned a value greater than the warning threshold.</p> |`last(/APC UPS by SNMP/external.sensor.status[uioSensorStatusAlarmStatus.1.{#SNMPINDEX}])=2` |AVERAGE | | +|{#EXTERNAL_SENSOR1_NAME}: Sensor has status Critical |<p>The external sensor has returned a value greater than the critical threshold.</p> |`last(/APC UPS by SNMP/external.sensor.status[uioSensorStatusAlarmStatus.1.{#SNMPINDEX}])=3` |HIGH | | +|{#EXTERNAL_SENSOR2_NAME}: Sensor has status Not Applicable |<p>The external sensor does not work or is not connected.</p> |`last(/APC UPS by SNMP/external.sensor.status[uioSensorStatusAlarmStatus.2.{#SNMPINDEX}])=4` |INFO | | +|{#EXTERNAL_SENSOR2_NAME}: Sensor has status Warning |<p>The external sensor has returned a value greater than the warning threshold.</p> |`last(/APC UPS by SNMP/external.sensor.status[uioSensorStatusAlarmStatus.2.{#SNMPINDEX}])=2` |AVERAGE | | +|{#EXTERNAL_SENSOR2_NAME}: Sensor has status Critical |<p>The external sensor has returned a value greater than the critical threshold.</p> |`last(/APC UPS by SNMP/external.sensor.status[uioSensorStatusAlarmStatus.2.{#SNMPINDEX}])=3` |HIGH | | ## Feedback -Please report any issues with the template at https://support.zabbix.com +Please report any issues with the template at https://support.zabbix.com. -You can also provide feedback, discuss the template or ask for help with it at [ZABBIX forums](https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/420730-discussion-thread-for-official-zabbix-template-apc-ups). +You can also provide feedback, discuss the template, or ask for help at [ZABBIX forums](https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/420730-discussion-thread-for-official-zabbix-template-apc-ups). |