You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
yzl 93958d0fb0
zabbix6.0
1 year ago
..
README.md zabbix6.0 1 year ago
template_net_morningstar_prostar_mppt_snmp.yaml zabbix6.0 1 year ago

README.md

Morningstar ProStar MPPT by SNMP

Overview

This template is designed for the effortless deployment of Morningstar ProStar MPPT monitoring by Zabbix via SNMP and doesn't require any external scripts.

Requirements

Zabbix version: 7.0 and higher.

Tested versions

This template has been tested on:

  • Morningstar ProStar MPPT

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

Refer to the vendor documentation.

Macros used

Name Description Default
{$BATTERY.TEMP.MIN.WARN}

Battery low temperature warning value

0
{$BATTERY.TEMP.MAX.WARN}

Battery high temperature warning value

45
{$BATTERY.TEMP.MIN.CRIT}

Battery low temperature critical value

-20
{$BATTERY.TEMP.MAX.CRIT}

Battery high temperature critical value

60
{$VOLTAGE.MIN.WARN}
{$VOLTAGE.MAX.WARN}
{$VOLTAGE.MIN.CRIT}
{$VOLTAGE.MAX.CRIT}
{$CHARGE.STATE.WARN}

disconnect

2
{$CHARGE.STATE.CRIT}

fault

4
{$LOAD.STATE.WARN:"lvdWarning"}

lvdWarning

2
{$LOAD.STATE.WARN:"disconnect"}

disconnect

5
{$LOAD.STATE.WARN:"override"}

override

7
{$LOAD.STATE.CRIT:"lvd"}

lvd

3
{$LOAD.STATE.CRIT:"fault"}

fault

4

Items

Name Description Type Key and additional info
Status: Uptime (network)

The time (in hundredths of a second) since the network management portion of the system was last re-initialized.

SNMP agent status.net.uptime

Preprocessing

  • Custom multiplier: 0.01

Status: Uptime (hardware)

The amount of time since this host was last initialized. Note that this is different from sysUpTime in the SNMPv2-MIB [RFC1907] because sysUpTime is the uptime of the network management portion of the system.

SNMP agent status.hw.uptime

Preprocessing

  • Check for not supported value

    Custom on fail: Set value to: 0

  • Custom multiplier: 0.01

Array: Voltage

MIB: PROSTAR-MPPT

Array Voltage

Description:Array Voltage

Scaling Factor:1.0

Units:V

Range:[0, 80]

Modbus address:0x0013

SNMP agent array.voltage[arrayVoltage.0]
Array: Sweep Vmp

MIB: PROSTAR-MPPT

Array Vmp

Description:Array Max. Power Point Voltage

Scaling Factor:1.0

Units:V

Range:[0.0, 5000.0]

Modbus address:0x003D

SNMP agent array.sweep_vmp[arrayVmp.0]
Array: Sweep Voc

MIB: PROSTAR-MPPT

Array Voc

Description:Array Open Circuit Voltage

Scaling Factor:1.0

Units:V

Range:[0.0, 80.0]

Modbus address:0x003F

SNMP agent array.sweep_voc[arrayVoc.0]
Array: Sweep Pmax

MIB: PROSTAR-MPPT

Array Max. Power (sweep)

Description:Array Max. Power (last sweep)

Scaling Factor:1.0

Units:W

Range:[0.0, 500]

Modbus address:0x003E

SNMP agent array.sweep_pmax[arrayMaxPowerSweep.0]
Battery: Charge State

MIB: PROSTAR-MPPT

Charge State

Description:Control State

Modbus address:0x0021

0: Start

1: NightCheck

2: Disconnect

3: Night

4: Fault

5: BulkMppt

6: Absorption

7: Float

8: Equalize

9: Slave

10: Fixed

SNMP agent charge.state[chargeState.0]

Preprocessing

  • Discard unchanged with heartbeat: 1h

Battery: Battery Voltage discovery

MIB: PROSTAR-MPPT

SNMP agent battery.voltage.discovery[batteryTerminalVoltage.0]
Battery: Target Voltage

MIB: PROSTAR-MPPT

Target Voltage

Description:Target Regulation Voltage

Scaling Factor:1.0

Units:V

Range:[0.0, 80.0]

Modbus address:0x0024

SNMP agent target.voltage[targetVoltage.0]

Preprocessing

  • Discard unchanged with heartbeat: 1h

Battery: Charge Current

MIB: PROSTAR-MPPT

