Role Name

Installs AWS CloudWatch Log Agent

Requirements

Requires ec2_facts.

Role Variables

logs, extra_logs: list of logs with the following keys:

awslogs_loglevel: maximal log level for the Log Agent's logs itself ("debug", "info", "warning", "error" or "critical"). If this parameter is not specified, no specific logging configuration will take place and the default level (info) will be used. This parameter is very basic and does not allow flexible logging configuration, its only goal is to change the amount of logs going into the log agent's own logfile.

Dependencies

This role has no dependencies.

Example Playbook

- hosts: servers
  vars:
    logs:
      - file: /var/log/auth.log
        format: "%b %d %H:%M:%S"
        group_name: "auth"
        stream_name: "auth-stream"
      - file: /home/ubuntu/.bash_history
        group_name: "bash_history"
    awslogs_loglevel: info
  roles:
     - { role: dharrisio.aws-cloudwatch-logs }

License

GPLv3

Author Information

Created by David Harris