Pandora: Documentation en: HWg-STE Sensor

From Pandora FMS Wiki
Jump to: navigation, search

Go back to Pandora FMS documentation index

1 HWg-STE Temperature Sensor Configuration

1.1 Introduction

In this configuration quick guide we're going to learn, step by step, how to use Pandora to monitor a HWg-STE Temperature Sensor.

We will assign alerts via eMail and generate a basic report as well.

1.2 Installation and configuration

1.2.1 Step #1. Pandora installation

Take a look at the installation manual or begin from a preinstalled Pandora with a virtual image (links).

1.2.2 Step #2. Sensor installation

Let's get started with the HWg-STE sensor:



Hwg-ste-sensor.png



Manufacturer documentation: http://www.hw-group.com/products/HWg-STE/STE_ip_temperature_sensor_en.html

Sensor manual: http://www.hw-group.com/download/HWg-STE_MAN_en.pdf

It is really important to take care while configuring the IP address to access the temperature sensor and make sure it is connected. We also need to know its OID. For this purpose, we must access and configure the device via web:



TablaHWg.png



In the screen "System → TXT List of common SNMP OID's" we can check the OID of our sensor:



650



Since we only have one sensor, the OID will be:

     .1.3.6.1.4.1.21796.4.1.3.1.5.1

It is important to note that the device returns the temperature in degrees and without decimal comma in the output. If we want to show the real value, we will have to divide this value by 10. This post-process can be done in Pandora.

And the IP address:



Tablahwg2.png



1.2.3 Step #3. Configuring the sensor in Pandora

Let's go to the agent configuration screen. There we are going to create a new agent and fill all the relevant information. This agent must have the same IP address we've just configured in the sensor.:



Pandorasensor1.png



I have associated it to the Servers group, but it is possible to change it later if I decide to create a Sensors group.

Let's define a SNMP module. Go to the module screen:



Pandorasensor2.png



Create a module which type is "SNMP Numeric Data Module".



Pandorasensor3.png



The SNMP OID field must be filled with the one obtained previously. SNMP community is "public" by default.



Pandorasensor4.png



I need to open the advanced section, to specify a post-process which can divide the result by 10.



Pandorasensor5.png




Time to click on the "Create" button:

Right after creating the module, we should see something like this:



Pandorasensor6.png



If we click in the bulb button... (modules)



Pandorasensor7.png



The previous look the new module had should have changed, and appear without the red triangle icon, by initialising it:



Pandorasensor8.png




If we take a look to the agent view... (Magnifying glass)



Pandorasensor9.png




We will be able to see the data we've gathered from the sensor:



Pandorasensor10.png



Module is up and running. In a matter of hours we will have enough data to display a graphic like this:



Pandorasensor11.png



1.2.4 Step #4. Configuring an alert

When temperature reaches a value over 38 degrees, we want an alert to be generated via email. The first thing we have to do is to configure the module, so it gets into critical status when its value gets over 38 degrees.

Let's edit the module... (click on the key, inside the edition view or the agent data view)



Pandorasensor12.png



We need to modify the ranges so the module gets into critical status over 38ºC:



Pandorasensor13.png



Now we will have to define an alert action to send an email to a specific email address. Let's go to the menu Administration -> Manage alerts -> Actions to create a new one.

We are going to define an generic alert action to send an email, so we can use it with any moudule entering into a CRITICAL status:



Pandorasensor14.png



After creating the action, we only have to define an alert in the agent which contains the sensor module. To achieve this, we need to edit the agent by going to the alerts sections:



Pandorasensor15.png



Create a new alert, starting from the default template alert "Critical condition":


Pandorasensor16.png


OK... the new alert is ready. We should see something like this:



Pandorasensor17.png



1.2.5 Step #5. Creating a basic report

Finally, once we have completed the previous steps, it is time to create a report which will contain a basic temperature graphic, with the average and maximum values.

Let's go to the menu Administration → Reports → Create report:



Pandorasensor18.png



Click on the key button so we can add new elements to the report. Choose a "Simple graph" element type.



Pandorasensor19.png



Following the same procedure, create other two elements with types "AVG (Average value)" and "MAX (Maximum value)" respectively.

Once created, in order to view it, we need to click in the report view button (first to the left). Another choice is to go to the menu Operation -> Report and click on the report we've just created.

The report should look like this (once it has enough data, after some hours/days).



Pandorasensor20.png



Go back to Pandora FMS documentation index