From 4a2fc5896451fcf901bb835b64fd1a55a43e1995 Mon Sep 17 00:00:00 2001 From: Alexander Bakaldin Date: Wed, 26 May 2021 08:13:30 +0300 Subject: .........T [ZBXNEXT-6590] added templates ZYXEL ISP switches and DSLAM --- .../net/zyxel_snmp/zyxel_ies1248-51_snmp/README.md | 113 +++++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 templates/net/zyxel_snmp/zyxel_ies1248-51_snmp/README.md (limited to 'templates/net/zyxel_snmp/zyxel_ies1248-51_snmp/README.md') diff --git a/templates/net/zyxel_snmp/zyxel_ies1248-51_snmp/README.md b/templates/net/zyxel_snmp/zyxel_ies1248-51_snmp/README.md new file mode 100644 index 00000000000..cecdc071bb5 --- /dev/null +++ b/templates/net/zyxel_snmp/zyxel_ies1248-51_snmp/README.md @@ -0,0 +1,113 @@ + +# IES1248-51 SNMP + +## Overview + +For Zabbix version: 6.0 and higher +http://origin-eu.zyxel.com/products_services/ies_1248_51v.shtml?t=p + +This template was tested on: + +- ZYXEL IES1248-51 + +## Setup + +> See [Zabbix template operation](https://www.zabbix.com/documentation/6.0/manual/config/templates_out_of_the_box/network_devices) for basic instructions. + +Refer to the vendor documentation. + +## Zabbix configuration + +No specific Zabbix configuration is required. + +### Macros used + +|Name|Description|Default| +|----|-----------|-------| +|{$SNMP.TIMEOUT} |

The time interval for SNMP agent availability trigger expression.

|`5m` | +|{$ZYXEL.ADSL.ATN.MAX} |

Type the maximum signal attenuation

|`40` | +|{$ZYXEL.ADSL.SNR.MIN} |

Type the minimum signal to noise margin (0-31 dB)

|`8` | +|{$ZYXEL.LLD.FILTER.IF.CONTROL.MATCHES} |

Triggers will be created only for interfaces whose description contains the value of this macro

|`NEED TRIGGERS` | +|{$ZYXEL.LLD.FILTER.IF.LINKSTATUS.MATCHES} |

Filter of discoverable link types.

|`.*` | +|{$ZYXEL.LLD.FILTER.IF.LINKSTATUS.NOT_MATCHES} |

Filter to exclude discovered by link types.

|`2` | + +## Template links + +There are no template links in this template. + +## Discovery rules + +|Name|Description|Type|Key and additional info| +|----|-----------|----|----| +|Fan discovery |

An entry in fanRpmTable.

|SNMP |zyxel.ies1248.fan.discovery | +|Temperature discovery |

An entry in tempTable.

|SNMP |zyxel.ies1248.temp.discovery | +|Voltage discovery |

An entry in voltageTable.

|SNMP |zyxel.ies1248.volt.discovery

**Preprocessing**:

- JAVASCRIPT: `The text is too long. Please see the template.`

| +|Ethernet interface discovery |

-

|SNMP |zyxel.ies1248.net.if.discovery

**Filter**:

AND