Charge Current

Description:Charge Current

Scaling Factor:1.0

Units:A

Range:[0, 40]

Modbus address:0x0010

SNMP agent charge.current[chargeCurrent.0]
Load: State

MIB: PROSTAR-MPPT

Load State

Description:Load State

Modbus address:0x002E

0: Start

1: Normal

2: LvdWarning

3: Lvd

4: Fault

5: Disconnect

6: NormalOff

7: Override

8: NotUsed

SNMP agent load.state[loadState.0]

Preprocessing

  • Discard unchanged with heartbeat: 1h

Load: Voltage

MIB: PROSTAR-MPPT

Load Voltage

Description:Load Voltage

Scaling Factor:1.0

Units:V

Range:[0, 80]

Modbus address:0x0014

SNMP agent load.voltage[loadVoltage.0]
Load: Current

MIB: PROSTAR-MPPT

Load Current

Description:Load Current

Scaling Factor:1.0

Units:A

Range:[0, 60]

Modbus address:0x0016

SNMP agent load.current[loadCurrent.0]
Temperature: Ambient

MIB: PROSTAR-MPPT

Ambient Temperature

Description:Ambient Temperature

Scaling Factor:1.0

Units:deg C

Range:[-128, 127]

Modbus address:0x001C

SNMP agent temp.ambient[ambientTemperature.0]
Temperature: Battery

MIB: PROSTAR-MPPT

Battery Temperature

Description:Battery Temperature

Scaling Factor:1.0

Units:deg C

Range:[-128, 127]

Modbus address:0x001B

SNMP agent temp.battery[batteryTemperature.0]
Temperature: Heatsink

MIB: PROSTAR-MPPT

Heatsink Temperature

Description:Heatsink Temperature

Scaling Factor:1.0

Units:deg C

Range:[-128, 127]

Modbus address:0x001A

SNMP agent temp.heatsink[heatsinkTemperature.0]
Counter: Charge Amp-hours

MIB: PROSTAR-MPPT

Ah Charge (Resettable)

Description:Ah Charge (Resettable)

Scaling Factor:0.1

Units:Ah

Range:[0.0, 4294967294]

Modbus addresses:H=0x0026 L=0x0027

SNMP agent counter.charge_amp_hours[ahChargeResettable.0]

Preprocessing

  • Custom multiplier: 0.1

Counter: Charge KW-hours

MIB: PROSTAR-MPPT

kWh Charge (Resettable)

Description:Kilowatt Hours Charge (Resettable)

Scaling Factor:1.0

Units:kWh

Range:[0.0, 65535]

Modbus address:0x002A

SNMP agent counter.charge_kw_hours[kwhChargeResettable.0]
Counter: Load Amp-hours

MIB: PROSTAR-MPPT

Description:Ah Load (Resettable)

Scaling Factor:0.1

Units:Ah

Range:[0.0, 4294967294]

Modbus addresses:H=0x0032 L=0x0033

SNMP agent counter.load_amp_hours[ahLoadResettable.0]

Preprocessing

  • Custom multiplier: 0.1

Status: Array Faults

MIB: PROSTAR-MPPT

Description:Array Faults

Modbus address:0x0022

SNMP agent status.array_faults[arrayFaults.0]

Preprocessing

  • Discard unchanged with heartbeat: 1h

  • JavaScript: The text is too long. Please see the template.

Status: Load Faults

MIB: PROSTAR-MPPT

Description:Array Faults

Modbus address:0x0022

SNMP agent status.load_faults[loadFaults.0]

Preprocessing

  • Discard unchanged with heartbeat: 1h

  • JavaScript: The text is too long. Please see the template.

Status: Alarms

MIB: PROSTAR-MPPT

Description:Alarms

Modbus addresses:H=0x0038 L=0x0039

SNMP agent status.alarms[alarms.0]

Preprocessing

  • Discard unchanged with heartbeat: 1h

  • JavaScript: The text is too long. Please see the template.

Triggers

Name Description Expression Severity Dependencies and additional info
Status: Device has been restarted

Uptime is less than 10 minutes.

(last(/Morningstar ProStar MPPT by SNMP/status.hw.uptime)>0 and last(/Morningstar ProStar MPPT by SNMP/status.hw.uptime)<10m) or (last(/Morningstar ProStar MPPT by SNMP/status.hw.uptime)=0 and last(/Morningstar ProStar MPPT by SNMP/status.net.uptime)<10m) Info Manual close: Yes
Status: Failed to fetch data

