eznemo

A Ruby gem. It's a simple monitoring engine and stores results in a database. Runs on EventMachine.

For reports and alerts, analyze the results in the database.

Requirements

• Ruby 2.0.0 <=
• eventmachine 1.0 <=

Data Storage Options

Currently, only support MySQL, so you'll also need the following gem:

• mysql2 0.4 <=

Getting Started

Install

$ gem install eznemo

Use

$ eznemo start -c config.yml

Examples

Config file.

---
:datastore:
  :type: :mysql
  :options:
    :host: '127.0.0.1'
    :username: 'user'
    :password: 'paSsw0rd'
    :database: 'eznemo'
:checks:
  :tags:
    - tag1
    - tag2
:monitor:
    :path: '/bin/ping'
    :min_interval: 10
    :timeout: 5
    :cmd_opts: '-s 102'

Data Structure

Checks

{
  id: 123,   # auto_increment
  name: 'Check name',
  hostname: '192.168.0.111',
  interval: 60,   # frequecy this check is run in seconds
  type: 'ping',   # or other monitor plugin name
  state: true,   # true means active
  tags: '["tag1", "tag2"]',
  options: '-S 192.168.0.11'
}

Results

{
  check_id: 123,   # from checks
  timestamp: '2016-04-01 10:00:00 -07:00',
  status: true,   # true means OK
  response_ms: 0.012,   # in milliseconds
  status_desc: 'OK'   # short description of the result
}

MySQL

CREATE TABLE `checks` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(255) NOT NULL DEFAULT '',
  `hostname` varchar(255) NOT NULL DEFAULT '',
  `interval` int(11) NOT NULL,
  `type` varchar(255) NOT NULL DEFAULT '',
  `state` tinyint(1) NOT NULL,
  `tags` text,
  `options` text,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

CREATE TABLE `results` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `check_id` int(11) NOT NULL,
  `timestamp` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `status` tinyint(1) NOT NULL,
  `response_ms` float NOT NULL DEFAULT '0',
  `status_desc` varchar(255) NOT NULL DEFAULT '',
  PRIMARY KEY (`id`),
  KEY `check_id` (`check_id`),
  KEY `timestamp` (`timestamp`),
  KEY `status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;