- A: {#ZYXEL.IF.LINKSTATUS} MATCHES_REGEX `{$ZYXEL.LLD.FILTER.IF.LINKSTATUS.MATCHES}`

- B: {#ZYXEL.IF.LINKSTATUS} NOT_MATCHES_REGEX `{$ZYXEL.LLD.FILTER.IF.LINKSTATUS.NOT_MATCHES}`

- C: {#ZYXEL.IF.NAME} MATCHES_REGEX `enet`

| +|ADSL interface discovery |

-

|SNMP |zyxel.ies1248.net.adsl.discovery

**Filter**:

AND

- A: {#ZYXEL.IF.LINKSTATUS} MATCHES_REGEX `{$ZYXEL.LLD.FILTER.IF.LINKSTATUS.MATCHES}`

- B: {#ZYXEL.IF.LINKSTATUS} NOT_MATCHES_REGEX `{$ZYXEL.LLD.FILTER.IF.LINKSTATUS.NOT_MATCHES}`

- C: {#ZYXEL.IF.NAME} MATCHES_REGEX `adsl`

| + +## Items collected + +|Group|Name|Description|Type|Key and additional info| +|-----|----|-----------|----|---------------------| +|Fans |ZYXEL IES1248-51: Fan #{#SNMPINDEX} |

MIB: ZYXEL-IESCOMMON-MIB

Current speed in Revolutions Per Minute (RPM) on the fan.

|SNMP |zyxel.ies1248.fan[{#SNMPINDEX}]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Inventory |ZYXEL IES1248-51: Hardware model name |

MIB: RFC1213-MIB

A textual description of the entity. This value

should include the full name and version

identification of the system's hardware type,

software operating-system, and networking

software. It is mandatory that this only contain

printable ASCII characters.

|SNMP |zyxel.ies1248.model

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Inventory |ZYXEL IES1248-51: Contact |

MIB: RFC1213-MIB

The textual identification of the contact person

for this managed node, together with information

on how to contact this person.

|SNMP |zyxel.ies1248.contact

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Inventory |ZYXEL IES1248-51: Host name |

MIB: RFC1213-MIB

An administratively-assigned name for this

managed node. By convention, this is the node's

fully-qualified domain name.

|SNMP |zyxel.ies1248.name

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Inventory |ZYXEL IES1248-51: Location |

MIB: RFC1213-MIB

The physical location of this node (e.g.,

`telephone closet, 3rd floor').

|SNMP |zyxel.ies1248.location

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Inventory |ZYXEL IES1248-51: MAC address |

MIB: IF-MIB

The interface's address at the protocol layer

immediately `below' the network layer in the

protocol stack. For interfaces which do not have

such an address (e.g., a serial line), this object

should contain an octet string of zero length.

|SNMP |zyxel.ies1248.mac

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Inventory |ZYXEL IES1248-51: ZyNOS F/W Version |

MIB: ZYXEL-IESCOMMON-MIB

|SNMP |zyxel.ies1248.fwversion

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Inventory |ZYXEL IES1248-51: Hardware serial number |

MIB: ZYXEL-IESCOMMON-MIB

Serial number

|SNMP |zyxel.ies1248.serialnumber

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: Interface name |

MIB: IF-MIB

A textual string containing information about the interface

|SNMP |zyxel.ies1248.net.if.name[{#SNMPINDEX}]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#ZYXEL.IF.NAME}: Operational status |

MIB: IF-MIB

The current operational state of the interface.

The testing(3) state indicates that no operational

packets can be passed.

|SNMP |zyxel.ies1248.net.if.operstatus[{#SNMPINDEX}]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#ZYXEL.IF.NAME}: Administrative status |

MIB: IF-MIB

The desired state of the interface. The

testing(3) state indicates that no operational

packets can be passed.

|SNMP |zyxel.ies1248.net.if.adminstatus[{#SNMPINDEX}]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#ZYXEL.IF.NAME}: Incoming traffic |

MIB: IF-MIB

The total number of octets received on the interface,

including framing characters.

|SNMP |zyxel.ies1248.net.if.in.traffic[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `8`

- CHANGE_PER_SECOND | +|Network_interfaces |ZYXEL IES1248-51: Port {#ZYXEL.IF.NAME}: Outgoing traffic |

MIB: IF-MIB

The total number of octets transmitted out of the

interface, including framing characters. This object is a

64-bit version of ifOutOctets.

|SNMP |zyxel.ies1248.net.if.out.traffic[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `8`

- CHANGE_PER_SECOND | +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: Interface name |

MIB: IF-MIB

A textual string containing information about the interface

|SNMP |zyxel.ies1248.net.adsl.name[{#SNMPINDEX}]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: Operational status |

MIB: IF-MIB

The current operational state of the interface.

The testing(3) state indicates that no operational

packets can be passed.

|SNMP |zyxel.ies1248.net.adsl.operstatus[{#SNMPINDEX}]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: Administrative status |

MIB: IF-MIB

The desired state of the interface. The

testing(3) state indicates that no operational

packets can be passed.

|SNMP |zyxel.ies1248.net.adsl.adminstatus[{#SNMPINDEX}]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `6h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: Incoming traffic |

MIB: IF-MIB

The total number of octets received on the interface,

including framing characters.

|SNMP |zyxel.ies1248.net.adsl.in.traffic[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `8`

- CHANGE_PER_SECOND | +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: Outgoing traffic |

MIB: IF-MIB

The total number of octets transmitted out of the

interface, including framing characters. This object is a

64-bit version of ifOutOctets.

|SNMP |zyxel.ies1248.net.adsl.out.traffic[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `8`

- CHANGE_PER_SECOND | +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: ATUC noise margin |

MIB: ADSL-LINE-MIB

Noise Margin as seen by this ATU with respect to its

received signal in tenth dB.

The Info Atuc fields show data acquired from the ATUC (ADSL Termination Unit – Central), in this case ZYXEL IES1248-51, during negotiation/provisioning message interchanges.

|SNMP |zyxel.ies1248.net.adsl.atuc.snrmgn[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `0.1`

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: ATUC attenuation |

MIB: ADSL-LINE-MIB

Measured difference in the total power transmitted by

the peer ATU and the total power received by this ATU.

The Info Atuc fields show data acquired from the ATUC (ADSL Termination Unit – Central), in this case ZYXEL IES1248-51, during negotiation/provisioning message interchanges.

|SNMP |zyxel.ies1248.net.adsl.atuc.atn[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `0.1`

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: ATUC output power |

MIB: ADSL-LINE-MIB

Measured total output power transmitted by this ATU.

The Info Atuc fields show data acquired from the ATUC (ADSL Termination Unit – Central), in this case ZYXEL IES1248-51, during negotiation/provisioning message interchanges.

|SNMP |zyxel.ies1248.net.adsl.atuc.outpwr[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `0.1`

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: ATUR noise margin |

MIB: ADSL-LINE-MIB

Noise Margin as seen by this ATU with respect to its

received signal in tenth dB.

The Info Atur fields show data acquired from the ATUR (ADSL Termination Unit – Remote), in this case the subscriber’s ADSL modem or router, during negotiation/provisioning message interchanges.

|SNMP |zyxel.ies1248.net.adsl.atur.snrmgn[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `0.1`

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: ATUR attenuation |

MIB: ADSL-LINE-MIB

Measured difference in the total power transmitted by

the peer ATU and the total power received by this ATU.

The Info Atur fields show data acquired from the ATUR (ADSL Termination Unit – Remote), in this case the subscriber’s ADSL modem or router, during negotiation/provisioning message interchanges.

|SNMP |zyxel.ies1248.net.adsl.atur.atn[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `0.1`

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Network_interfaces |ZYXEL IES1248-51: Port {#SNMPINDEX}: ATUR output power |

MIB: ADSL-LINE-MIB

Measured total output power transmitted by this ATU.

The Info Atur fields show data acquired from the ATUR (ADSL Termination Unit – Remote), in this case the subscriber’s ADSL modem or router, during negotiation/provisioning message interchanges.

|SNMP |zyxel.ies1248.net.adsl.atur.outpwr[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `0.1`

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Power_supply |ZYXEL IES1248-51: Nominal "{#ZYXEL.VOLT.NOMINAL}" |

MIB: ZYXEL-IESCOMMON-MIB

The current voltage reading.

|SNMP |zyxel.ies1248.volt[{#SNMPINDEX}]

**Preprocessing**:

- MULTIPLIER: `0.001`

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Status |ZYXEL IES1248-51: SNMP agent availability |

-

|INTERNAL |zabbix[host,snmp,available]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| +|Status |ZYXEL IES1248-51: Uptime |

MIB: RFC1213-MIB

The time (in hundredths of a second) since the

network management portion of the system was last

re-initialized.

|SNMP |zyxel.ies1248.uptime

**Preprocessing**:

- MULTIPLIER: `0.01`

| +|Status |ZYXEL IES1248-51: Alarm status |

MIB: ZYXEL-IESCOMMON-MIB

This variable indicates the alarm status of the module.

It is a bit map represented a sum, therefore, it can represent

multiple defects simultaneously. The moduleNoDefect should be set

if and only if no other flag is set.

The various bit positions are:

1 moduleNoDefect

2 moduleOverHeat

3 moduleFanRpmLow

4 moduleVoltageLow

5 moduleThermalSensorFailure

6 modulePullOut

7 powerDC48VAFailure

8 powerDC48VBFailure

9 extAlarmInputTrigger

10 moduleDown

11 mscSwitchOverOK

12 networkTopologyChange

13 macSpoof

14 cpuHigh

15 memoryUsageHigh

16 packetBufferUsageHigh

17 loopguardOccurence

|SNMP |zyxel.ies1248.slot.alarm

**Preprocessing**:

- JAVASCRIPT: `The text is too long. Please see the template.`

| +|Temperature |ZYXEL IES1248-51: Temperature "{#ZYXEL.TEMP.ID}" |

MIB: ZYXEL-IESCOMMON-MIB

The current temperature measured at this sensor

|SNMP |zyxel.ies1248.temp[{#SNMPINDEX}]

**Preprocessing**:

- DISCARD_UNCHANGED_HEARTBEAT: `1h`

| + +## Triggers + +|Name|Description|Expression|Severity|Dependencies and additional info| +|----|-----------|----|----|----| +|ZYXEL IES1248-51: FAN{#SNMPINDEX} is in critical state |

Please check the fan unit

|`{TEMPLATE_NAME:zyxel.ies1248.fan[{#SNMPINDEX}].last()}<{#ZYXEL.FANRPM.THRESH.LOW}` |AVERAGE | | +|ZYXEL IES1248-51: Template does not match hardware |

This template is for Zyxel IES1248-51, but connected to {ITEM.VALUE}

|`{TEMPLATE_NAME:zyxel.ies1248.model.last()}<>"IES1248-51"` |INFO | | +|ZYXEL IES1248-51: Firmware has changed |

Firmware version has changed. Ack to close

|`{TEMPLATE_NAME:zyxel.ies1248.fwversion.diff()}=1 and {TEMPLATE_NAME:zyxel.ies1248.fwversion.strlen()}>0` |INFO |

Manual close: YES

| +|ZYXEL IES1248-51: Device has been replaced (new serial number received) |

Device serial number has changed. Ack to close

|`{TEMPLATE_NAME:zyxel.ies1248.serialnumber.diff()}=1 and {TEMPLATE_NAME:zyxel.ies1248.serialnumber.strlen()}>0` |INFO |

Manual close: YES

| +|ZYXEL IES1248-51: Port {#ZYXEL.IF.NAME}: Link down |

This trigger expression works as follows:

1. Can be triggered if operations status is down.

2. {TEMPLATE_NAME:METRIC.diff()}=1) - trigger fires only if operational status was up(1) sometime before. (So, do not fire 'ethernal off' interfaces.)

WARNING: if closed manually - won't fire again on next poll, because of .diff.

|`{TEMPLATE_NAME:zyxel.ies1248.net.if.operstatus[{#SNMPINDEX}].last()}=2 and {TEMPLATE_NAME:zyxel.ies1248.net.if.operstatus[{#SNMPINDEX}].diff()}=1`

Recovery expression:

`{TEMPLATE_NAME:zyxel.ies1248.net.if.operstatus[{#SNMPINDEX}].last()}<>2` |AVERAGE |

Manual close: YES

| +|ZYXEL IES1248-51: Port {#SNMPINDEX}: Link down |

This trigger expression works as follows:

1. Can be triggered if operations status is down.

2. {TEMPLATE_NAME:METRIC.diff()}=1) - trigger fires only if operational status was up(1) sometime before. (So, do not fire 'ethernal off' interfaces.)

WARNING: if closed manually - won't fire again on next poll, because of .diff.

|`{TEMPLATE_NAME:zyxel.ies1248.net.adsl.operstatus[{#SNMPINDEX}].last()}=2 and {TEMPLATE_NAME:zyxel.ies1248.net.adsl.operstatus[{#SNMPINDEX}].diff()}=1`

Recovery expression:

`{TEMPLATE_NAME:zyxel.ies1248.net.adsl.operstatus[{#SNMPINDEX}].last()}<>2` |AVERAGE |

Manual close: YES

| +|ZYXEL IES1248-51: Low the DSL line noise margins in Port {#SNMPINDEX} (<{$ZYXEL.ADSL.SNR.MIN}dB for 5m) |

Signal-to-noise margin (SNR Margin) which is the difference between the actual SNR and the SNR required to sync at a specific speed

|`{TEMPLATE_NAME:zyxel.ies1248.net.adsl.atuc.snrmgn[{#SNMPINDEX}].min(5m)}<{$ZYXEL.ADSL.SNR.MIN}` |WARNING | | +|ZYXEL IES1248-51: High the DSL line attenuation in Port {#SNMPINDEX} (>{$ZYXEL.ADSL.ATN.MAX}dB for 5m) |

The reductions in amplitude of the downstream and upstream DSL signals.

|`{TEMPLATE_NAME:zyxel.ies1248.net.adsl.atuc.atn[{#SNMPINDEX}].min(5m)}>{$ZYXEL.ADSL.ATN.MAX}` |WARNING | | +|ZYXEL IES1248-51: Low the DSL line noise margins in Port {#SNMPINDEX} (<{$ZYXEL.ADSL.SNR.MIN}dB for 5m) |

Signal-to-noise margin (SNR Margin) which is the difference between the actual SNR and the SNR required to sync at a specific speed

|`{TEMPLATE_NAME:zyxel.ies1248.net.adsl.atur.snrmgn[{#SNMPINDEX}].min(5m)}<{$ZYXEL.ADSL.SNR.MIN}` |WARNING | | +|ZYXEL IES1248-51: High the DSL line attenuation in Port {#SNMPINDEX} (>{$ZYXEL.ADSL.ATN.MAX}dB for 5m) |

The reductions in amplitude of the downstream and upstream DSL signals.

|`{TEMPLATE_NAME:zyxel.ies1248.net.adsl.atur.atn[{#SNMPINDEX}].min(5m)}>{$ZYXEL.ADSL.ATN.MAX}` |WARNING | | +|ZYXEL IES1248-51: Voltage {#ZYXEL.VOLT.NOMINAL} is in critical state |

Please check the power supply

|`{TEMPLATE_NAME:zyxel.ies1248.volt[{#SNMPINDEX}].last()}<{#ZYXEL.VOLT.THRESH.LOW}` |AVERAGE | | +|ZYXEL IES1248-51: No SNMP data collection |

SNMP is not available for polling. Please check device connectivity and SNMP settings.

|`{TEMPLATE_NAME:zabbix[host,snmp,available].max({$SNMP.TIMEOUT})}=0` |WARNING | | +|ZYXEL IES1248-51: has been restarted (uptime < 10m) |

Uptime is less than 10 minutes

|`{TEMPLATE_NAME:zyxel.ies1248.uptime.last()}<10m` |INFO |

Manual close: YES

| +|ZYXEL IES1248-51: Port {#SNMPINDEX} alarm |

The slot reported an error.

|`{TEMPLATE_NAME:zyxel.ies1248.slot.alarm.str("moduleNoDefect")}=0` |AVERAGE | | +|ZYXEL IES1248-51: Temperature {#ZYXEL.TEMP.ID} is in critical state |

Please check the temperature

|`{TEMPLATE_NAME:zyxel.ies1248.temp[{#SNMPINDEX}].last()}>{#ZYXEL.TEMP.THRESH.HIGH}` |AVERAGE | | + +## Feedback + +Please report any issues with the template at https://support.zabbix.com + +You can also provide a feedback, discuss the template or ask for help with it at [ZABBIX forums](https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/422668-discussion-thread-for-official-zabbix-templates-for-zyxel). + +## Known Issues + +- Description: Incorrect handling of SNMP bulk requests. Disable the use of bulk requests in the SNMP interface settings. + - Version: all versions firmware + - Device: ZYXEL IES1248-51 + -- cgit v1.2.3