Zabbix has not received data for items for the last 5 minutes.

nodata(/Morningstar ProStar MPPT by SNMP/status.net.uptime,5m)=1 Warning Manual close: Yes
Battery: Device charge in warning state last(/Morningstar ProStar MPPT by SNMP/charge.state[chargeState.0])={$CHARGE.STATE.WARN} Warning Depends on:
  • Battery: Device charge in critical state
Battery: Device charge in critical state last(/Morningstar ProStar MPPT by SNMP/charge.state[chargeState.0])={$CHARGE.STATE.CRIT} High
Load: Device load in warning state last(/Morningstar ProStar MPPT by SNMP/load.state[loadState.0])={$LOAD.STATE.WARN:"lvdWarning"} or last(/Morningstar ProStar MPPT by SNMP/load.state[loadState.0])={$LOAD.STATE.WARN:"override"} Warning Depends on:
  • Load: Device load in critical state
Load: Device load in critical state last(/Morningstar ProStar MPPT by SNMP/load.state[loadState.0])={$LOAD.STATE.CRIT:"lvd"} or last(/Morningstar ProStar MPPT by SNMP/load.state[loadState.0])={$LOAD.STATE.CRIT:"fault"} High
Temperature: Low battery temperature max(/Morningstar ProStar MPPT by SNMP/temp.battery[batteryTemperature.0],5m)<{$BATTERY.TEMP.MIN.WARN} Warning Depends on:
  • Temperature: Critically low battery temperature
Temperature: Critically low battery temperature max(/Morningstar ProStar MPPT by SNMP/temp.battery[batteryTemperature.0],5m)<{$BATTERY.TEMP.MIN.CRIT} High
Temperature: High battery temperature min(/Morningstar ProStar MPPT by SNMP/temp.battery[batteryTemperature.0],5m)>{$BATTERY.TEMP.MAX.WARN} Warning Depends on:
  • Temperature: Critically high battery temperature
