{"id":13655041,"url":"https://github.com/pgolm/ansible-role-monit","last_synced_at":"2025-10-24T02:30:48.466Z","repository":{"id":10533100,"uuid":"12726669","full_name":"pgolm/ansible-role-monit","owner":"pgolm","description":"Ansible role to configure monit.","archived":false,"fork":false,"pushed_at":"2024-08-08T07:30:20.000Z","size":72,"stargazers_count":62,"open_issues_count":14,"forks_count":70,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-22T22:31:32.317Z","etag":null,"topics":["ansible","ansible-role","monit"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/pgolm/monit/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pgolm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-09-10T10:22:16.000Z","updated_at":"2024-08-22T22:31:37.927Z","dependencies_parsed_at":"2024-08-22T22:31:37.481Z","dependency_job_id":"874b29ac-d439-4af9-b104-ae30bbdcc8fd","html_url":"https://github.com/pgolm/ansible-role-monit","commit_stats":null,"previous_names":["pgolm/ansible-playbook-monit"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pgolm%2Fansible-role-monit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pgolm%2Fansible-role-monit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pgolm%2Fansible-role-monit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pgolm%2Fansible-role-monit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pgolm","download_url":"https://codeload.github.com/pgolm/ansible-role-monit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237901418,"owners_count":19384390,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-role","monit"],"created_at":"2024-08-02T03:00:55.191Z","updated_at":"2025-10-24T02:30:43.196Z","avatar_url":"https://github.com/pgolm.png","language":null,"funding_links":[],"categories":["Security"],"sub_categories":["Logging and Monitoring"],"readme":"Monit\n========\n\nAnsible role for configuring Monit. Sample usage see [example.yml](http://github.com/pgolm/ansible-playbook-monit/blob/master/example.yml).\n\nInstall\n-------\nInstall this role with [ansible-galaxy](https://galaxy.ansible.com/pgolm/monit/).\n\n```shell\n$ ansible-galaxy install pgolm.monit\n```\n\nRequirements\n------------\n\nAn Ansible ready host.\n\nRole Variables\n--------------\n\n* `monit_cycle`: Time between checks in seconds. Defaults to `120`.\n* `monit_log_destination`: Where the log will be written. Can be a path to a file or \"syslog\", which will write to syslog daemon. Defaults to `/var/log/monit.log`.\n* `monit_state_file`: State file path. Defaults to `/var/lib/monit/state`.\n* `monit_id_file`: Id file path. Defaults to `/var/lib/monit/id`.\n* `monit_eventqueue_dir`: Event queue directory path. It is only used when this variable is defined. Defaults to `/var/lib/monit/events`.\n* `monit_eventqueue_slots`: Event queue slots. It is only used when `monit_eventqueue_dir` is defined. Defaults to `100`.\n* `monit_services`: List of hashes of services to be monitorized by monit.\n  * `name`: Name of the process or host.\n  * `type`: Type of monitorization, \"process\", \"process_by_name\", \"host\", \"filesystem\" and \"system\" are supported.\n  * `target`: Target of monitorization. Should be a pidfile, processname, an address or undefined, depending on the `type` of service.\n  * `start`: Command that starts the service. Optional.\n  * `stop`: Command that stop the service. Optional.\n  * `user`: Linux username of the user starting the program. Optional.\n  * `group`: Linux group of the user starting the program. Optional.\n  * `rules`: List of rules to be included in this service. Optional.\n* `monit_service_delete_unlisted`: Remove existing service monitorization configurations not declared in the `services`. Defaults to `true`.\n* `monit_mail_enabled`: Enable mail alerts. Defaults to `false`.\n* `monit_mailserver_host`: Mailserver host address. Defaults to `localhost`.\n* `monit_mailserver_port`: Mailserver host port. Defaults to `25`.\n* `monit_mailserver_user`: Username for authentication on mailserver. Optional\n* `monit_mailserver_password`: Password for authentication on mailserver. Optional\n* `monit_mailserver_timeout`: Timeout for mailserver connection. Defaults to `5`.\n* `monit_mailserver_ssl_version`: If defined, monit will use this algorithm for SSL connection to the mail server. Possible values are `SSLAUTO`, `SSLV2`, `SSLV3`, `TLSV1`, `TLSV11`, `TLSV12`.\n* `monit_alert_addresses`: List of mail addresses where the alerts will be sent to.\n* `monit_alert_mail_format`: A hash of options for mail-format.\n  * `from`: Sender mail address.\n  * `reply-to`: A reply-to mail address.\n  * `subject`: Mail subject.\n  * `message`: Mail message body.\n* `monit_webinterface_enabled`: Enable monit web interface. Defaults to `true`.\n* `monit_webinterface_bind`: IP address to bind web interface. Defaults to `0.0.0.0` (listen for external requests).\n* `monit_webinterface_port`: Port for web interface. Defaults to `2812`.\n* `monit_webinterface_rw_group`: Define group of users allowed to read and write on web interface. It is only applied when defined and is empty by default.\n* `monit_webinterface_r_group`: Define group of users allowed to read on web interface. It is only applied when defined and is empty by default.\n* `monit_webinterface_acl_rules`: List of ACL rules for the web interface, such as \"localhost\" or \"hauk:password\". It is only applied when defined and is empty by default. You should probably define at least one for the httpd service to start.\n\nCustom facts\n------------\n\nThis role writes a `monit_services_configured` on `/etc/ansible/facts.d/monit.fact` in order to keep track of the configured monitors between different plays. This helps us removing unused monitors.\n\nLICENSE\n-------\nMIT\n\nCONTRIBUTE\n----------\n\nFeel free to contribute by add issue and pull request.\n\nCONTRIBUTORS\n------------\n* [Amnay](https://github.com/amnay-mo)\n* [Anthony Dmitriyev](https://github.com/antstorm)\n* [byteshiva](http://byteshiva.github.io/)\n* [Eduardo de Vera Toquero](https://github.com/etux)\n* [Jordi Clariana](https://github.com/jordiclariana)\n* [Manuel Tiago Pereira](http://mtpereira.github.io/)\n* [Markus Klepp](https://github.com/kh0r)\n* [Panagiotis Moustafellos](https://github.com/pmoust)\n* [Peter Golm](https://github.com/pgolm)\n* [Romain Gonord](https://github.com/astik)\n* [Roozbeh Farahbod](https://github.com/roozbehf)\n* [Svend Vanderveken](https://github.com/svendx4f)\n* [Tom Naessens](https://github.com/Silox)\n* [vkill](https://github.com/vkill)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpgolm%2Fansible-role-monit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpgolm%2Fansible-role-monit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpgolm%2Fansible-role-monit/lists"}