/ansible-ec2-monitor

Ansible Role to install CloudWatchMonitoringScripts and Monitor Memory and Disk Metrics for Amazon EC2 Linux Instances

Apache License 2.0Apache-2.0

EC2 Monitor

Ansible Role to install CloudWatchMonitoringScripts and Monitor Memory and Disk Metrics for Amazon EC2 Linux Instances

Role Variables

The current version of Cloud Watch Monitoring Scripts is defined:

package_version: '1.2.2'

Following variables need to be defined:

  • cloud_watch_monitoring_path - Path where scripts will be downloaded and unarchieved
  • cron_specs - {name: "Name of the task", minute: "/5", hour: "", job: "{{cloud_watch_monitoring_path}}/aws-scripts-mon/mon-put-instance-data.pl --disk-space-util --disk-path=/mnt/data --from-cron --aws-access-key-id=AWS_KEY --aws-secret-key=AWS_SECRET_KEY"}

Note: There are no default values for the above mentioned variables.

Dependencies

This package has no dependencies on modules not included with Ansible by default.

Install

$ ansible-galaxy install amritsingh.ec2_monitor

Usage

Example Usage in site.yml

$ cat site.yml
---
- hosts: all
  remote_user: ubuntu
  become: yes
  become_method: sudo
  roles:
      - role: "sunliwen.ec2-monitor"

        cloud_watch_monitoring_path: "/opt"
        cron_specs:
            - name: "Send Memory And Disk Usage Statistics"
              minute: "*/10"
              hour: "*"
              job: >
                  {{cloud_watch_monitoring_path}}/aws-scripts-mon/mon-put-instance-data.pl
                  --disk-space-util
                  --disk-path=/
                  --disk-path=/data
                  --disk-space-used
                  --disk-space-avail
                  --mem-util
                  --mem-used
                  --mem-avail
                  --from-cron

Two extra parameters, in case log from server outside AWS

--aws-access-key-id=your_aws_access_key_id
--aws-secret-key=your_aws_secret_key

Testing

This fork is only tested with ansible-playbook 2.9.5 on Ubuntu 18.04.

License

Apache

Author Information

Forked by Liwen Sun https://twitter.com/slw4qd

Created by Amrit Singh https://twitter.com/_amrit_