Rol de Ansible: Agente CloudWatch

Instala y configura el Agente Unificado de CloudWatch de AWS.

Requisitos

Ninguno

Variables del rol

Las variables disponibles se enumeran a continuación, junto con los valores predeterminados (ver defaults/main.yml):

# Familia Debian
cwa_download_url: https://s3.amazonaws.com/amazoncloudwatch-agent/ubuntu/amd64/latest
# Familia RedHat
cwa_download_url: https://s3.amazonaws.com/amazoncloudwatch-agent/redhat/amd64/latest

La URL desde la cual descargar el paquete del Agente CloudWatch.

# Familia Debian
cwa_pkg_file: amazon-cloudwatch-agent.deb
# Familia RedHat
cwa_pkg_file: amazon-cloudwatch-agent.rpm

El nombre del paquete del Agente CloudWatch.

# Familia Debian
cwa_sig_file: amazon-cloudwatch-agent.deb.sig
# Familia RedHat
cwa_sig_file: amazon-cloudwatch-agent.rpm.sig

El nombre del archivo de firma GPG del Agente CloudWatch.

cwa_gpg_url: https://s3.amazonaws.com/amazoncloudwatch-agent/assets

La URL desde la cual descargar la clave pública GPG del Agente CloudWatch.

cwa_gpg_fingerprint: "937616F3450B7D806CBD9725D58167303B789C72"

La huella digital de la clave pública GPG del Agente CloudWatch. Ver documentación de verificación de firma GPG del Agente CloudWatch para más detalles.

cwa_mode: ec2

El modo en que se ejecutará el agente. Puede ser ec2, onPremise o auto.

cwa_logfile: /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log

El archivo en el que se registrarán los eventos. Asegúrate de especificarlo en cwa_config_map.agent.logfile si lo cambias desde el valor predeterminado.

cwa_config_dir: /opt/aws/amazon-cloudwatch-agent/etc

El directorio donde se colocará el archivo de configuración del agente.

cwa_config_map:
  metrics:
    metrics_collected:
      mem:
        measurement:
          - name: mem_used_percent

La configuración del Agente CloudWatch. Este mapa YAML se convertirá a JSON y se imprimirá en el archivo amazon-cloudwatch-agent.json en cwa_config_dir. Ver documentación de configuración del agente CloudWatch para detalles de todas las opciones de configuración.

Dependencias

Ninguna

Ejemplo de Playbook

- hosts: servidores

  vars:
    cwa_config_map:
      metrics:
        metrics_collected:
          disk:
            measurement:
              - name: disk_used_percent
            resources:
              - /
      logs:
        logs_collected:
          files:
            collect_list:
              - file_path: /var/log/auth.log
                log_group_name: auth
                timestamp_format: "%b %d %H:%M:%S"
        log_stream_name: "{instance_id}"

  roles:
     - { role: newtonne.cloudwatchagent }

Licencia

MIT