https://github.com/jonathanstowe/monitor-monit

Provide an interface to the monit monitoring daemon
https://github.com/jonathanstowe/monitor-monit

monit monitoring raku service

Last synced: about 1 month ago
JSON representation

Provide an interface to the monit monitoring daemon

• Host: GitHub
• URL: https://github.com/jonathanstowe/monitor-monit
• Owner: jonathanstowe
• License: artistic-2.0
• Created: 2016-05-09T11:11:47.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2022-08-07T08:42:45.000Z (over 2 years ago)
• Last Synced: 2023-04-22T17:06:59.777Z (almost 2 years ago)
• Topics: monit, monitoring, raku, service
• Language: Raku
• Homepage:
• Size: 34.2 KB
• Stars: 2
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

        
# Monitor::Monit

Provide an interface to the monit monitoring daemon

![Build Status](https://github.com/jonathanstowe/Monitor-Monit/workflows/CI/badge.svg)

## Synopsis

```raku

use Monitor::Monit;

# use default settings

my $mon = Monitor::Monit.new;

for $mon.service -> $service {

	say $service.name, " is ", $service.status-name;

}

```

## Description

Monit is a lightweight, relatively simple and widely used system

and application monitoring service.

This provides a mechanism to interact with its http api.

## Installation

In order for this to be useful you will need to have 'monit' installed,

most Linux distributions provide it as a package.

If you set the enviromment variable ```MONIT_TEST_LIVE``` the tests will

attempt to connect to a monit daemon on the local host with the default

port and credentials, if there is no connection then the online tests

will be skipped.

By default the monit daemon will be configured to only listen for local

connections on the loopback interface, if you wish to work with a remote

monit daemon you may need to alter the monit configuration accordingly.

You can provide the details for the running monit daemon you want to test

with by setting some environment variables before running the tests:

   * ```MONIT_TEST_HOST```  - the hostname on which the daemon is running

   * ```MONIT_TEST_PORT```  - the port the daemon is using (default 2812)

   * ```MONIT_TEST_USER```  - the username to authenticate (default ```admin```)

   * ```MONIT_TEST_PASS```  - the password to authenticate (default ```monit```)

Additionally, if the environment variable ```MONIT_TEST_CONTROL``` is set to

a true value, the tests will attempt to control the services, you probably don't

want to do this on a production system.

Assuming you have a working Rakudo installation then you should be able to install with `zef` :

   zef install Monitor::Monit

## Support

I've only tested this against my particular configuration of monit so it is

entirely possible that I have missed something that is important to you,

please feel to make suggestions at https://github.com/jonathanstowe/Monitor-Monit/issues

It is possible that it may not work properly with certain older versions of

monit though I can't pinpoint which versions and it's difficult to test so

any help with that would be appreciated.

## Copyright and Licence

This is free software.

Please see the [LICENCE](LICENCE) file in this directory.

© Jonathan Stowe 2016 - 2021