README.md

# Huawei optical modules

This check will monitor the *Temperature*, *Voltage*, *Electrical current* and *Optical signal power*  of optical modules (SFP).

---
### Download

- [huawei_entity_optical.mkp (latest version)](/../../../-/raw/master/huawei_entity_optical.mkp "Download MKP package")

---                   
### Installation

You can install the package by uploading it to your CheckMK site and as site user run `mkp install epsm_group.mkp`.


In the Enterprise/Free edition of CheckMK you can use the GUI to install the package (_Setup_ -> _Extension Packages_ -> _Upload package_)

---
### Want to contribute?

Nice ;-) Have a look at the [contribution guidelines](CONTRIBUTING.md "Contributing")

---
### Check Info *huawei_entity_optical_temp*

* *service*: this check creates the service *Temperature* for each SFP with the interface name as the item
* *state*: **critical**/**warning** if outside the limits
* *wato*: upper and lower limits
* *perfdata*: 
    * Temperature in °C


### Sample output

![sample output](/doc/sample_temperature.png?raw=true "sample [SHORT TITLE]")

---
### Check Info *huawei_entity_optical_current*

* *service*: this check creates the service *Current* for each SFP with the interface name as the item
* *state*: **critical**/**warning** if outside the limits
* *wato*: upper and lower limits
* *perfdata*:
    * Electrical current in Ampere

### Sample output

![sample output](/doc/sample_current.png?raw=true "sample [SHORT TITLE]")

---
### Check Info *huawei_entity_optical_dom*

* *service*: this check creates the service *DOM* for each SFP with the interface name as the item
* *state*: **critical**/**warning** if outside the limits
* *wato*: lower and upper levels for RX/TX signal power and levels for deviation.
* *perfdata*:
    * RX and TX signal power in dBm
    * RX and TX signal power deviation in dBm

Deviation extension is based on [CheckMK PR #211](https://github.com/tribe29/checkmk/pull/211) *Add deviation power to cisco_temperature.dom* by [*agabellini*](https://github.com/agabellini)

### Sample output

![sample output](/doc/sample_dom.png?raw=true "sample [SHORT TITLE]")

---
### Check Info *huawei_entity_optical_voltage*

* *service*:  this check creates the service *Voltage* for each SFP with the interface name as the item
* *state*: **critical**/**warning** if outside the limits
* *wato*: upper and lower limits
* *perfdata*:
    * Voltage in Volt

### Sample output

![sample output](/doc/sample_voltage.png?raw=true "sample [SHORT TITLE]")