ansible-role-amazon-cloudwatch

This role helps you install Amazon CloudWatch on your target host.

Requirements

This role was made for Ansible version 2.5 and may not work with older versions. To install the role, use the command: ansible-galaxy install diodonfrost.amazon_cloudwatch.

Supported platforms:

- name: EL
  versions:
    - 8
    - 7
    - 6
- name: Debian
  versions:
    - buster
    - stretch
    - jessie
- name: Ubuntu
  versions:
    - disco dingo
    - bionic
    - xenial
    - trusty
- name: Amazon
  versions:
    - 2017.12
    - 2016.03
- name: opensuse
  versions:
    - 15.1
    - 15

Role Variables

This role does not use any variables.

---
# defaults file for ansible-role-amazon-cloudwatch

cloudwatch_config: '{
    "agent": {
        "metrics_collection_interval": 60,
        "run_as_user": "root"
    },
    "metrics": {
        "metrics_collected": {
            "collectd": {
                "metrics_aggregation_interval": 60
            },
            "cpu": {
                "measurement": [
                    "cpu_usage_idle"
                ],
                "metrics_collection_interval": 60,
                "resources": [
                    "*"
                ],
                "totalcpu": true
            },
            "disk": {
                "measurement": [
                    "used_percent"
                ],
                "metrics_collection_interval": 60,
                "resources": [
                    "*"
                ]
            },
            "diskio": {
                "measurement": [
                    "write_bytes",
                    "read_bytes",
                    "writes",
                    "reads"
                ],
                "metrics_collection_interval": 60,
                "resources": [
                    "*"
                ]
            },
            "mem": {
                "measurement": [
                    "mem_used_percent"
                ],
                "metrics_collection_interval": 60
            },
            "net": {
                "measurement": [
                    "bytes_sent",
                    "bytes_recv",
                    "packets_sent",
                    "packets_recv"
                ],
                "metrics_collection_interval": 60,
                "resources": [
                    "*"
                ]
            },
            "statsd": {
                "metrics_aggregation_interval": 60,
                "metrics_collection_interval": 10,
                "service_address": ":8125"
            },
            "swap": {
                "measurement": [
                    "swap_used_percent"
                ],
                "metrics_collection_interval": 60
            }
        }
    }
}'

# Use during integration test
ansible_test_mode: false

Dependencies

None

Example Playbook

This is an example of a playbook to deploy the Ansible Galaxy role on your localhost and install the latest version of Amazon CloudWatch.

---
- hosts: localhost
  become: true
  roles:
    - role: diodonfrost.amazon_cloudwatch

Local Testing

This project uses Molecule for development and testing.

To develop or test, you need to have installed the following:

• Linux (e.g. Ubuntu)
• Docker
• Python (including python-pip)
• Ansible
• Molecule

Testing with Docker

# Test the role on CentOS 8
molecule test

# Test the role on Ubuntu 20.04
image=ansible-ubuntu:20.04 molecule test

# Test the role on Opensuse Leap
image=ansible-opensuse:leap molecule test

License

Apache 2

Author Information

This role was created by diodonfrost in 2019.