Temperature: Critically high battery temperature min(/Morningstar ProStar MPPT by SNMP/temp.battery[batteryTemperature.0],5m)>{$BATTERY.TEMP.MAX.CRIT} High
Status: Device has "overcurrent" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","overcurrent")=2 High
Status: Device has "mosfetSShorted" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","mosfetSShorted")=2 High
Status: Device has "software" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","software")=2 High
Status: Device has "batteryHvd" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","batteryHvd")=2 High
Status: Device has "arrayHvd" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","arrayHvd")=2 High
Status: Device has "customSettingsEdit" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","customSettingsEdit")=2 High
Status: Device has "rtsShorted" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","rtsShorted")=2 High
Status: Device has "rtsNoLongerValid" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","rtsNoLongerValid")=2 High
Status: Device has "localTempSensorDamaged" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","localTempSensorDamaged")=2 High
Status: Device has "batteryLowVoltageDisconnect" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","batteryLowVoltageDisconnect")=2 High
Status: Device has "slaveTimeout" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","slaveTimeout")=2 High
Status: Device has "dipSwitchChanged" array faults flag count(/Morningstar ProStar MPPT by SNMP/status.array_faults[arrayFaults.0],#3,"like","dipSwitchChanged")=2 High
Status: Device has "externalShortCircuit" load faults flag count(/Morningstar ProStar MPPT by SNMP/status.load_faults[loadFaults.0],#3,"like","externalShortCircuit")=2 High
Status: Device has "overcurrent" load faults flag count(/Morningstar ProStar MPPT by SNMP/status.load_faults[loadFaults.0],#3,"like","overcurrent")=2 High
Status: Device has "mosfetShorted" load faults flag count(/Morningstar ProStar MPPT by SNMP/status.load_faults[loadFaults.0],#3,"like","mosfetShorted")=2 High
Status: Device has "software" load faults flag count(/Morningstar ProStar MPPT by SNMP/status.load_faults[loadFaults.0],#3,"like","software")=2 High
Status: Device has "loadHvd" load faults flag count(/Morningstar ProStar MPPT by SNMP/status.load_faults[loadFaults.0],#3,"like","loadHvd")=2 High
Status: Device has "highTempDisconnect" load faults flag count(/Morningstar ProStar MPPT by SNMP/status.load_faults[loadFaults.0],#3,"like","highTempDisconnect")=2 High
Status: Device has "dipSwitchChanged" load faults flag count(/Morningstar ProStar MPPT by SNMP/status.load_faults[loadFaults.0],#3,"like","dipSwitchChanged")=2 High
Status: Device has "customSettingsEdit" load faults flag count(/Morningstar ProStar MPPT by SNMP/status.load_faults[loadFaults.0],#3,"like","customSettingsEdit")=2 High
Status: Device has "rtsShorted" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","rtsShorted")=2 Warning
Status: Device has "rtsDisconnected" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","rtsDisconnected")=2 Warning
Status: Device has "heatsinkTempSensorOpen" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","heatsinkTempSensorOpen")=2 Warning
Status: Device has "heatsinkTempSensorShorted" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","heatsinkTempSensorShorted")=2 Warning
Status: Device has "heatsinkTempLimit" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","heatsinkTempLimit")=2 Warning
Status: Device has "inductorTempSensorOpen" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","inductorTempSensorOpen")=2 Warning
Status: Device has "inductorTempSensorShorted" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","inductorTempSensorShorted")=2 Warning
Status: Device has "inductorTempLimit" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","inductorTempLimit")=2 Warning
Status: Device has "currentLimit" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","currentLimit")=2 Warning
Status: Device has "currentMeasurementError" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","currentMeasurementError")=2 Warning
Status: Device has "batterySenseOutOfRange" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","batterySenseOutOfRange")=2 Warning
Status: Device has "batterySenseDisconnected" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","batterySenseDisconnected")=2 Warning
Status: Device has "uncalibrated" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","uncalibrated")=2 Warning
Status: Device has "tb5v" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","tb5v")=2 Warning
Status: Device has "fp10SupplyOutOfRange" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","fp10SupplyOutOfRange")=2 Warning
Status: Device has "mosfetOpen" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","mosfetOpen")=2 Warning
Status: Device has "arrayCurrentOffset" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","arrayCurrentOffset")=2 Warning
Status: Device has "loadCurrentOffset" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","loadCurrentOffset")=2 Warning
Status: Device has "p33SupplyOutOfRange" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","p33SupplyOutOfRange")=2 Warning
Status: Device has "p12SupplyOutOfRange" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","p12SupplyOutOfRange")=2 Warning
Status: Device has "hightInputVoltageLimit" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","hightInputVoltageLimit")=2 Warning
Status: Device has "controllerReset" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","controllerReset")=2 Warning
Status: Device has "loadLvd" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","loadLvd")=2 Warning
Status: Device has "logTimeout" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","logTimeout")=2 Warning
Status: Device has "eepromAccessFailure" alarm flag count(/Morningstar ProStar MPPT by SNMP/status.alarms[alarms.0],#3,"like","eepromAccessFailure")=2 Warning

LLD rule Battery voltage discovery

Name Description Type Key and additional info
Battery voltage discovery

Discovery for battery voltage triggers

Dependent item battery.voltage.discovery

Preprocessing

  • JavaScript: The text is too long. Please see the template.

Item prototypes for Battery voltage discovery

Name Description Type Key and additional info
Battery: Voltage{#SINGLETON}

MIB: PROSTAR-MPPT

Battery Terminal Voltage

Description:Battery Terminal Voltage

Scaling Factor:1.0

Units:V

Range:[0.0, 80.0]

Modbus address:0x0012

SNMP agent battery.voltage[batteryTerminalVoltage.0{#SINGLETON}]

Trigger prototypes for Battery voltage discovery

Name Description Expression Severity Dependencies and additional info
Battery: Low battery voltage max(/Morningstar ProStar MPPT by SNMP/battery.voltage[batteryTerminalVoltage.0{#SINGLETON}],5m)<{#VOLTAGE.MIN.WARN} Warning Depends on:
  • Battery: Critically low battery voltage
Battery: Critically low battery voltage max(/Morningstar ProStar MPPT by SNMP/battery.voltage[batteryTerminalVoltage.0{#SINGLETON}],5m)<{#VOLTAGE.MIN.CRIT} High
Battery: High battery voltage min(/Morningstar ProStar MPPT by SNMP/battery.voltage[batteryTerminalVoltage.0{#SINGLETON}],5m)>{#VOLTAGE.MAX.WARN} Warning Depends on:
  • Battery: Critically high battery voltage
Battery: Critically high battery voltage min(/Morningstar ProStar MPPT by SNMP/battery.voltage[batteryTerminalVoltage.0{#SINGLETON}],5m)>{#VOLTAGE.MAX.CRIT} High

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums