5.29. resmon

The resmon module performs services checks against an HTTP server serving with Resmon XML or JSON.

Resmon is a light-weight resource monitor that exposes health of services over HTTP in XML.

This module rides on the http module and provides a secondary phase of XML parsing on the contents that extracts Resmon status messages into metrics that can be trended.

loader

lua

object

noit.module.resmon

5.29.1. Module Configuration

5.29.2. Check Configuration

url
required

required

allowed

.+

The URL including schema and hostname (as you would type into a browser's location bar).

port
required

optional

allowed

\d+

The TCP port can be specified to overide the default of 81.

read_limit
required

optional

default

0

allowed

\d+

Sets an approximate limit on the data read (0 means no limit).

header_(\S+)
required

optional

allowed

.+

Allows the setting of arbitrary HTTP headers in the request.

Example 5.30. Checking resmon services on OmniTI Labs.

This example checks the Resmon service on OmniTI Labs.

      <noit>
        <modules>
          <loader image="lua" name="lua">
            <config><directory>/opt/reconnoiter/libexec/modules-lua/?.lua</directory></config>
          </loader>
          <module loader="lua" name="resmon" object="noit.module.resmon"/>
        </modules>
        <checks>
          <labs target="8.8.38.5" module="resmon">
            <check uuid="36b8ba72-7968-11dd-a67f-d39a2cc3f9de">
              <config>
                <auth_user>foo</auth_user>
                <auth_password>bar</auth_password>
              </config>
            </check>
          </labs>
        </checks>
      </noit>