Monitor::Monit

Provide an interface to the monit monitoring daemon

Monitor::Monit

Provide an interface to the monit monitoring daemon

image https://github.com/jonathanstowe/Monitor-Monit/workflows/CI/badge.svg not found

Synopsis


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 file in this directory.

Ā© Jonathan Stowe 2016 - 2021

Monitor::Monit v0.0.5

Provide an interface to the monit monitoring daemon

Authors

  • Jonathan Stowe

License

Artistic-2.0

Dependencies

HTTP::UserAgentURI::TemplateXML::Class

Test Dependencies

Provides

  • Monitor::Monit

Documentation

The Camelia image is copyright 2009 by Larry Wall. "Raku" is trademark of the Yet Another Society. All rights reserved.