REST

The nscale Monitoring Console offers some of its data and services over HTTP as a web resource. The supported data representations are XML and JSON. HTML and text are offered as readable representations.

• REST API Documentation, the HTML reference of the REST API
• Web Application Description Language, the technical WADL documentation
• XML Schema Datei, the schema of the data (XML representation)

Example REST services

Here the current monitoring data (HTML representation):

• Data of resources
• Data of the groups

Nagios Integration

The Nagios integration is based on a command line tool check-nscale script, which accesses the Monitoring Console REST interface.
The REST resource for Nagios offers two queries (result as 'plain / text'):

• Sensor query (requires parameters)
• Resource Dump

JMX Adapter

The Monitoring Console also provides its monitored resources through the Java Management Extensions (JMX). A client is e.g. the included program of the Java Runtime "JConsole". The access URL is:

service:jmx:rmi://hostname:8389/jndi/rmi://hostname:8389/jmxrmi

Remote access to JMX (via RMI) must be enabled in the nscale administrator.

Prometheus metrics

The Monitoring Console also provides its monitored resources through the Prometheus metrics interface.

• /nscalemc/rest/metrics, local monitoring metrics
• /nscalemc/rest/metrics/nscale, remote nscale monitoring metrics