ansible-role-amazon-cloudwatch

This role provide a compliance for install amazon-cloudwatch on your target host.

Requirements

This role was developed using Ansible 2.5 Backwards compatibility is not guaranteed. Use ansible-galaxy install diodonfrost.amazon_cloudwatch to install the role on your system.

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 have a variable

---
# 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 a sample playbook file for deploying the Ansible Galaxy role in a localhost and installing latest amazon-cloudwatch version.

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

Local Testing

This project uses Molecule to aid in the development and testing.

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

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

Testing with Docker

# Test role on CentOS 8
molecule test

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

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

License

Apache 2

Author Information

This role was created in 2019 by diodonfrost.