Monitoring

All HW group devices provide data in XML. However, for historical reasons, the XML formats used by different devices differ significantly, and unification is not feasible due to the need for backwards compatibility. However, with SensDesk.com, data can be retrieved from all connected devices in a unified format.

Due to the multi-user nature of the portal, it is necessary to ensure that each customer can only see their own data. For this reason, access to the values.xml file is somewhat more complex, compared to accessing individual devices. On the other hand, the content is structured in a better way.

There are two new ways of obtaining the values.xml file:

• At http://sensdesk.com/sensdesk/team/TEAM_ID/values.xml after logging in with your username and password
• At http://sensdesk.com/sensdesk/values.xml?values_xml_key=YOUR_VALUE.XML_KEY

In the first case, only the values to which you have permissions are retrieved. In the second case, the values of the whole team are retrieved.

The key for retrieving the XML file can be found at the team page:

Complete description of the XML format is available for download at: https://www.hw-group.com/cs/product-version/sensdesk-xml-format

What is alarm escalation?

Alarm escalation can refer to three different things. With our products, all user requirements can be met.

• Resending the alarm message
• Forwarding the alarm message to another user
• Sending a reminder if the situation gets worse

Resending the alarm message

Most mature devices, such as Poseidon2, Damocles2, Ares, HWg-WLD or WLD2, can resend alarm messages. This feature is called Periodic Alarm. Simply specify a time in minutes or seconds (depending on the device type). If the alarm lasts longer than the specified time, the alarm messages are sent again.

Devices intended for home use, such as HWg-STE, STE2 or SD devices, do not support this feature directly; however, the feature is available through the Sensdesk.com portal.  

The portal supports the feature for the SafeRange as well as for all Notice ranges – see below.

Forwarding the alarm message to another user

It is often needed to escalate alarms to another operator or to a supervisor. This function would be difficult to define within a device, hence it is implemented in its entirety within the SensDesk.com portal. That way, it is possible to configure the escalation in a user-friendly way, present an overview of all alarm messages, and provide central management. Escalation uses the Notice range feature and its Delay parameter. Simply set up a new Notice range with its limit values equal to an existing range and set the Delay to the required escalation delay. At the respective sensor or device, create a new action, set its target to the person handling the escalation and choose the range with the delay. It is possible to define multiple ranges and actions for several escalation levels, e.g. to send an alarm immediately to the technician on duty, one hour later to the back-up technician, and after two hours to the operations manager.

Note: When defining Notice Ranges, keep in mind that the PushPeriod can prolong the delay. For example, if the delay is 3600s (60 minutes = 1 hour), the escalation can take up to 4200s, that is, 75 minutes (1 hour and 15 minutes). If you need to escalate after 60 minutes at most, set a shorter delay, e.g. 55 minutes (3300s).

Escalation when the situation gets worse

This type of escalation only applies to sensors, i.e. analog values. It cannot be defined for binary inputs and outputs. It is similar to the escalation to another person as described above: instead of a delay, specify a different range of values. For example, when monitoring the temperature in a cabinet, one action can turn on back-up AC at 35°C, another action notifies the property maintenance at 45°C, another one shuts down the servers at 55°C and a yet another one notifies the fire brigade at 85°C.

Useful tips

Always set a hysteresis – Just as with in-device SafeRange settings, it is highly recommended for Notice Ranges, too.

Give descriptive names to Ranges and Actions – When creating a new Range or Action, a name needs to be specified. Choose names that are easy to understand. This will make it easier to edit Ranges and Actions and create new ones. When creating an action, it is necessary to select an existing range. At that moment, ranges named “Range1” and “Range2” don’t really help. On the other hand, ranges named “20-40C” or “20-40C 60min” are easy to distinguish.

All sensor's data from your user account on the SensDesk.com (SensDesk technology based portal) are available for some time in the XML format that can be periodically downloaded over http or https (XML Application Note is here). 
However, the XML format is not very suitable for IT environments that need quick and brief responses. To address this, a SNMP agent feature was added. This request-response protocol runs on top of UDP, It allows targeted queries for one specific value, without downloading lots of unneeded data.

Core information:
The SNMP implementation in the portal supports SNMPv1 and/or SNMPv3 over UDP.
All settings can be configured at the user’s login page, http://sensdesk.com/user/.
SNMP Server Address is portal address (ex.: Sensdesk.com), SNMP port is 1161.

Results of SNMP Walk request with Paessler SNMP tester

Showing all sensors data from the portal user account. The user / Team account is identified with using the Community.

Results of SNMP Walk request with iReasoning MIB Browser

Showing all sensors data from the portal user account. The user / Team account is identified with using the Community.

How to configurate SNMP on the SensDesk.com portal:

Every user can create two SNMP accounts. SNMP version and access permissions can be configured separately for each account. (At this moment, only read access is allowed.)
The community for SNMPv1 or the user name for SNMPv3 are randomly generated, and are unique within the whole portal. It is possible to regenerate them on saving.

The generated community or username is also shown in the user account properties.

The MIB table is currently under development and available for download in the user account.

The devices themselves support numerous protocols; one could therefore avoid a common concentrator and modify the communication protocols directly in the devices. However, this is not realistic due to their different characteristics, communication interfaces, age, and the need to maintain backward compatibility.

For instance, Narrowband devices (NB-devices family) do not offer any standardized outputs and only communicate using a proprietary protocol. Devices connected over GSM/LTE cannot be accessed for reading. And even Ethernet devices have very different properties. The solution is to use the portal. In addition to other functions, the portal provides current values from all devices in a unified way using XML or SNMP.

In case of SNMP, both SNMPv1 and SNMPv3 can be used. Support for SNMP traps (for alarms) is coming soon. Each user is assigned a community and a username for SNMPv3. This is to ensure that each user can only access values which they are authorized to access.

For SNMP, the principle is the same, except that the portal login username and password are used to determine user permissions.

For more information about using SensDesk.com for data concentration, see our application notes.