HANA XSEngine monitor for Monitiq

HANA Agent version 1.5.3 now contains an agent to allow the monitoring of the XSEngine (SAP HANA Extended Application Services) within HANA.

The XSEngine is a web application server integrated into the HANA service stack to allow javascript/html5 applications to be run against the HANA platform without the need for additional external web servers. See http://scn.sap.com/docs/DOC-60322 for full details on the HANA XSEngine.

A customer approached us with a recurring hanging issue in the  XSEngine. The issue only came to a head when the final node in the cluster gave up and no more connections were serviced across the cluster. They implemented a daily manual check to ensure that all nodes in the cluster were working and asked if we could help. We saw this as an obvious omission from our HANA agent and so put the development of an agent into the next sprint.

The agent collects the HTTP status code from the supplied URL, which during installation defaults to /sap/hana/admin, the current default for the HANA XSEngine. It also records the time taken to service the request.

It tries both HTTP and HTTPS, and  the overall status appears in against the “HANA Instance” metrics in Monitiq.

HANA XSEngine Alert Rules

The metics collected will enable the following Alert rule possibiltuies

  1. Is the Service available: Status Code DOES NOT EQUAL 200
  2. Are the correct protocols available:Protocol EQUALS “http” AND Status EQUALS -1 (this example might be used if you have chosen to deny http and only allow https for security)
  3. Is the XSEngine responding in an acceptable time frame : Resonse time (ms) LESS THAN 200 (So far we have seen very fast response times, but it will be interesting to see over time when a system is heavily loaded how much these vary. )

HANA XSEngine status displayed in Monitiq

HANA XSEngine XS Engine XSEngine agent status

And the detail when clicked includes a response time recorded in Milliseconds:

xsengine_detail

How to Configure the Monitiq for HANA XSEngine Agent

Configure the XSengine monitoring as follows using “monitiqua -a” on the command line:

The current XS engine configuration is:
No XS Engine configuration found for instance ‘M1P.

Please enter the instance for which you would like to change configuration [press enter to skip configuration]:
M1P
Please enter the server for instance ‘M1P’:
hana01
Please enter the path to XS engine for instance ‘M1P’: Server ‘hana01’ [Default = /sap/hana/admin]

/sap/hana/xs/admin

Type ‘cancel’ to cancel change to configuration for instance ‘M1P’: Server ‘hana01’
The current XS engine configuration is:
Instance ‘M1P’: Server ‘hana01’ with path to XS engine ‘/sap/hana/admin’.

Please enter the instance for which you would like to change configuration [press enter to skip configuration]:

Checkout  https://www.monitiq.com/monitiq-agent-release-notes/  for other agent features releases.